TODO
项目当前状态
- 项目基础结构已建立
- 多模块目录已创建
- 核心 Java 文件已铺设
- 资源文件已存在（application.yml / schema.sql / data.sql）
- 静态结构自检（v3）通过
- Maven 编译验证
- Spring Boot 启动验证
- 数据库初始化验证
- 接口联调验证
- 业务闭环完整性验证
P0 - 必须完成
1. 编译与启动验证
- 在有环境时执行
mvn clean compile - 修复所有编译错误
- 执行
mvn spring-boot:run - 修复 Spring 启动错误
- 确认所有 Bean 注入成功
- 确认数据库连接正常
- 确认 schema.sql / data.sql 执行成功
2. 认证与安全闭环
- 确认用户注册接口可用
- 确认用户登录接口可用
- 确认密码已加密存储
- 确认登录后返回 token/JWT
- 确认 Spring Security 拦截规则生效
- 确认未登录无法访问受保护接口
- 确认可正确获取当前登录用户
3. 用户模块
- 确认获取当前用户信息接口可用
- 确认按 ID 查询用户接口可用
- 确认用户信息返回 DTO，不直接暴露敏感字段
- 确认密码字段不会在响应中返回
4. 家庭模块
- 确认创建家庭接口可用
- 确认更新家庭接口可用
- 确认查询家庭详情接口可用
- 确认查询家庭成员列表接口可用
- 确认邀请家庭成员接口可用
- 确认接受邀请接口可用
- 确认邀请状态流转正确（PENDING / ACCEPTED / REJECTED）
- 确认家庭创建者默认角色合理
- 确认家庭成员角色规则明确
5. 分类模块
- 确认创建分类接口可用
- 确认分类列表接口可用
- 确认更新分类接口可用
- 确认删除分类接口可用
- 确认分类归属规则明确（用户维度/家庭维度）
- 确认分类名称唯一性规则明确
6. 物品/库存模块
- 确认创建物品接口可用
- 确认更新物品接口可用
- 确认查询物品列表接口可用
- 确认查询物品详情接口可用
- 确认库存增加接口可用
- 确认库存减少接口可用
- 确认库存调整接口可用
- 确认库存日志查询接口可用
- 确认出库时会校验库存是否足够
- 确认库存变更必定写入日志
- 确认库存不会出现非法负数（除非明确允许）
7. 通知模块
- 确认通知列表接口可用
- 确认通知详情接口可用（如已设计）
- 确认标记已读接口可用
- 确认全部已读接口可用
- 确认通知归属用户正确
- 确认未读/已读状态正确切换
8. 通用能力
- 确认全局异常处理生效
- 确认业务异常统一返回
- 确认 404/参数错误/权限错误都有统一响应
- 确认接口统一使用
ApiResponse - 确认 DTO 参数校验注解已补齐
- 确认校验失败时返回统一错误格式
9. 数据库与实体映射
- 确认核心表结构完整
- 确认实体字段与表字段一致
- 确认主外键关系合理
- 确认索引已补充关键查询字段
- 确认唯一约束已配置
- 确认审计字段（createdAt / updatedAt 等）已落地
P1 - 建议尽快补充
1. 家庭模块增强
- 增加拒绝邀请接口
- 增加退出家庭接口
- 增加移除家庭成员接口
- 增加修改成员角色接口
- 增加查询我的家庭接口
- 增加邀请列表查询接口
2. 分类模块增强
- 增加分类分页查询
- 增加分类关键字搜索
- 删除分类前检查是否有关联物品
- 增加分类启用/禁用状态（如有需要）
3. 物品模块增强
- 增加物品分页查询
- 增加按分类筛选
- 增加按关键字搜索
- 增加按库存状态筛选
- 增加低库存提醒逻辑
- 增加物品删除逻辑
- 明确删除策略（物理删除/逻辑删除）
- 支持初始库存设置
- 支持备注字段
- 支持单位字段（件/盒/瓶等）
4. 通知模块增强
- 家庭邀请时自动发送通知
- 邀请接受时自动发送通知
- 库存不足时自动发送通知
- 系统通知模板化
- 支持按已读/未读筛选
- 支持分页查询
5. 通用能力增强
- 增加分页统一返回结构
- 增加统一错误码枚举
- 增加日志输出规范
- 增加接口访问日志
- 增加操作审计日志
P2 - 后续增强项
1. 认证与安全
- JWT 刷新机制
- 退出登录/token 失效机制
- 登录失败次数限制
- 忘记密码/重置密码
- 邮箱/手机号验证码登录（如有需求）
2. 物品能力增强
- 支持物品图片上传
- 支持条形码/二维码
- 支持保质期字段
- 支持过期提醒
- 支持批量导入导出
- 支持盘点功能
3. 家庭协作增强
- 支持多角色权限模型
- 支持邀请链接/邀请码
- 支持家庭切换
- 支持多家庭模型（如未来有需求）
4. 工程化能力
- 增加 Swagger/OpenAPI
- 增加单元测试
- 增加集成测试
- 增加 Dockerfile
- 增加 docker-compose
- 增加部署文档
- 增加 CI/CD 配置
5. 管理与运维
- 增加管理员后台接口
- 增加用户状态管理
- 增加通知管理能力
- 增加系统配置中心（如有需要）
风险点检查
高风险
- SecurityConfig 是否真正生效
- Repository 接口是否继承正确
- Entity 与 schema.sql 是否一致
- DTO / Entity 是否混用导致接口暴露不合理
- 循环依赖是否存在
- 家庭、分类、物品之间外键关系是否合理
- 邀请和通知是否存在重复发送/重复接受问题
中风险
- 删除逻辑是否统一
- 状态枚举是否统一
- 统一返回结构是否全覆盖
- 时间字段时区处理是否统一
- 初始化数据是否与表结构匹配
文档补充
- README.md
- API_LIST.md
- DB_DESIGN.md
- BUSINESS_RULES.md
- PROJECT_CHECKLIST.md
未来执行顺序建议
- 完善 TODO 中的 P0
- 有环境后先跑 compile
- 再跑 spring-boot:run
- 再做接口验收
- 再补 P1 功能
- 最后做 P2 增强与工程化
0