首次验收
在 本地搭建 完成后，用下面清单做一次冒烟。基准应用：完整 demo（apps/nextkity，端口 3000）。
建议账号
- 若已执行
pnpm db:seed:init：使用.env中SUPER_ADMIN_EMAIL/SUPER_ADMIN_PASSWORD - 或自行注册普通用户后再用管理员账号测 Admin（视你的种子数据而定）
清单
| # | 检查项 | 期望 |
|---|---|---|
| 1 | 打开 http://localhost:3000/zh（或默认 locale 首页） | 页面可加载，无白屏 |
| 2 | 注册 / 登录 | 能进入登录态；刷新后 Session 仍在 |
| 3 | 打开 /zh/admin | 进入 Admin；侧栏可见 全量 菜单（含文章管理等） |
| 4 | Admin 顶栏语言切换 | 切换后停留在对应 locale 的同一逻辑路径 |
| 5 | /zh/admin/orders（或侧栏「订单」） | 列表页可打开（可无数据） |
| 6 | /zh/admin/products | 列表页可打开 |
| 7 | /zh/docs | 若本机 demo 已同步开发文档则可见；否则可暂时 404 / 旧文，不阻塞产品验收 |
| 8 | 退出登录后再访问 /zh/admin | 被拦回登录或未授权页 |
常见异常（快速指向）
| 现象 | 先查 |
|---|---|
| 登录后死转圈 / User not found | Cookie 前缀与端口、多 app 串 Session → docs/platform/monorepo/local-ports-and-auth-cookies.md |
| Admin 404 或菜单空洞 | 是否走错 app / locale；FEATURE_MODULES 是否含 admin |
| 数据库错误 | DATABASE_URL、是否已 db:migrate |
| 支付页异常 | 本地是否应开 Mock；ENABLED_PAYMENT_METHODS |
更完整的排查章节待后续补充。
通过后
你可以开始改壳与常用域。建议下一站（待文档补齐）：
- Configuration：环境变量、
FEATURE_MODULES、品牌 - Customize：加页面、Admin 菜单、i18n
当前若只需改文档本身：编辑 apps/nextkity-saas/content/docs，不要在未约定的情况下改 nextkity 文档副本。