docs(project): 更新迁移数量与工程质量验收

README.md

@@ -4,7 +4,7 @@
 
 ## 当前状态
 
-**Phase 0 已完成，Phase 1 基础切片已完成。** 后端已复制并跑通空库迁移、构建、健康检查与全量测试；前端已完成 SVG 品牌资产、用户首页/登录/商品列表、移动端 `/m` 首页/详情/个人中心、管理员验证码登录、强制改密、浅色后台 Shell 与真实仪表盘。
+**Phase 0–2 已完成，当前进入工程质量收口阶段。** 后端已复制并跑通空库迁移、构建、健康检查与全量测试；前端已完成 PC / 移动端 / 后台三端页面迁移，并接入 ESLint、Prettier、Vitest 与统一 `scripts/check.sh` 门禁。支付、短信、实名仍使用 mock，等待真实渠道凭据。
 
 - 前端：`http://localhost:5289/`
 - 移动端：`http://localhost:5289/m`
@@ -37,7 +37,7 @@ cd frontend && npm install && npm run dev
 - 主域名：`zuhaoc.com`
 - 管理后台：环境变量 `VITE_ADMIN_BASE_PATH`，默认 `/console-jy8k3m`
 - 分销后台：`distribution.zuhaoc.com`（沿用现有 React + AntD 应用，仅做品牌轻改）
-- 数据库：全新数据库 `hfb_jysh`，保留全部 89 个迁移
+- 数据库：全新数据库 `hfb_jysh`，保留全部 90 个迁移
 - 支付 / 短信 / 实名：先留空，开发环境使用 mock
 - Logo：无矢量源文件，按现有 PNG 重绘 SVG
 
@@ -49,12 +49,31 @@ cd frontend && npm install && npm run dev
 - 分销后台：React 19 + Ant Design 5
 - 部署：Caddy + Docker Compose
 
+## 质量门禁
+
+```bash
+# 全量门禁：SQL 约束 + go vet/build/test + 前端格式/lint/类型/测试/构建
+./scripts/check.sh
+
+# 前端单独检查
+cd frontend
+npm run format:check   # Prettier
+npm run lint           # ESLint，--max-warnings=0
+npm run typecheck      # tsc --noEmit
+npm run test           # Vitest
+npm run test:coverage  # Vitest + coverage
+npm run build          # Vite 生产构建
+```
+
+提交前请启用仓库 hooks：`git config core.hooksPath .githooks`。首次推送会由 `pre-push` 自动执行 `scripts/check.sh`（可用 `SKIP_CHECKS=1` 临时跳过，不推荐）。
+
 ## 文档
 
 - [项目实施计划](docs/项目计划.md)
 - [品牌与 UI 规范](docs/品牌与UI规范.md)
 - [Phase 0 验收报告](docs/Phase0-验收报告.md)
 - [Phase 1 验收报告](docs/Phase1-验收报告.md)
+- [工程质量门禁与优化验收](docs/Phase3-工程质量门禁验收.md)
 - [后端数据库设计](docs/backend/database.md)
 - [后端业务规则](docs/backend/business-rules.md)