10 Commits

Include renames

Author	SHA1	Message	Date
Stev_Wang	c90a036f82	docs(ci): 明确 CI 仅本地执行，远端 Gitea 不启用 CI ... 背景：远端自建 Gitea 未部署 Actions runner，推送后线上 CI 无法执行；原规范仍要求「推送后确认 CI」，容易误以为需等待远端流水线。 改动： - AGENTS §6/§7：CI 只本地执行，推送前必须 pnpm ci:local 或本地门禁全绿，禁止等待/依赖远端 CI。 - 06-测试与CI规范 V1.1：新增「本地 CI 流水线（远端不跑 CI）」强制规则；集成/契约运行时机改为推送前本地。 - 01-Git规范 / 07-CodeReview：删除「推送后确认 CI」，改为本地门禁后推送。 - README：明确远端无 runner，ci.yml 仅本地参考/手动触发。 - .gitea/workflows/ci.yml：去掉 push 触发，仅保留 workflow_dispatch，避免推送停留在 queued。 影响面：仅规范与工作流配置，不影响代码/数据。 验证：pnpm format:check / lint 通过；pnpm ci:local 全部门禁通过（237.2s，4 e2e 冒烟 passed，8 个门控用例按环境变量跳过）。	2026-11-04 08:15:06 +08:00
Stev_Wang	3e384febf3	fix(tooling): 给 db:reset 增加显式确认，避免误清本地密码 ... 背景： - 本轮部门管理联调后执行了 pnpm db:reset 清理测试数据，清空本地库， 导致用户手工改过的登录密码被重置回 lingxi2026； - 之前只保证了 ./dev.sh / pnpm dev / pnpm db:init 不会重置数据， db:reset 本身仍可被脚本或助手无提示执行，问题没有真正兜住。 改动： - 新增 scripts/db-reset.mjs：默认拒绝执行并打印影响；只有显式 ALLOW_DB_RESET=1 才调用 prisma migrate reset --force； - package.json 的 db:reset 指向该脚本； - README / AGENTS §6 §11 / e2e README / A1 实施报告同步： 日常迁移补种子只用 pnpm db:init，验证/联调中禁止 db:reset； e2e 会改写 actor 密码，需使用专用账号或独立测试库。 影响面： - 确需清库时多一步显式确认；迁移、启动、单测、int 测试不受影响。 回滚方式： - 回滚本提交即恢复 db:reset 直接执行 prisma migrate reset --force。 验证证据： - pnpm db:reset 无 ALLOW_DB_RESET 时退出码 1，并打印拦截说明； - pnpm format:check / lint 通过；node --check scripts/db-reset.mjs 通过。	2026-11-03 15:16:52 +08:00
Stev_Wang	7824bc7b32	fix(dev): 明确启动不重置数据库并新增安全 db:init ... 背景：开发机每次重启后被反馈需要重新用默认密码登录并强改，排查确认仓库启动链路（dev.sh / pnpm dev / API / worker / db:seed）均不重置密码；只有 db:reset / migrate reset / 重建数据卷会恢复种子密码。A2 收尾时为干净截图执行过 db:reset，是最近一次重置的直接原因。 改动： - 新增 pnpm db:init = prisma migrate deploy + 幂等 seed，作为首次/迁移后的安全初始化；不重置数据、不覆盖已有密码。 - README / dev.sh / AGENTS 命令契约 / SEED.md / A1·A2 实施报告明确：日常启动不需要 DB 命令，db:reset 仅用于清库。 - 实测：对已改密的 admin 执行 db:init 后 password_hash 与 must_change_password 均未变化。 验证：pnpm format:check / pnpm lint 通过；db:init 实际执行通过。	2026-11-03 13:37:34 +08:00
Stev_Wang	a1e28daec5	docs(routing): 新增前端路由与目录规范并收敛计划路由 ... 背景： - 前端路由缺少统一规范：导航模块 key 与 URL 首段不一致，页面目录未镜像 路由，04 规范中的历史路由示例与实际实现不符； - 用户确认「平台」更名为「管理中心」，路由统一为 /<模块>/<功能>。 改动： - 新增 11-前端路由与目录规范：模块与基础路径表、路径语法（复数 kebab-case、 /new、:id、层级与 query 状态）、pages/<模块>/<功能>/ 目录映射、路由注册、 旧链重定向、新增页面检查清单； - 04 §8 的 API-27 改为模块化路由并链接 11；工程规范索引与 AGENTS §9 登记 11； - 开发计划：平台更名管理中心，附录 C 页面清单收敛为模块化路由，§7.1 / §8.3 同步，版本记录补「路由规范回写」； - A1 实施报告路由说明更新为 /system/users（旧 /users* 重定向）。 影响面： - 仅文档与规范，不改变功能范围、权限点与后端接口；后续批次按 11 执行。 回滚方式： - 回滚本提交即恢复原附录 C 与 04 §8 描述；代码不受影响。 验证证据： - pnpm format:check 通过；路由与代码行为见相邻的 web 重构提交。	2026-11-03 10:30:55 +08:00
Stev_Wang	5628e158c0	fix(infra): 移除本地 S3 容器并改用 check:dev ... 背景：本地 PG/Redis 已按要求复用 docker-postgres-1 / docker-redis-1； S3 容器按用户要求删除，后续接入公网自建 RustFS。 改动： - 删除 infra/docker-compose.dev.yaml、infra/compose.dev.yaml - 移除 compose:up / compose:down 脚本，改用 check:dev 预检本机 PG/Redis - 新增 scripts/check-dev-deps.mjs；.env.example 的 S3_* 改为待填 - README / AGENTS / A0 报告同步本地依赖与对象存储说明 影响面：本地开发依赖与 CI 本地脚本、环境变量样例、文档。 回滚方式：恢复被删除的两个 compose 文件与 package.json 脚本即可。 验证：format:check、lint、pnpm ci:local（含 e2e 4/4）全部通过，用时 106.3s。	2026-11-02 18:26:24 +08:00
Stev_Wang	68b5ca20f4	ci(ci): 支持本地 CI 并调整开发库凭据 ... 背景：Gitea 暂未部署 Actions runner，远程 CI 会停留在 queued；本地开发库按约定改用 lingxi / postgres / postgres。 改动： - 新增 pnpm ci:local，按 CI 工作流顺序执行 compose、格式、Lint、类型、单测、构建、迁移种子、集成、OpenAPI 与 e2e； - 新增 scripts/e2e.mjs 管理 vite preview 生命周期，e2e 改为单 worker 避免退出挂起； - openapi:export 生成后自动 Prettier，保持工作区干净； - compose、.env.example、CI services 数据库凭据统一为 postgres/postgres，库名 lingxi； - README、AGENTS、A0 报告同步本地 CI 与数据库说明。 影响面：仅本地开发与 CI 执行方式，无业务代码/接口/数据模型变更；本地库已重建为 lingxi/postgres。 回滚方式：git revert 本提交；数据库需按回滚后的 compose 凭据重新初始化。 验证：pnpm ci:local 全绿（158s），format:check、lint、typecheck、openapi:diff 通过。	2026-11-02 18:14:08 +08:00
Stev_Wang	dd01b89214	docs(docs): 调整分支策略为仅 main 直推 ... 背景：用户确认仓库只保留 main，不再创建任何远程分支或走 PR 合并。 改动： - 01-Git规范 V1.1：仅 main 直推，禁止非 main 分支推送、force push 与 Merge commit； - AGENTS V1.1：变更流程改为直接提交并推送 main； - 07-CodeReview：PR 模板改为提交说明，合并流程改为推送与推送后观察； - 03/06/工程规范 README 同步去除 PR 措辞； - CI 仅保留 push main 与 workflow_dispatch 触发。 影响面：仅流程与文档，无代码/数据/接口变更。 回滚方式：git revert 本提交即可恢复旧流程。 验证：format:check、lint、typecheck 全绿（10/10）。	2026-11-02 17:40:01 +08:00
Stev_Wang	043f0d9962	docs(plan): 补全开发计划与项目索引 ... 引入 M0–M4 开发计划（含 A0 WBS、门禁与七管理模块专项），并在 README、AGENTS 同步文档索引；保留 A0 已完成状态。	2026-11-02 17:29:59 +08:00
Stev_Wang	75cedbe97b	docs: 明确 Git 提交信息与 PR 标题使用中文 ... 原 GIT-05 要求 subject 用英文祈使句，与团队实际书写习惯不符（已有提交均为 中文），且缺少中英混排与术语约定，容易写出 Chinglish、自造术语或中英标点混乱。 本次改动： - GIT-05 改为「提交信息一律使用中文」，type / scope 保留英文小写，规定祈使句、 字数（≤50 汉字 / 整行 ≤72 字符）与不加句末标点； - 新增 GIT-21~GIT-23：中英文间加空格、使用全角标点与反引号、术语沿用 PRD 术语表、 禁止 Chinglish 与无信息缩写； - 新增 §2.2 commitlint 配置要点：中文必须关闭 subject-case、拦截中文句号， 否则钩子校验实际无效； - 同步 03（commit-msg 钩子说明）、07（PR-01 标题用中文）与 AGENTS §7 / §9 / 附录。 影响面：仅文档，无代码影响。新规则对后续提交生效，已推送的历史提交不改写 （GIT-15 禁止改写 main 历史）。 回滚方式：git revert 本提交。	2026-11-02 15:12:56 +08:00
Stev_Wang	00ae12435e	docs(specs): add AGENTS.md and engineering guidelines ... 项目尚无统一工程规范，AI 助手与研发各自发挥导致返工风险。建立 总纲 + 细则两层结构：AGENTS.md 只写硬约束与索引（14 条红线、技术栈 基线、仓库结构、命令契约），细则拆为 10 份文档覆盖 Git、代码风格、 格式化、API 与路由、数据库、测试与 CI、Review、日志、密钥、资产命名。 影响面：仅文档。约束力从本轮起对新建代码生效；与现状冲突处以文档为准。 回滚方式：git revert 本提交。	2026-11-02 15:09:51 +08:00