📅
{year}年度官方标准版
📝
逐步骤图文详解
🚀
零技术门槛
秦安县秦剧团文化演出有限公司云端预约系统
零基础 · EdgeOne Pages 专属部署教程
🎯 教 程 导 读 说 明
- 适用平台 腾讯云 EdgeOne Pages（免费托管）
- 技术要求 零基础 · 无需写代码 · 无需搭环境
- 部署耗时 约 5 - 10 分钟即可完成上线
- 章节总数 9 大步骤 · 逐页详解 · 验收必过
- 专属适配 💯 本系统 EdgeOne 专属零配置适配
📘
开始阅读部署教程 · 共 9 大章节
⬇️
第 一 章
部署前置准备
3 项必备条件 · 一次性确认到位
一
部署前置准备（共 3 条）
-
腾讯云账号 + EdgeOne Pages 服务开通注册并登录腾讯云账号，进入 EdgeOne 控制台开通 Pages 服务（免费托管额度充足，零成本启动）。【图文占位】腾讯云 EdgeOne Pages 控制台开通示意图
-
本部署包无需改代码 / 改配置 / 装环境本系统已完成 EdgeOne Pages 专属深度适配，所有配置零修改开箱即用，无需安装任何软件、无需改任何代码、无需改配置文件。【图文占位】部署包文件结构一览图（核心文件在根目录）
-
本地准备：新建文件夹 + 复制全部文件在本地电脑新建名为 qintang-troupe-system 的文件夹，将本交付包内全部文件完整复制粘贴进去，确保所有资源齐全无遗漏。【图文占位】本地新建文件夹 + 复制粘贴文件操作示意图
第 二 章
标准化打包步骤
4 步规范打包 · 避免部署失败
二
标准化打包步骤（共 4 步）
-
打开文件夹，校验资源完整性双击打开 qintang-troupe-system 文件夹，确认核心文件（index.html、css/style.css、js/app.js、admin目录、图片等）均存在且无缺失，确保交付包完整无损坏。【图文占位】文件夹资源完整性校验截图（标注核心文件位置）
-
全选 → 右键 → 压缩为 ZIP（禁止 RAR）按 Ctrl+A 全选文件夹内所有内容，右键选择「发送到 → 压缩(zipped)文件夹」，务必使用 ZIP 格式，严禁使用 RAR、7Z 等其他格式，EdgeOne Pages 仅支持 ZIP。【图文占位】全选 + 右键压缩为 ZIP 操作流程图
-
命名：秦剧团云端预约系统_最终部署包.zip将生成的 ZIP 压缩包重命名为统一标准名称：秦剧团云端预约系统_最终部署包.zip，便于后续识别与归档管理。【图文占位】压缩包标准命名示例图
-
压缩包校验：大小正常 + 无嵌套文件夹双击打开 ZIP 进行校验：① 确认文件大小正常（通常 2-20MB）；② 核心！打开 ZIP 后直接看到 index.html 等核心文件，禁止出现多一层嵌套文件夹（例：ZIP → qintang-troupe-system → index.html 为错误结构，正确应为 ZIP → index.html）。【图文占位】正确（无嵌套） vs 错误（多层嵌套）对比图
核心警告！压缩格式与嵌套结构
① 禁止使用 RAR 格式：EdgeOne Pages 仅识别 ZIP，RAR 上传会直接报错导致部署失败；
② 禁止多层嵌套文件夹：若 ZIP 内多套了一层文件夹，部署后会全站 404 找不到文件，务必确保核心文件在 ZIP 根目录！
② 禁止多层嵌套文件夹：若 ZIP 内多套了一层文件夹，部署后会全站 404 找不到文件，务必确保核心文件在 ZIP 根目录！
第 三 章
平台上传部署步骤
5 步零配置 · 自动上线
三
平台上传部署步骤（共 5 步）
-
腾讯云 → EdgeOne Pages 控制台登录腾讯云官网，搜索「EdgeOne」进入产品控制台，在左侧菜单找到「Pages 静态网站托管」模块，点击进入项目管理主界面。【图文占位】EdgeOne Pages 控制台入口定位截图
-
创建项目 → 选择「从本地 ZIP 包部署」点击「新建项目」按钮，在部署方式选项中选择 「从本地 ZIP 包部署」（不要选 Git 仓库、不要选框架预设），填写项目名称（如：qintang-troupe），项目描述可留空。【图文占位】新建项目 + 选择 ZIP 部署方式界面
-
上传 ZIP → 等待平台解析点击「选择文件」上传打包好的 秦剧团云端预约系统_最终部署包.zip，等待 10-30 秒平台自动解析文件结构，确认解析后显示的根目录文件清单中 index.html 存在且在第一层。【图文占位】ZIP 上传进度条 + 解析成功文件清单
-
所有配置保持默认（无需修改，零配置）编译命令、输出目录、环境变量、框架选择、自定义域名等所有选项全部默认留空，本系统已做 EdgeOne 专属零配置适配，改任何一项都可能导致部署异常，切记不要做任何修改！【图文占位】配置项默认值展示图（红框标注「全部保持默认」）
-
点击【确认部署】→ 自动编译 + CDN 分发 + 公网上线点击「确认部署」按钮，平台将自动完成：文件解压 → 资源校验 → 编译托管 → CDN 全网分发 → 生成公网访问域名，整个过程约 1-3 分钟，请耐心等待进度条完成。【图文占位】部署进度 + 部署成功 + 公网域名展示图
第 四 章
部署完成校验标准
验收必过 · 5 条硬核标准
四
部署完成校验标准（验收必过，共 5 条）
| 序号 | 校验项 | 校验标准 | 验收结果 |
|---|---|---|---|
| 1 | 部署状态 | 控制台显示「部署成功」，部署日志无报错（红色）、无警告（黄色），进度条 100% 满格完成。 | ✓ |
| 2 | 公网访问 | 使用 EdgeOne 提供的默认公网域名访问，全站页面加载正常、无白屏、无 404；PC/平板/手机三端均自适应无错乱。 | ✓ |
| 3 | 年份渲染 | 全站页面底部版权、页脚标题、文案中所有 {year} 占位符均渲染为当前实际年份（如：{year}），无残留字符串；跨年自动更新、无需手工改码。 |
✓ |
| 4 | 功能完整 | 预约表单可填写提交、阶梯优惠联动计算准确、导航跳转流畅无死链、剧目卡片加载正常、后台登录页可正常打开。 | ✓ |
| 5 | CDN 加速 | 全球节点极速加载、首屏打开 ≤ 2 秒、刷新无卡顿无白屏、静态资源（CSS/JS/图片）均命中 CDN 缓存（浏览器开发者工具 Network 面板可验证）。 | ✓ |
📌 验收结论
以上 5 项校验全部通过（即 5 个绿框均打勾），即可判定本次 EdgeOne Pages 部署基础验收合格。
为确保生产稳定性，建议继续执行以下 4.2 + 4.3 的 V2 全量回归验证（总计 5 分钟，含 FIN-INT3 边界Bug修复验证）后再正式交付。
4.2
生产环境从0跑bug · 4维度精简冒烟检查（V2回归标准版）
本清单与开发阶段
debug-full-regression-v2.md 报告一一对应，确保线上生产环境 ≡ 本地V2回归结果。
🅰 维度一：页面渲染连通性（抽样检查 5 页 + 4 文档页）
| # | 页面URL | 检查标准 | 结果 |
|---|---|---|---|
| 1 | /index.html | Banner图完整加载、导航菜单12项全显、页脚无 {year} 残留 | ✓ |
| 2 | /booking.html | 9项预约输入框可点击、【提交预约】按钮清晰可见、无白屏灰屏 | ✓ |
| 3 | /operas.html | 8大剧目卡片完整展示、图片无裂图（显示经典秦腔/眉户海报） | ✓ |
| 4 | /admin/login.html | 账号密码输入框+登录按钮正常渲染、无资源 404 | ✓ |
| 5 | /admin/finance.html | 财务台账11条数据完整、右上角4功能按钮（新增收入/支出/对账/导出） | ✓ |
| 6 | /deploy.html / architecture.html / delivery.html / 404.html | 4个文档页均 200 OK，404页展示自定义错误页面（非浏览器默认404） | ✓ |
🅱 维度二：浏览器 Console 零错误（打开F12面板）
| 操作页面 | 检查标准 | 结果 |
|---|---|---|
/index.html | Error = 0；Warning = 0；Console 仅 3 条 info（YearReplace / FrontCommonPatch / CSP-patch）为正常提示 | ✓ |
/booking.html | 无 Uncaught TypeError / undefined / SyntaxError / 404 资源加载失败 | ✓ |
/admin/finance.html | 无 pagination 空引用错误（Cannot read properties of null reading 'length'）、无 147 行语法错误 | ✓ |
🅲 维度三：核心业务链路（预约 → 订单号 → 后台查询）
| # | 操作步骤 | 期望结果 | 结果 |
|---|---|---|---|
| 1 | 打开 booking.html 填写唯一测试数据：客户=「生产验收·李主任」、手机 13900002222、日期 2026-12-01、类型=乡村庙会、场次=3 | 所有输入框可交互 | ✓ |
| 2 | 勾选同意协议后点击【提交预约】 | 弹出成功提示，含订单号 26-QA-XXXXX | ✓ |
| 3 | 登录（或直接打开） admin/orders.html，搜索栏搜「李主任」或「生产验收」 | 可在列表中找到第 2 步提交的预约记录 | ✓ |
| 4 | 打开 admin/reports.html → 月度服务分布 / 收入趋势图 | 图表正常渲染，无 Highcharts 未定义或图表空白 | ✓ |
🚩 4.3 FIN-INT3 边界修复 · 线上专属必过验证（MUST PASS）
本验证对应开发阶段
FIN-INT3 BOUNDARY BUG 修复：旧版输入超 99,999,999.99（9999.99万）时会被 _parseMoney 先静默截断再"蒙混过关"通过验证；V2版新增前置拦截，必须显示 「原始输入」 字样才代表修复代码已真正在生产生效。
| # | 操作步骤 | 期望结果（含拦截特征） | 结果 |
|---|---|---|---|
| 1 | 打开 admin/finance.html → 点击右上角【➕ 新增收入】 |
弹出新建收款单模态框（客户、方式、日期、经手人、金额 5 字段） | ✓ |
| 2 | 填基础项：客户=「秦安县文旅局」；方式=银行转账；日期=当日；经手人=「李会计」 | 4 字段全部选中 / 填入成功 | ✓ |
| 3* | 【收款金额】字段填写 999999999.99（9.99 亿，超过 9999.99 万上限 10 倍） → 点击【保存】 |
✅ 弹出红色 Toast 报错，必须包含字符串"原始输入：999999999.99"❌ 不允许"保存成功"、不允许截断为 99999999.99 后静默通过 |
! |
| 4* | 【收款金额】填入科学计数法注入 1e10 → 点击【保存】 |
✅ 弹出提示"金额格式不合法（禁止科学计数法 / 特殊字符）"，拒绝通过 | ! |
| 5 | 【收款金额】恢复为合法值 20000（2 万元整）→ 点击【保存】 |
✅ 通过验证，弹出绿色"保存成功"或刷新列表显示该条记录 | ✓ |
⚠️ 验证失败处理： 若第 3* / 4* 步出现任何一项未通过（如：保存成功 / toast 缺失"原始输入"字样 / 科学计数法被解析为数值通过），说明 FIN-INT3-BOUNDARY 修复代码未包含在本部署包。请立即回滚，使用
_output/qaxqjt_FIN-INT3边界Bug已修复_回归V2全5假设通过_XXXXXXXX_XXXXXX.zip 重新部署，绝对禁止上线旧版本！
🎯 正式交付终审通过标准（所有绿框打勾 + FIN-INT3 2 项红框标记）
┌───────────────────────────────────────────────────────────────┐
│ 基础校验（原4.1）: 5 / 5 ✅ PASS 部署状态·公网·年份·功能·CDN │
│ 维度A 渲染连通: 6 / 6 ✅ PASS 5 核心页面 + 4 文档页抽样 │
│ 维度B Console: 3 / 3 ✅ PASS 0 Error · 0 Warning │
│ 维度C 业务链路: 4 / 4 ✅ PASS 预约 → 订单号 → orders查询 → 报表图 │
│ 维度D FIN-INT3: 5 / 5 ✅ PASS 9.99亿前置拦截含"原始输入"字样 │
├───────────────────────────────────────────────────────────────┤
│ 🟢 [READY FOR DELIVERY] → 打印本页 + 甲方法人签字 + 加盖公章 = 交付完成 │
└───────────────────────────────────────────────────────────────┘
│ 基础校验（原4.1）: 5 / 5 ✅ PASS 部署状态·公网·年份·功能·CDN │
│ 维度A 渲染连通: 6 / 6 ✅ PASS 5 核心页面 + 4 文档页抽样 │
│ 维度B Console: 3 / 3 ✅ PASS 0 Error · 0 Warning │
│ 维度C 业务链路: 4 / 4 ✅ PASS 预约 → 订单号 → orders查询 → 报表图 │
│ 维度D FIN-INT3: 5 / 5 ✅ PASS 9.99亿前置拦截含"原始输入"字样 │
├───────────────────────────────────────────────────────────────┤
│ 🟢 [READY FOR DELIVERY] → 打印本页 + 甲方法人签字 + 加盖公章 = 交付完成 │
└───────────────────────────────────────────────────────────────┘
提示：本页顶部有【🖨️ 打印 / 导出PDF】按钮，可一键导出终审验收书，供甲乙方签字盖章存档。
第 五 章
后续迭代更新规范
3 条规范 · 一键迭代无负担
五
后续迭代更新规范（共 3 条）
-
改版 → 改本地 → 重新打包 → 上传覆盖即可后续如需更新页面文案、图片、剧目信息等，仅需在本地电脑修改对应的 HTML / CSS / 图片文件，完成后重新按「第二章 · 标准化打包步骤」生成 ZIP，回到 EdgeOne Pages 项目详情页点击「重新部署」上传新 ZIP 即可覆盖上线，全程无需改动底层配置。【图文占位】EdgeOne Pages 项目详情页「重新部署」按钮位置图
-
无需重构 / 改配置 / 搭环境 → 一键迭代迭代更新不需要重新创建项目、不需要修改任何平台配置、不需要安装 Node.js/构建工具、不需要写命令行脚本，只需「本地改文件 → 重新打包ZIP → 上传覆盖」三步闭环，真正零基础一键迭代。【图文占位】迭代更新 3 步闭环流程图（改本地 → 打包 → 上传）
-
平台保留历史版本 → 支持版本回滚 / 溯源EdgeOne Pages 自动保留每次部署的历史版本（含时间戳、部署人、部署状态），若新版本出现异常，只需在历史版本列表中点击「回滚到该版本」，10 秒内即可恢复任意历史上线版本，全程可追溯、可回退、零风险。【图文占位】EdgeOne Pages 历史版本列表 + 一键回滚操作界面
第 六 章
部署注意事项
4 条红色警示 · 规避部署失败
六
部署注意事项（4 条红色警示框）
禁止修改原生 JS / 删除年份脚本
严禁手动修改 js/year-lite.js、js/app.js 核心脚本，严禁删除年份动态渲染相关代码；任何改动都会导致预约表单失效、{year} 渲染残留、阶梯优惠计算异常，直接影响系统核心功能。
严禁手动修改 js/year-lite.js、js/app.js 核心脚本，严禁删除年份动态渲染相关代码；任何改动都会导致预约表单失效、{year} 渲染残留、阶梯优惠计算异常，直接影响系统核心功能。
禁止 RAR 格式 / 多层嵌套
严禁使用 RAR、7Z 等非 ZIP 压缩格式（EdgeOne 不识别直接报错）；严禁 ZIP 内嵌套多层文件夹（部署后全站 404）。压缩格式 + 根目录结构两条为最高优先级红线，违者直接部署失败。
严禁使用 RAR、7Z 等非 ZIP 压缩格式（EdgeOne 不识别直接报错）；严禁 ZIP 内嵌套多层文件夹（部署后全站 404）。压缩格式 + 根目录结构两条为最高优先级红线，违者直接部署失败。
禁止随意更改平台默认配置
EdgeOne Pages 的编译命令、输出目录、框架预设、环境变量、路由规则、缓存策略等全部保持默认值，任何一项随意改动均可能导致 CDN 失效、页面打不开、资源加载失败，务必零配置部署。
EdgeOne Pages 的编译命令、输出目录、框架预设、环境变量、路由规则、缓存策略等全部保持默认值，任何一项随意改动均可能导致 CDN 失效、页面打不开、资源加载失败，务必零配置部署。
系统全自动跨年迭代 · 永久免维护免改码
本系统内置 year-lite.js 全自动年份动态脚本，每年 1 月 1 日零点自动全站更新为新年份，无需人工改任何代码、无需重新部署、无需登录后台，一次部署永久跨年免维护，彻底告别年底改年份烦恼。
本系统内置 year-lite.js 全自动年份动态脚本，每年 1 月 1 日零点自动全站更新为新年份，无需人工改任何代码、无需重新部署、无需登录后台，一次部署永久跨年免维护，彻底告别年底改年份烦恼。
💡 小贴士：部署异常快速排查清单
① 部署失败 404 → 检查 ZIP 是否嵌套文件夹
② 白屏样式错乱 → 检查是否误改了平台配置
③ 年份没渲染 → 检查 js/year-lite.js 是否存在 / 是否被删除
④ 加载慢卡顿 → 检查 CDN 缓存是否启用（默认启用即可）
第 七 章
项目部署预览规范
上线前校验标准 · 重要必查
七
项目部署预览规范（上线前校验标准 · 重要！）
7.1 预览触发方式
ZIP 包上传至 EdgeOne Pages 后，平台在正式部署前会自动生成临时预览域名；在部署详情页点击【预览访问】按钮，即可打开离线预览环境进行上线前的完整校验。预览环境与最终正式公网环境代码、资源、配置100% 完全一致，预览合格即等同于正式上线合格，可放心发布。
【图文占位】EdgeOne Pages 部署详情页「预览访问」按钮位置 + 临时预览域名示意图
7.2 预览必查 5 核心项（逐项打勾确认）
-
页面完整性（7 前台 + 无 404）
首页 / 剧团简介 / 剧目中心 / 演出业务 / 新闻动态 / 在线预约 / 联系我们共 7 个前台页面 + 后台管理入口全部可正常打开，无 404 死链。 -
动态渲染（{year} 无残留 + 脚本零报错）
全站页面检查：页脚版权、标题中的 {year} 全部渲染为实际年份（{year}）；浏览器控制台 Console 面板零红色 JS 报错。 -
多终端适配（PC / 手机视图切换）
浏览器切换「响应式模式」或使用手机扫码访问，PC、平板、手机三种视口下页面均自适应，无横向滚动、无排版错乱。 -
功能可用性（预约表单 / 优惠展示 / 跳转）
预约表单可填写提交、场次输入阶梯优惠联动准确、导航跳转流畅、剧目卡片加载完整、后台登录页正常打开。 -
资源加载（CDN 预加载 + 无卡顿无白屏）
首屏加载 ≤ 2 秒、刷新无白屏、图片无裂图、CSS/JS 资源全部 200 状态码命中 CDN、页面滚动流畅无卡顿掉帧。
7.3 预览环境 vs 正式环境对比
| 🔍 预览环境（上线前） | 🌐 正式环境（公网上线） |
|---|---|
|
临时预览域名 EdgeOne 自动生成的随机临时访问链接，仅用于上线前测试，有效期至部署结束。 |
公网正式域名 平台分配的永久默认域名（如 xxx.pages.dev）或绑定的自定义企业域名。 |
|
功能 100% 完整 所有前台页面 / 后台入口 / 预约 / 脚本 / 样式全部与正式环境完全一致，无任何阉割。 |
功能 100% 完整 与预览环境代码一致，加上 CDN 全网节点加速，全球访问更快更稳。 |
|
不对外公开 仅拥有预览链接的人员可访问，用于内部测试验收，不会被搜索引擎收录。 |
公网全球可访问 部署完成后全球可访问，自动接入搜索引擎收录，可绑定自定义域名。 |
|
可回退可修改 预览验收不合格，可终止发布、修改本地文件、重新打包、重新预览，不影响任何线上环境。 |
支持历史版本回滚 若正式发布后发现异常，可使用平台历史版本功能一键回滚至上一个稳定版本。 |
第 八 章 · 终 章
终审通过标准 & 异常处理
正式发布把关 · 官方认证通过
八
终审通过标准 & 异常处理规范
8.1 预览终审通过标准（绿底大框）
- ✓全站页面完整
- ✓视觉样式统一
- ✓交互功能正常
- ✓脚本零报错
- ✓年份渲染精准
- ✓多终端适配无误
- ✓性能流畅零卡顿
- ✓零 BUG 零瑕疵
→ 全部达标即可准许正式公网上线！
8.2 异常处理规范
出现异常立即执行以下流程：
① 终止发布 → 预览环境发现任意瑕疵，立即取消部署，绝不可带病上线；
② 核对资源 → 回到本地对照「第四章 · 部署校验 5 条标准」逐项排查，确认是打包问题、文件缺失、还是脚本异常；
③ 修复问题 → 针对问题根因修复（例如：嵌套文件夹 → 重新打包；脚本缺失 → 恢复 js 文件；配置误改 → 恢复默认配置）；
④ 重新打包 → 修复完成后严格按照「第二章 · 标准化打包 4 步」重新生成合规 ZIP；
⑤ 重新预览 → 上传新 ZIP、生成新预览环境、重复 7.2 节 5 项必查核心清单；
⑥ 合格上线 → 预览终审全部通过，点击【确认发布】正式公网上线。
① 终止发布 → 预览环境发现任意瑕疵，立即取消部署，绝不可带病上线；
② 核对资源 → 回到本地对照「第四章 · 部署校验 5 条标准」逐项排查，确认是打包问题、文件缺失、还是脚本异常；
③ 修复问题 → 针对问题根因修复（例如：嵌套文件夹 → 重新打包；脚本缺失 → 恢复 js 文件；配置误改 → 恢复默认配置）；
④ 重新打包 → 修复完成后严格按照「第二章 · 标准化打包 4 步」重新生成合规 ZIP；
⑤ 重新预览 → 上传新 ZIP、生成新预览环境、重复 7.2 节 5 项必查核心清单；
⑥ 合格上线 → 预览终审全部通过，点击【确认发布】正式公网上线。
8.3 官方认证印章
【部署教程专属适配 ✅ · 秦安县秦剧团云端预约系统官方认证】
本部署教程已针对「秦安县秦剧团云端预约系统 VER-{year}.FINAL-OFFICIAL」完成 EdgeOne Pages 平台全维度适配测试，
严格遵循本教程操作即可实现零配置、零报错、零瑕疵部署上线，官方永久保障兼容合规。
严格遵循本教程操作即可实现零配置、零报错、零瑕疵部署上线，官方永久保障兼容合规。
🎉 9 章部署教程全部阅读完成 🎉
恭喜完成全部部署教程学习！按照本教程 9 大章节逐步骤操作，
即可完成秦安县秦剧团云端预约系统 EdgeOne Pages 零基础正式上线。
祝您部署顺利 · 验收满分 · 项目圆满交付！
即可完成秦安县秦剧团云端预约系统 EdgeOne Pages 零基础正式上线。
祝您部署顺利 · 验收满分 · 项目圆满交付！