[yilecoding]

改了什么、为什么

参考 ContiNew 的文档站补了我们缺的「怎么用」类内容（叠在 #206 默认中文之上，#206 合并后我把这个 PR 改到 main）：

• 指南「从零加一个业务模块」（中英）：以客户管理为例，模型 → 迁移 → schema / crud / service / api → 菜单权限码 → 前端列表页 → 数据权限 → 测试，每步一个「验收」，末尾「常见卡点」和「相关源码」
• 参考「常见问题」（中英，25 条）：标题用报错原文，方便用户拿报错去搜
• 参考「版本升级」（中英）：镜像部署怎么升、fork 后按 tag 合并上游、出现两个迁移 head 怎么办、兼容承诺、升级前清单
• 快速开始每一步加验收标准；部署页加上线前检查清单
• 修正快速开始和 README 里三处过时说法：pnpm db:init 会强制给 admin 设新密码（不再是 123456）、自增主键模式下初始化直接报错退出、本地要开 127.0.0.1:8888（localhost 一刷新就掉登录）

自查清单

• 教程的步骤在隔离环境（独立库 + 一次性 Redis + 临时 worktree）里真做了一遍：迁移生成 / 升 / 降 / 再升、增删改查接口、本部门数据范围（别部门的行详情和更新 404）、2 条模块测试（各做过变异验证）、pnpm typecheck --force / arch:check / lint / i18n:check 全过；做完已清理
• 未验证的在页面里写明：浏览器里点一遍、MySQL / SQL Server 的种子 SQL（只做了静态检查）
• 文档站两种路径都构建过：34 页、2216 条站内链接 0 断链
• pnpm ctx:check：只剩 main 上就有的 android/ 那条
• 不适用：没动应用代码

🤖 Generated with Claude Code