sbnews/文档索引.md

Sport Era 文档索引

新增项目级文档统一存放在 docs/；根目录仅保留本索引及项目入口说明。源码子目录中的 README、AGENTS 等模块说明继续就近维护。

项目管理

• 业务进度管理：已完成、进行中和待办事项，以及避坑记录。
• 设计稿映射：设计稿与页面、组件的映射关系。
• 产品方案文档：产品定位、功能规划与技术方案。
• 实现流程文档：项目实现步骤与流程说明。

功能设计与实施记录

• 赛事中心赛程、直播、赔率组件设计
• 赛事中心赛程、直播、赔率组件实施计划
• 比赛详情赔率绑定设计
• 比赛详情赔率绑定实施计划
• 赔率平台皇冠展示名设计
• 赔率平台皇冠展示名实施计划
• 直播间功能设计规格

运维与爬虫

• 测试服务器运行环境：服务器资源、宿主机服务、Docker 容器与当前风险快照。
• Gitea 部署说明：Gitea 的访问地址、持久化数据、运维命令与首次初始化步骤。
• 爬虫任务脚本文档：爬虫任务的功能和执行说明。
• Docker crawler 说明：爬虫容器的源码级说明。

数据库脚本

• docs/sql/：数据库表、字段、索引、配置、菜单和定时任务的初始化或变更 SQL。
• 命名约定：create_ 为建表，alter_ 为字段调整，insert_ 为配置、菜单或定时任务初始化，fix_ 为数据修复。
• 执行前以当前代码与数据库结构为准；SQL 必须保持幂等，且不得将数据库密码写入脚本或文档。

模块说明

• 后端说明 / 后端规范
• 管理后台说明 / 管理后台规范
• 手机端说明 / 手机端规范
• PC 前台说明 / PC 前台规范

文档维护规则

1. 新增项目级文档先放入 docs/，再补充本索引的对应链接。
2. 设计或实现变更完成后，同步更新 业务进度管理；涉及页面设计时同步更新 设计稿映射。
3. 服务器状态文档是快照，任何后续部署、容器重建或资源变化后，应重新采集并更新采集时间。