sbnews/AGENTS.md

Sport Era 项目说明

思考语言

思考过程请使用中文。

项目信息

• 基于 likeadmin 的体育资讯 AI 分析 App / 流量平台
• 后端：PHP 8.x + ThinkPHP / likeadmin
• 管理后台：Vue 3 + Vite + Element Plus + TypeScript
• 手机端：uni-app + Vue 3
• PC 前台：Nuxt 3 + Vue 3
• 数据库：MySQL（sbnews，表前缀 la_）
• 缓存：Redis（ThinkPHP Cache facade）

子项目开发规范

修改到哪个子项目，则需要遵循对应子项目的 Agent 说明：

模块	Agent 文件	职责
后端	server/AGENTS.md	API 接口、数据库建模、业务逻辑、定时任务
管理后台	admin/AGENTS.md	消费 adminapi 接口，构建管理页面
手机端	uniapp/AGENTS.md	消费 api 接口，构建 H5/App/小程序页面
PC 前台	pc/AGENTS.md	消费 api 接口，构建 Nuxt PC 页面
测试	qa/AGENTS.md	后端 API 验证与前端页面验证

---

编程准则

1. 做新功能之前必须先检查现有代码是否已有相关功能，避免重复开发。
2. 创建新数据表时，用到的字典、枚举值、状态码等必须配置在现有的数据表或配置表内统一管理，不能硬编码。
3. 相同或相似的功能必须封装为可复用的方法，避免重复代码。
4. 查询字段、路由、菜单、配置前，优先以当前项目代码和 sbnews.sql / docs/sql/ 中结构为准；如需线上核对，再按用户要求使用可用 MCP 或指定连接方式。
5. 不通过 WSL sshpass/scp 上传代码到服务器；项目代码更新由用户自行通过 SFTP 等方式处理。
6. 项目级文档（如协作规范、业务进度、设计稿映射、产品方案、实现流程、爬虫说明等）统一存放在项目根目录；仅子项目专属文档放在对应子目录。

---

常用命令速查

模块	开发命令	构建命令
server	php think run	—
admin	npm run dev	npm run build
uniapp	npm run dev:h5	npm run build:h5
pc	npm run dev	npm run generate / npm run build

数据库结构基准

• 数据库表前缀：la_。
• 配置存储在 la_config 表，通过 ConfigService::get/set 读写。
• 菜单存储在 la_system_menu 表，type: M=目录、C=页面、A=按钮权限。
• 定时任务注册在 la_dev_crontab，通过 php think crontab 统一调度。
• MySQL 保留字如 system、order、group、key 等写原生 SQL 时必须用反引号包裹。

代码修改后验证与评审

除非用户特别说明不需要验证，代码修改完成后按改动类型选择验证方式：

后端接口修改

1. PHP 语法检查：php -l <modified_file.php>。
2. 涉及接口时确认控制器、逻辑层、验证器、列表类、模型字段一致。
3. 涉及数据库字段时确认表结构、索引、字典或配置存在。
4. 检查前端调用方是否需要同步更新。

前端页面修改

1. 检查接口请求模块、页面路由、组件引用是否一致。
2. 新增 uniapp 页面必须检查 pages.json。
3. 涉及条件编译时确认 H5/App/小程序差异。
4. 检查控制台、网络请求和页面渲染问题。

通用代码评审清单

序号	检查项	说明
1	改动范围	确认改动文件列表，是否有遗漏或多余文件
2	跨文件依赖	修改 model/controller/API 后，检查引用方是否同步
3	硬编码检查	业务枚举、分类、状态优先走字典或配置
4	未使用引入	检查多余 import/use
5	命名一致性	字段、方法、路由命名与现有风格一致
6	安全性	SQL 拼接、用户输入、权限校验是否安全
7	幂等性	SQL 初始化必须可重复执行
8	文档同步	功能完成后更新 业务进度管理.md

设计稿映射

设计稿与页面/组件映射统一维护在：

• 设计稿映射.md

开发或还原视觉前，先确认设计稿名称、页面路径、实现状态与备注。

业务进度管理

当前业务进度、待办事项、避坑记录统一维护在：

• 业务进度管理.md

开发或接手任务前，先查看该文档确认已完成事项、进行中事项、待办事项与避坑记录。