任务详情
要求跟我提供的样板做的一模一样，20-30日内完成开发环境与技术栈约束 （强制执行）
乙方必须严格按照以下指定版本进行开发，不得擅自更改框架或降低版本，以确方后续维护的兼容性。
保系统性能及甲
1. 前端架构运行环
境：Node.js v24.x。核
心框架：Vue 3.x。构建工具：Vite。
2. 后端架构运行语言：PHP 8.2。
开发框架：ThinkPHP 8.x。Web服务
器：Nginx 。3. 数据存储与缓存
关系型数据库：MySQL 5.7。必须使用 InnoDB 存储引擎 （支持事务）。
字符集统一使用 utf8mb4 （支持 Emoji）。缓存中间件：Redis 7.x。
三、 核心业务逻辑开发规范为保证数据一致性
及高并发场景下的系统稳定性，乙方必须遵守以下逻辑规范：1. 数据库事务控制 （Transaction）
要求：凡涉及 2 张及以上数据表 的写操作（新增、修改、删除） ，必须使用数据库事务进行包裹。
事务。一致情况。
验收标准：代码中必须显式调用 Db::startTrans（）, commit（）, rollback（） 或使用闭包禁止：严禁出现主表数据写入成功，但关联表（如日志表、资金表）写入失败导致的数据不
2. 并发控制 （Redis Lock）要求：所有涉及资源变更的提交接口（包括但不限于：表单提交、抢购、领
券、资金变动、库存扣减） ，必须使用 Redis 实现 分布式锁 或 防抖机制。
验收标准：系统必须能通过并发测试，有效防止用
户快速点击按钮导致的重复数据提交，以
及高并发请求下的“超卖”或“负数”异常。3. 代码质量与注释
清晰注释：接口层：每个 API 方法头部需注
明接口名称、输入参数说明、返回值结构。业务层：复杂逻辑判断、算法核
心部分必须包含行级中文注释。规范性
：代码结构需遵循 ThinkPHP8 与 Vue3 的官方实践，变量命名规范，禁止“
条面
式”代码。四、 源代码与知识产权 （红线条款）
1. 源码全开源：交付的所有代码必须是 明文、可阅读、可编辑 的
原始文本格式。
严禁 使用 ionCube、 Swoole Compiler、 SourceGuardian 等加密组件。严禁 代码混淆。
2. 零后门承诺：代码中不得包含任何后门程序、木马、未授权的远程控制接口。
不得包含任何“时间锁”、“域名限制锁”或向第三方发送敏感数据的隐藏代码。
五、 数据库设计与文档交付1. 数据库字典：
乙方需交付完整的《数据库设计文档》 （Word/Excel） ，包含：表名、表用途、字段名、类型、长度、默认值、详细中文含义。
2. SQL 规范：交付的建表语句（SQL）中，每个表和字段必须包含 COMMENT 属性说明。
示 例： status tinyint（1） DEFAULT 1 COMMENT ’状态: 1=启用, 0=禁用’。
六、 部署与文档交付要求乙方需
提供“小白级”运维文档，确
保甲方可独立完成部署。1. 交付物清单
1. 前端源码包 （含 package.json, src 等完整开发文件）。2. 后端源码包 （ThinkPHP 完整目录）。
3. 数据库脚本 （ install.sql，含结构与初始数据）。4. API接口文档。
5. 《系统部署与安装维护手册》 。2. 部署手册内容要求
手册必须包含以下章节的详细图文说明：环
境搭建：服务
器基础软件 （PHP8.2, MySQL5.7, Redis7, Node v24） 的安装命令或宝塔面板操作指引。
后端部署：站点配置、伪静态设置、目录权限 （runtime/public） 设置、 .env 文件配置说明。前端部署：依赖安装 （ npm install）、打包命令 （ npm run build）、以及 dist 目录的
