docs: 更新 wiki + CLAUDE.md — 三端架构和管理端集成
- wiki/index.md: 更新关键数字、三端架构图、启动命令、症状导航 - wiki/architecture.md: 补充三端架构、来源追溯、活跃问题更新 - wiki/admin-web.md: 新建管理端文档 — 结构/API代理/功能映射/品牌定制清单 - CLAUDE.md: 补充 apps/web 目录、管理端场景化指令、三端启动命令
This commit is contained in:
@@ -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 | 初始创建 — 架构决策、基座剥离记录、集成契约 |
|
||||
|
||||
Reference in New Issue
Block a user