8 Commits

Include renames

Author	SHA1	Message	Date
Stev_Wang	e4330a43e4	feat(api): A4 数据字典与系统配置后端 ... 背景：A4 需要字典三层合并、配置单一来源与阈值同源。\n改动：新增 catalog 模块（类型/条目/三层合并/编码不可改/快照工具）；platform 新增 SystemConfigService/Controller、NamingService 与配置版本历史；roles/users/customers/customer-fields 改为读 system_configs 上限。\n影响面：新增 13 个 REST 端点与 4 个模块注入；system_configs 写入走事务/乐观锁/版本历史；OpenAPI 快照更新。\n回滚：回滚本提交并恢复 shared 契约；新增表可保留。\n验证：api typecheck/build；单测 137；集成 58；OpenAPI diff 无破坏性变更。	2026-11-04 11:49:05 +08:00
Stev_Wang	140dc386c1	feat(client): A3 客户与行业目录（两级行业、客户组、字段审批） ... 背景：A3 需把行业 / 客户 / 客户组 / 客户级字段立为资产根节点；用户确认两级行业树与混搭 UI（行业 B / 客户列表 A / 详情 A / 新建 B / 客户组 B / 字段 A）。 改动： - 新增 ADR-002，行业改为两级树，客户挂末级行业；同步 PRD / 技术架构 / 开发计划。 - 新增 client 模块：industries / customers / customer-groups / customer-fields 接口、真实 PrismaCustomerDirectory、客户状态机与客户转交、客户组数据范围解析、跨客户 404。 - 新增迁移与幂等种子（电商/金融两级行业、2 客户、1 客户组、4 条字段）。 - 前端新增行业/客户/客户组/字段审批页面与路由、导航更名（客户管理 / 行业管理 / 客户组），复用现有 token。 - 补充 shared 契约单测、client 集成用例、A3 浏览器 e2e。 影响面：client 模块与 client 表、shared 契约、web 路由/导航、ScopeContext 数据范围、OpenAPI 与种子；A1 客户转交占位由 client 实现替换。 回滚：回滚本提交；数据库保留新增表或按报告执行 down SQL；CUSTOMER_DIRECTORY 可切回空集实现。 验证：format:check / lint / typecheck / test 全绿（shared 131 / api 90 / web 125，共 346）；test:int 5 文件 39 条；A3 e2e 1/1；build 8/8；真实浏览器六页验证通过。	2026-11-03 21:45:38 +08:00
Stev_Wang	b489cb3152	test(api): 修复集成测试对根部门顺序与文件并行的依赖 ... 背景： - pnpm ci:local 的 test:int 在本地真实 PG 上失败，与业务代码无关，是测试自身不稳定： 1) identity 用例断言部门树第一项根部门必须有子级，但管理员可以新建无子级根部门 并排在最前（本地已有手工部门「111」，sortOrder=0），该断言不成立； 2) identity.int.spec 清理用 account startsWith('it.')，会误删 departments.int.spec 的 it.dep.* 夹具；四个 int 文件默认并行且共用同一个真实 PG，beforeAll 偶发失败。 改动： - identity.int.spec：部门树断言改为「存在带子级的根部门」，不再依赖根部门顺序； - vitest.int.config：fileParallelism: false，集成测试文件串行执行，并注释原因。 影响面： - 仅集成测试的断言与执行方式；业务代码、单测、构建不变； - test:int 改为串行，耗时略增。 回滚方式： - 回滚本提交即恢复原断言与并行执行。 验证证据： - pnpm --filter @lingxi/api test:int 连续 3 次：4 个文件 / 33 项全通过； - pnpm ci:local 第 1–8 步通过（第 10 步 e2e 为 A0 遗留问题，另行处理）； - pnpm format:check / lint / typecheck / test 通过。	2026-11-03 16:17:21 +08:00
Stev_Wang	6661c42e84	feat(identity): 补齐部门管理（两级组织树、停用启用） ... 背景： - 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。	2026-11-03 15:01:07 +08:00
Stev_Wang	61894df401	feat(identity): 完成 A2 角色权限与数据范围全栈落地 ... 背景：A2 开卡前完成 H1 权限门，确认权限点目录、特殊权限、SoD 三对、六类数据范围与超管隐式全集口径（ADR-001）。 改动： - shared：30 权限点 / 10 模块目录与元数据、特殊权限 6 编码、SoD 三对、角色与权限树契约；/me 改 dataScopes 多角色并集。 - prisma：expand 迁移新增 permissions / data_scopes；种子按原型口径重写角色权限、数据范围与 8 项特殊授予。 - api：角色 CRUD / 复制 / 停用 / 删除、权限点启动同步、SoD 40304、系统角色保护、六类范围 ScopeContext 与 CustomerDirectory 端口、变更审计与 outbox。 - web：方案 B 主从分栏三角色页面（列表 / 编辑器 / 新建），权限树、范围选择、特殊权限二次确认、保存影响、SoD 冲突、只读态与模板预填。 - 测试：角色集成 13 条 + A2 e2e 1 条；A1 全量回归。 验证：format:check / lint / typecheck / test（306）/ test:int（27）/ A2 e2e（1，复跑通过）/ openapi:export 全绿。	2026-11-03 12:26:51 +08:00
Stev_Wang	4f8f7c587d	fix(api): 允许 localhost 开发源访问 API ... 背景： - 开发环境从 http://localhost:5173 打开页面时，用户与组织页报 「成员加载失败 / Failed to fetch」； - 复现确认：API 的 WEB_ORIGIN 仅含 http://127.0.0.1:5173， 浏览器以 localhost 为 Origin 的预检响应缺少 Access-Control-Allow-Origin， 请求被浏览器拦截。 改动： - config/env.ts 的 WEB_ORIGIN 默认值同时包含 127.0.0.1 与 localhost； - .env.example 同步为逗号分隔的两个开发源。 影响面： - 仅开发环境 CORS 白名单，生产仍由部署环境变量显式配置； - 其他来源仍需按 WEB_ORIGIN 显式加入。 回滚方式： - 回滚本提交并重启 API，即恢复仅允许 127.0.0.1:5173。 验证证据： - OPTIONS /api/v1/users 对两个 Origin 均返回对应 Access-Control-Allow-Origin； - 浏览器从 localhost / 127.0.0.1 发起 /me 均返回 401（网络可达，不再 Failed to fetch）； - pnpm --filter @lingxi/api typecheck / test（10 files / 60 tests）通过。	2026-11-03 09:36:16 +08:00
Stev_Wang	4d9eb980af	feat(identity): 完成 A1 身份认证与用户管理全栈落地 ... 背景： - 开发计划 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	2026-11-03 00:03:33 +08:00
Stev_Wang	23067edb8f	feat(api): 搭建 API 与 Worker 骨架及契约基线 ... NestJS 11 + Fastify 统一错误体与 trace_id，/health 真实探活 DB/Redis，OpenAPI 3.1 契约含 20 个错误码；shared 包提供错误码、权限点、ULID、分页与通用 schema；worker 完成队列进程骨架。	2026-11-02 17:20:46 +08:00