docs: 更新 wiki + CLAUDE.md — 三端架构和管理端集成

- wiki/index.md: 更新关键数字、三端架构图、启动命令、症状导航
- wiki/architecture.md: 补充三端架构、来源追溯、活跃问题更新
- wiki/admin-web.md: 新建管理端文档 — 结构/API代理/功能映射/品牌定制清单
- CLAUDE.md: 补充 apps/web 目录、管理端场景化指令、三端启动命令

CLAUDE.md

@@ -36,8 +36,13 @@ nj/ (一个仓库)
 │       ├── src/service/       # ~12 Service
 │       ├── src/handler/       # ~10 Handler
 │       └── src/{dto,error,event,state}.rs
-├── app/                       # Flutter 前端
-├── config/                    # 服务器配置
+├── apps/                      # 🆕 管理端前端 (从 HMS 基座复用)
+│   └── web/                   # React + Ant Design + Vite (:5174)
+│       ├── src/pages/         # 管理页面 (用户/角色/权限/审计...)
+│       └── vite.config.ts     # API 代理 → localhost:3000
+├── app/                       # Flutter 学生端 (:8080)
+├── scripts/dev.sh             # 🆕 统一启动脚本 (自动清理端口)
+├── config/                    # 服务器配置 (CORS=*)
 ├── docker/                    # Docker Compose (PG + Redis)
 ├── docs/                      # 产品文档
 │   └── superpowers/specs/     # 设计规格 v1.2
@@ -62,6 +67,7 @@ nj/ (一个仓库)
 | BPMN 工作流 | erp-workflow 继承 | 零开发 |
 | SeaORM 迁移框架 | erp-server 继承 | 零开发 |
 | OpenAPI 文档 | utoipa 继承 | 零开发 |
+| 管理端 Web 前端 | HMS apps/web/ 复用 | 零开发 (品牌替换待做) |
 | student/teacher/parent 角色 | erp-auth 扩展 | 🆕 ~200 行 |
 | 班级码认证 | erp-auth 扩展 | 🆕 ~500 行 |
 | 日记 CRUD + 同步 | erp-diary 新增 | 🆕 ~2000 行 |
@@ -321,9 +327,12 @@ chore(docker): 添加 PostgreSQL 16 + Redis 7 开发环境
 - 当遇到**新增数据表** → 创建 SeaORM migration + Entity，包含所有标准字段
 - 当遇到**跨模块通信** → 定义事件类型到 erp-diary/src/event.rs，通过 EventBus 发布
 - 当遇到**新增 Flutter 功能** → 创建 features/{name}/ 目录，bloc/views/widgets 分层
+- 当遇到**管理端修改** → 在 apps/web/ 中修改 React 组件，`pnpm dev` 启动开发服务器
+- 当遇到**管理端新增页面** → 在 apps/web/src/pages/ 添加，更新 routeConfig.ts + 侧边栏菜单
 - 当遇到**手写性能问题** → 检查 shouldRepaint 守卫 + 笔画光栅化缓存 + Listener 替代 GestureDetector
 - 当遇到**同步冲突** → 版本号比对，Phase 1 使用"本地优先"简单策略
 - 当遇到**儿童数据** → 确认 PIPL 合规检查清单（家长授权/最小数据/加密/注销机制）
+- 当遇到**启动端口占用** → `./scripts/dev.sh stop` 清理所有旧进程
 
 ---
 
@@ -419,6 +428,7 @@ chore(docker): 添加 PostgreSQL 16 + Redis 7 开发环境
 | 手写引擎 | `wiki/handwriting-engine.md` — 双层 Canvas + 光栅化缓存 |
 | 数据层 | `wiki/data-layer.md` — Isar + SyncEngine 离线同步 |
 | Flutter 前端 | `wiki/frontend.md` — 16 模块 + BLoC + 设计系统 |
+| 管理端前端 | `wiki/admin-web.md` — React + Ant Design + 品牌定制清单 |
 | 后端模块 | `wiki/erp-diary.md` — Entity/Service/Handler 清单 |
 | 技术债看板 | `docs/tech-debt-board.md` — 10 条待偿还债务 |
 | 产品设计规格 v1.2 | `docs/superpowers/specs/2026-05-31-nuanji-warm-notes-design.md` |
@@ -431,6 +441,35 @@ chore(docker): 添加 PostgreSQL 16 + Redis 7 开发环境
 
 ## 10. 开发环境
 
+### 三端启动
+
+```bash
+# 一键启动全部 (后端 + 管理端 + 学生端)
+./scripts/dev.sh
+
+# 单独启动
+./scripts/dev.sh backend    # Rust Axum → :3000
+./scripts/dev.sh admin      # React Vite → :5174
+./scripts/dev.sh app        # Flutter Web → :8080
+
+# 停止所有 (自动清理端口)
+./scripts/dev.sh stop
+```
+
+管理端默认账号: `admin / admin123`
+
+### 环境依赖
+
+| 服务 | 地址 | 说明 |
+|------|------|------|
+| PostgreSQL 16 | localhost:5432 | 数据库 `nuanji` |
+| Redis 7 | localhost:6379 | 缓存/速率限制 |
+| Flutter SDK | D:\flutter\bin\flutter.bat | 学生端 |
+| Node.js + pnpm | - | 管理端 |
+| Rust toolchain | stable | 后端 |
+
+### 参考文档
+
 | 文档 | 位置 |
 |------|------|
 | 产品设计规格 v1.2 | `docs/superpowers/specs/2026-05-31-nuanji-warm-notes-design.md` |