ai_soc_sw/.ai/tasks/active/P01-003.md

Task P01-003: User 模块（个人资料 CRUD + 邀请链）

元信息

字段	值
状态	todo
优先级	P1
依赖	P01-002（Auth 模块，需要 JWT AuthGuard）
分配给	Coder AI (Trae CN + GLM-4.6)

输入

要读的文件:

• docs/02_系统架构/模块设计.md — 3.3 User 模块
• docs/02_系统架构/数据模型.md — users 表 + user_relations 表
• projects/app/src/db/schema/*.ts — P01-001 产出的 Drizzle Schema
• projects/app/src/modules/auth/auth.guard.ts — P01-002 产出的 AuthGuard

参考的 ADR:

• 无特殊 ADR

上游依赖产出:

• P01-002: AuthGuard（本模块所有接口需要 JWT 验证）

输出

要生成/修改的文件:

• projects/app/src/modules/user/user.module.ts
• projects/app/src/modules/user/user.controller.ts
• projects/app/src/modules/user/user.service.ts

API:

方法	路径	说明
GET	/user/profile	获取个人信息
PATCH	/user/profile	更新个人信息（昵称、头像、年级）
POST	/user/invite	生成邀请码
GET	/user/invite/tree	查询邀请链（递归 CTE）

关键逻辑:

• 邀请码生成: 6 位字母数字随机码，唯一
• 邀请链查询: WITH RECURSIVE CTE 查 user_relations 表，返回被邀请人列表+层级

验收方法

# 编译检查
npx tsc --noEmit

# 测试邀请链查询
curl -H "Authorization: Bearer {token}" http://localhost:3000/user/invite/tree
# 预期: { tree: [{ userId, nickname, level, invitedAt }] }

约束

• 不碰: projects/app/tests/、其他 modules/ 目录
• 技术栈: NestJS + Drizzle ORM（嵌套查询）
• 遵循: .ai/prompts/coding/code-style.md

完成报告

Coder 完成后填写。Commit message 以 [READY_FOR_TEST] 结尾。

• 输出文件已生成
• 验收命令通过
• Commit: {hash}
• Commit message: feat(P01-003): User 模块（CRUD+邀请链） [READY_FOR_TEST]