Requirement Pack

Java 后端需求包

用于确认 Spring Boot API、数据模型、权限、文件、定时任务、后台管理、联调和部署。

这个需求包解决什么

它不是报价表,也不是泛泛的沟通清单。它用来判断一个项目能不能进入开发:事实是否够、风险是否清楚、首版是否能验收、后续 AI 能不能接手。

拿到真实需求后,先按下面字段补齐,再用 AI 需求文档生成器整理成任务包。

需求确认清单

先补齐必填项,再看可选补充。风险检查不过关时,不要直接进入开发。

必填信息

调用端:小程序、网页、管理后台、第三方系统或定时任务。
核心数据对象:用户、订单、商品、报名、文件、审核、配置、日志等。
字段和状态:必填字段、唯一约束、枚举状态、状态流转和删除策略。
接口范围:列表、详情、新增、修改、删除、上传、登录、导出、审核。
权限模型:角色、菜单、按钮、数据隔离、管理员和普通用户边界。
数据库和迁移:新建库、已有库、旧数据迁移、索引和备份。
联调方式:Swagger、Postman、示例 JSON、测试账号和前端环境。
部署环境:JDK、MySQL、Redis、Nginx、端口、日志、环境变量。

可选补充

已有接口文档、数据库表结构、旧系统账号和错误日志。
文件存储、短信、支付、地图、第三方 API、消息队列或对象存储资料。
后台页面草图、导入导出模板和运营配置字段。
性能预期:数据量、并发、导出规模、任务频率和保留周期。

风险检查

没有权限边界时,后台接口容易泄露不该看的数据。
没有数据模型就先写 Controller,后期会反复返工。
已有库迁移前必须备份,不能直接改生产表。
文件上传、导出和定时任务需要考虑大小、超时、路径和清理策略。
只交付代码但不记录部署方式,会导致下一个 AI 无法接手。

可开工标准

数据对象、接口范围、权限边界和部署环境已经明确。
每个核心接口都有请求、响应、错误和权限说明。
至少有一组正常数据和一组异常数据用于验收。
数据库迁移和回滚策略已经写清楚。
日志、健康检查和联调方式已经纳入交付范围。

交接产物

API 清单、数据模型、错误码和权限说明。
数据库脚本、迁移记录、备份位置和回滚说明。
部署命令、环境变量名、端口、日志路径和健康检查地址。
Postman/Swagger 入口、测试账号和联调样例。
已测接口、未测风险和下一批接口计划。

交给 AI 前要确认

首版范围和暂不做范围已经分开。
验收标准能写成具体动作和可观察结果。
部署环境、账号权限、域名状态和缺失资料已经说明。
敏感信息不会进入公开仓库、公开页面或可泄露文档。
下一位 AI 能通过 HANDOFF、任务包和内部文档继续工作。
Contact

把这一类需求整理成任务包

先按产品类型补齐必填信息、风险检查和可开工标准,再交给 AI agent 拆任务、写代码、测试、部署和交接。

刘鸡血 微信二维码微信扫码添加