wang259797/lingxi
1
0 Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
55 Commits 1 Branch 0 Tags
cda4b1825b3625b38a6fefe48d523eb986d9c51a
Commit Graph
17 Commits
Author SHA1 Message Date
Stev_Wang cda4b1825b chore(openapi): 同步部门管理接口的生成类型
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 上一批部门管理接口（disable / enable、update、树与字段说明）合入后没有重新导出 OpenAPI，
  apps/web/src/api/generated/openapi.d.ts 仍停留在「部门改名」版本，前端类型与真实契约不一致；
- pnpm ci:local 第 9 步 openapi:export 会自动重生成该文件，导致每次跑完工作区变脏。

改动：
- 执行 pnpm openapi:export，重新生成 apps/web/src/api/generated/openapi.d.ts
  （新增 /departments/{id}/disable、/departments/{id}/enable、update 操作与字段说明）。

影响面：
- 仅前端生成类型，无运行时行为变化；openapi/lingxi.openapi.json 无差异。

回滚方式：
- 回滚本提交即恢复旧生成文件。

验证证据：
- pnpm openapi:diff 通过；
- pnpm ci:local 全部门禁通过。
 2026-11-03 16:26:10 +08:00
Stev_Wang b489cb3152 test(api): 修复集成测试对根部门顺序与文件并行的依赖
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 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 4f6ccda6e3 fix(web): 统一用户/角色/部门列表行样式与选中态
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 用户、角色列表行为全宽 + 1px 分隔线，选中行与相邻悬停行的高亮背景会盖住分隔线，
  两块色块粘连，看起来间距被挤在一起；
- 部门树为列表内留白 + 圆角行，其左侧 2px 竖条贴行左缘，而用户 / 角色的竖条贴卡片边缘，
  三页选中指示器不一致；部门子级缩进后竖条位置还会随层级漂移；
- 行宽收紧后角色副信息（编码 · 数据范围）会被硬裁掉半个字。

改动：
- 三页列表统一行几何：列表内留白 6px、行间 2px、行圆角 6px，去掉贯穿分隔线；
- 统一取消左侧 2px 竖条，选中态改为品牌浅底 + 品牌色 / 600 字重标题，与侧栏导航一致；
- 行高 64→60，保持 9 条一屏；部门树根级 / 子级行距同步；
- 新建角色页的角色模板列表套用同一套行样式；
- 角色副信息改为块级 text-overflow: ellipsis，右侧统计列 132→112px 归还宽度，
  1440 下角色编码与数据范围不再截断。

影响面：
- 仅管理中心用户 / 角色 / 部门三页与新建角色页的列表视觉；
- 结构与交互不变，接口、权限、路由、数据均不变；≤1280/1080 沿用原响应式收缩规则。

回滚方式：
- 回滚本提交即恢复全宽行 + 1px 分隔线 + 左侧竖条与原行宽。

验证证据：
- pnpm format:check / lint / typecheck 通过；pnpm test：web 120/120 通过；
- Chrome 1440×900 实机截图：选中 + 悬停相邻行留白清晰，三页选中态一致；
- 角色列表副信息溢出检测：overflow: []（无截断）。
 2026-11-03 15:55:06 +08:00
Stev_Wang f849e443d7 refactor(web): 侧栏「用户与组织」更名为「用户管理」 
背景：
- 管理中心侧栏菜单名为「用户与组织」，与「角色管理」「部门管理」的命名方式不一致；
- 页面标题、面包屑仍沿用旧名，三处展示不统一；
- A1 文档与代码注释中该功能域本来即称「用户管理」。

改动：
- nav-config：菜单 label 改为「用户管理」，description 改为「成员账号、部门归属与登录状态」；
- breadcrumbs：用户新建 / 详情子路由的面包屑 2 处同步；
- UsersPage：页面 h1 同步；
- nav-config.spec / breadcrumbs.spec / e2e a1-identity 的标签与 heading 断言同步；
- 11-前端路由与目录规范、AppLayout 注释同步；PRD P-01 功能名保持「用户与组织管理」不变。

影响面：
- 仅前端文案与对应断言；路由、权限点、接口、数据均不变。

回滚方式：
- 回滚本提交即恢复原「用户与组织」文案与断言。

验证证据：
- pnpm format:check / lint / typecheck 通过；
- pnpm test：web 120/120 通过；
- Chrome 1440×900 实机：侧栏、面包屑、页面标题均显示「用户管理」。
 2026-11-03 15:54:13 +08:00
Stev_Wang 6661c42e84 feat(identity): 补齐部门管理（两级组织树、停用启用）
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 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 f4da1f3c02 refactor(web): 编辑角色主操作移入详情页头并移除页脚
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：角色详情页把「编辑角色」放在右下角页脚，与页头的复制/停用分离，主操作位置突兀；页脚只剩一句备注也浪费垂直空间。

改动：
- 页头操作顺序调整为：复制 → 停用/启用（系统角色为改名）→ 编辑角色（实心主按钮）；
- 只读用户显示「查看角色」，系统角色也显示「查看角色」（仅名称可改，避免编辑语义过强）；
- 移除详情页脚及编辑按钮，权限摘要与绑定用户获得更多高度；
- 更新只读态单测断言。

验证：format:check / lint / typecheck / test 全绿；5173 实测页头操作与主按钮位置正确。
 2026-11-03 14:16:39 +08:00
Stev_Wang f5a8afe835 refactor(web): 侧栏与页面模块名由角色权限改为角色管理
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：角色权限只描述模块的一部分能力，侧栏同级均为模块级命名（用户与组织 / 客户 / 行业树）；角色页实际覆盖角色 CRUD、权限点、数据范围、特殊权限与 SoD。

改动：
- 侧栏、面包屑、页面标题统一为「角色管理」，页面内权限点 / 数据范围 / 特殊权限分区名不变；
- 用户详情与超管授予弹窗中的模块引用同步改为「角色管理」；
- 开发计划页面清单与 A2 实施报告同步；
- 更新导航与面包屑单测、A2 e2e 标题断言。

验证：format:check / lint / typecheck / test 全绿；5173 实测侧栏、面包屑、页标题均为「角色管理」。
 2026-11-03 14:03:13 +08:00
Stev_Wang a3419cf5da refactor(web): 收敛角色页权限点目录入口
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：列表页页头「权限点目录」与详情面板「查看权限点目录」和编辑器权限点 Tab 信息重复，抽屉只读、无搜索、无操作，且页头出现两个并列动作。

改动：
- 移除列表页页头目录按钮与 PermissionCatalogDrawer 组件及对应样式；
- 详情面板删除「查看权限点目录」入口，保留「已选 n / 30」信息；
- 权限查看统一走编辑器「权限点」Tab（只读用户也可进入查看）；
- 同步 A2 实施报告与设计说明。

验证：pnpm format:check / lint / typecheck / test 全绿；5173 实测页头仅保留「新建角色」，详情面板无目录入口。
 2026-11-03 13:56:35 +08:00
Stev_Wang fe70a2bcee fix(web): 修复角色列表页头操作按钮未右对齐
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：/system/roles 页头标题容器缺少 lx-roles__head-txt 类，且页头未设置 space-between，导致「权限点目录 / 新建角色」紧跟在标题后停在页面中间；编辑器/新建页因标题容器有 flex:1 不受影响。

改动：RolesPage 标题容器补 lx-roles__head-txt；.lx-roles__header 增加 justify-content:space-between，操作区增加 margin-left:auto。

验证：pnpm format:check / lint / typecheck / test 全绿；本地 5173 实测按钮回到右侧（1440×900 截图已更新）。
 2026-11-03 13:44:51 +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 f97f97b0cd refactor(web): 统一模块化路由并将平台更名为管理中心
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 落实 11-前端路由与目录规范：URL、导航、面包屑、页面目录一一对应；
- 「平台」更名「管理中心」，模块 key 由 platform 改为 system；
- 原导航模块 key 与 URL 首段不一致（script vs /scripts、asset vs /assets），
  占位页按 URL 解析不到模块，出现「页面不存在」。

改动：
- nav-config：模块 key 改为 URL 首段（scripts / assets / system），平台更名
  管理中心，管理中心全部路径收敛到 /system/*；用户页为 /system/users；
- routes / router：ROUTES 按模块分组；新增 /system/users、/system/users/new、
  /system/users/:id；旧 /users* 与 /platform* 加前端重定向；/system 落到用户列表；
- 页面目录迁移：pages/users → pages/system/users，pages/home → pages/dashboard，
  懒加载与所有引用同步；
- 面包屑、AppLayout、登录回跳、通用占位页（按路径 + 权限解析，无权限进 403）
  与单测 / e2e 路径同步；
- 顺带修复 /scripts/library、/assets/library 等占位页因模块 key 不一致导致的 404。

影响面：
- 仅前端路由与目录；后端 /api/v1/users 等接口与权限点不变；
- 旧书签 /users*、/platform* 由前端重定向兼容一个版本。

回滚方式：
- 回滚本提交即恢复 /users 与 /platform/* 路由、原页面目录与导航命名。

验证证据：
- pnpm --filter @lingxi/web lint / typecheck / test 通过（15 files / 55 tests）；
- pnpm build 通过；
- 浏览器：登录后落在 /system/users，导航显示「管理中心」；/users → /system/users，
  /platform/roles → /system/roles；有权限的 /scripts/library、/assets/library
  显示占位页，无权限显示 403；
- A1 e2e 6/6 通过（真实 API + 浏览器）。
 2026-11-03 10:31:13 +08:00
Stev_Wang f8b6232b4c style(users): 优化搜索框图标间距与详情 Tab 左边距
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 用户与组织页搜索框的前缀图标与占位文字仅 8px，视觉偏挤；
- 详情卡片的 Semi Tab 标题默认无内边距，基本资料等标签贴住卡片左边缘。

改动：
- 搜索框前缀图标改为左 10px / 右 12px；
- 详情 Tab bar 左右内边距 20px（1024 断点下与内容一起收紧为 16px），
  使 Tab 标题与下方「身份 / 权限 / 状态」内容左对齐。

影响面：
- 仅用户与组织页样式，不影响交互与接口。

回滚方式：
- 回滚本提交即恢复原间距。

验证证据：
- 1440×900 实测：前缀图标左 268 / 输入文字左 296，Tab 标题与内容均从 677 开始；
- pnpm format:check / web lint / typecheck / test（15 files / 55 tests）通过。
 2026-11-03 09:53:08 +08:00
Stev_Wang 4f8f7c587d fix(api): 允许 localhost 开发源访问 API
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 开发环境从 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 340a8ed176 style(login): 精简登录页宣传区并放大输入框图标间距
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 登录页左栏四张比例缩略图在真实页面中观感偏廉价；
- 输入框前缀图标与占位文字间距仅 8px，视觉上偏挤。

改动：
- 左栏移除 9:16 / 1:1 / 16:9 / 4:3 素材缩略及相关数据与样式，保留品牌、定位与三条能力；
- 登录卡片输入框前缀图标改为左 10px / 右 14px，后缀图标左 12px / 右 8px，图标与提示文字拉开距离；
- 清理 login-content 与 pages.css 中不再使用的素材墙代码。

影响面：
- 仅登录页视觉，不影响登录逻辑、接口与权限。

回滚方式：
- 回滚本提交即恢复原素材墙与输入框间距。

验证证据：
- pnpm --filter @lingxi/web lint / typecheck / test 通过（15 files / 55 tests）；
- pnpm --filter @lingxi/web build 通过；
- 1440×900 与 1280×900 截图核对，无溢出、图标与文字间距正常。
 2026-11-03 07:46:47 +08:00
Stev_Wang 4d9eb980af feat(identity): 完成 A1 身份认证与用户管理全栈落地
ci / 质量门禁 (push) Canceled after 0s
Details 
背景：
- 开发计划 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 073d210a92 feat(web): 搭建 Web 壳层与 UI 包基线 
React 19 + Vite 6 + Router 7 + TanStack Query + Zustand；Semi 二次封装与 Remix 图标统一出口；顶部模块 + 左侧功能菜单布局、Cloud Blue 主题、登录页与 401/403/404/500 页面；请求层含 token 注入、单飞刷新与统一错误提示。
 2026-11-02 17:21:16 +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