docs: 更新 wiki + CLAUDE.md — 三端架构和管理端集成
Some checks failed
Main Merge / backend (push) Has been cancelled
Main Merge / frontend (push) Has been cancelled

- wiki/index.md: 更新关键数字、三端架构图、启动命令、症状导航
- wiki/architecture.md: 补充三端架构、来源追溯、活跃问题更新
- wiki/admin-web.md: 新建管理端文档 — 结构/API代理/功能映射/品牌定制清单
- CLAUDE.md: 补充 apps/web 目录、管理端场景化指令、三端启动命令
This commit is contained in:
iven
2026-06-02 10:11:03 +08:00
parent 8111471e93
commit 0a9e5b1cb3
4 changed files with 251 additions and 47 deletions

View File

@@ -1,8 +1,8 @@
---
title: 架构决策
updated: 2026-06-01
updated: 2026-06-02
status: active
tags: [architecture, base, multi-tenant, security]
tags: [architecture, base, multi-tenant, security, three-tier]
---
# 架构决策
@@ -48,9 +48,35 @@ Android + iOS 跨平台首发。CustomPainter + Listener 手写性能满足 <16m
```
HMS (G:\hms) [只读]
└─复制→ base.git (https://git.stableeasy.com/iven/base.git)
└─克隆→ nj.git (暖记 = 基座 + erp-diary + Flutter)
└─克隆→ nj.git (暖记 = 基座 + erp-diary + Flutter + 管理端)
```
### 三端架构
```
nj/
├── crates/ # 后端 (Rust Axum, :3000)
│ ├── erp-server/ # 入口 + diary feature flag
│ └── erp-diary/ # 暖记业务模块
├── apps/
│ └── web/ # 管理端 (React + Ant Design, :5174)
│ └── vite.config.ts # proxy /api → :3000
├── app/ # 学生端 (Flutter, :8080)
│ └── lib/features/ # 16 功能模块
├── scripts/dev.sh # 统一启动脚本 (自动清理端口)
└── config/default.toml # 环境配置 (CORS=*)
```
### 来源追溯
| 组件 | 来源 | 说明 |
|------|------|------|
| crates/erp-* (基座 6 个) | base.git | 零开发 |
| crates/erp-diary | 新增 | ~5100 行 Rust |
| apps/web/ | HMS apps/web/ | React 管理面板复用 |
| app/ (Flutter) | 新增 | ~19500 行 Dart |
| scripts/dev.sh | 新增 | 三端统一启动 |
### Cargo Workspace
```
@@ -104,12 +130,13 @@ nj/crates/
| 问题 | 级别 | 状态 | 说明 |
|------|------|------|------|
| Feature Flag 未实现 | HIGH | 待做 | erp-server/Cargo.toml 无 `[features]` 段,所有模块无条件编译 |
| Docker 部署未验证 | HIGH | 待做 | docker/ 配置完善但 Dockerfile 不存在,未实际运行 |
| 管理端品牌仍是 HMS | HIGH | 待做 | 标题/Logo/颜色需替换为暖记品牌 |
| 管理端缺少暖记专用页面 | HIGH | 待做 | 班级管理/日记审核/贴纸管理等页面待添加 |
| Docker 部署未验证 | HIGH | 待做 | docker/ 配置完善但 Dockerfile 不存在 |
| 上下文窗口耗尽 | MEDIUM | 已缓解 | CLAUDE.md §8 会话交接机制 |
| Windows Defender 锁定 exe | MEDIUM | 需手动 | 排除 target/ 目录 |
| erp-plugin 超大文件 | LOW | 待重构 | manifest.rs (1809行) + data_service.rs (1907行) 超过 800 行限制 |
| erp-message module.rs 过大 | LOW | 待重构 | 1283 行,事件监听逻辑可拆分 |
| erp-plugin 超大文件 | LOW | 待重构 | manifest.rs 1809行 + data_service.rs 1907行 |
| Dashboard 部分数据加载失败 | LOW | 待 | 统计 API 需适配暖记数据模型 |
### 历史教训
@@ -121,5 +148,6 @@ nj/crates/
| 日期 | 变更 |
|------|------|
| 2026-06-02 | 补充三端架构、管理端复用说明、更新活跃问题 |
| 2026-06-01 | 补充 Feature Flag 状态、超大文件发现 |
| 2026-06-01 | 初始创建 — 架构决策、基座剥离记录、集成契约 |