背景： - A1 只实现了部门树读取与新建 / 改名接口，没有部门管理入口， 负责人、排序、停用状态都无法维护； - 用户必须关联部门，部门无法维护会让 A2 的数据范围缺少组织基础。 改动： - shared：DepartmentNode 增加 status / sortOrder / directMemberCount； 新增 createDepartmentInput / updateDepartmentInput / departmentTreeQuery 契约； - api：GET /departments/tree?include_disabled；POST/PATCH /departments （名称 / 负责人 / 排序）；POST /departments/{id}/disable|enable； 只停用不删除，有在职成员 / 启用子部门 / 下级在职成员时禁止停用； 新建 / 编辑用户校验部门必须启用；@Audit 与 OpenAPI 同步； - web：管理中心新增「部门管理」/system/departments，左两级组织树 + 右详情 / 内联编辑 + 新建部门/小组 + 停用启用二次确认；显示已停用、 ?id= 选中可恢复、无 user:manage 只读；用户页部门选择仍只取启用部门； - 测试：shared 契约、api 单测 + int、web 树/表单/接口单测同步。 影响面： - 新增部门写接口与页面；GET tree 默认仍只返回启用部门，对用户页无破坏； - 权限复用 user:view / user:manage，不新增权限点； - 无数据库迁移（status / leader_user_id / sort_order 列已存在）。 回滚方式： - 回滚本提交即移除部门管理页与写接口，保留原只读树；数据库无需回滚。 验证证据： - pnpm format:check / lint / typecheck 全绿； - pnpm test：shared 121 / api 90 / web 120；test:int 4 files / 33 tests； - pnpm openapi:diff：无破坏性变更； - 真实 API + 浏览器（jiang.lan）：新建一级部门 / 小组、改名、停用空小组、 重名 40903、树/详情/停用确认均正常； 截图 design/a1-ui-v1/shots/impl/70-departments.png。
背景： - 开发计划 A1 批次要求登录/刷新/登出、用户生命周期、路由与按钮权限、 权限三态用例；视觉已选定方案 B（主从分栏 + 分屏登录）。 改动： - packages/shared：新增 identity 契约（User/Me/Login/Refresh/Department/Role） 与 user:view 权限点；写接口 strict 校验。 - apps/api：新增 identity 模块与 Prisma expand 迁移（departments/users/roles/ user_roles/role_permissions/refresh_tokens）；Argon2id、JWT access+refresh 旋转与 jti 吊销、登录失败锁定、首登强改、守卫链、/me、@Audit 上下文、幂等种子。 - apps/web：按方案 B 落地 /users、/users/new、/users/:id、分屏登录与 403； usePermission/<Can>、路由守卫、401 单飞刷新、停用会话兜底、Semi + token。 - e2e：新增 A1-QA-01 六类端到端用例（A1_E2E 门控）。 - openapi 与前端生成类型同步；.env.example 登记认证变量；实施报告入库。 影响面： - 新增运行时依赖 @nestjs/jwt、argon2（计划 A1-BE-02 已批准，版本精确锁定）。 - 迁移为 expand，不改既有表；本地需 prisma migrate 后重新 seed。 - 平台导航「用户与组织」由 /platform/users 调整为 /users。 回滚方式： - 代码整体回滚本提交；迁移为 expand，回滚代码不需删表； - 本地如需彻底回退按实施报告 §6 处理。 验证证据： - pnpm format:check / lint / typecheck 通过； - pnpm test：shared 95 / api 60 / web 55； - pnpm test:int：7 个（真实 PG/Redis）； - A1_E2E=1 playwright test e2e/a1-identity.spec.ts：6/6； - 报告：docs/开发计划/灵犀_A1身份认证与用户管理_实施报告_V0.1.md
Stev_Wang
Stev_Wang
Stev_Wang
Stev_Wang