diff --git a/README.md b/README.md index 4c4a42a..da6f708 100644 --- a/README.md +++ b/README.md @@ -89,8 +89,7 @@ Agent/ │ ├── src/rbac/ # 角色权限 │ ├── src/import/ upload/ # 数据导入(batch_uuid 幂等防重) │ ├── src/precompute/ # 业务预计算(AI 不算账,业务系统算好) -│ ├── src/export/ # 报表导出工作队列 -│ └── README.md # 中台引擎详细说明 +│ └── src/export/ # 报表导出工作队列 │ ├── packages/shared/ # 中台公共包(模块注册表 / 常量 / 备份表定义) │ @@ -208,7 +207,7 @@ OLLAMA_ORIGINS=http://localhost:8090 ollama serve ### 可选:启动中台引擎(L2,:8088) -仓库已含 L2 中台引擎源码(`server/`,运行说明见 `server/README.md`): +仓库已含 L2 中台引擎源码(`server/`): ```bash cd server diff --git a/server/README.md b/server/README.md deleted file mode 100644 index db2b471..0000000 --- a/server/README.md +++ /dev/null @@ -1,40 +0,0 @@ -# 中台引擎(L2 · :8088) - -城轨智能中台四层架构中的 **L2 中台层**,Express API 服务,**仅绑定 127.0.0.1 本机回环**(`src/main.js:20`)。中台只解决"接入"与"安全",业务能力在各子系统内部实现——本目录不含任何业务子系统代码。 - -## 架构位置 - -``` -L1 AI 客户端(:8090) - ↓ -L2 中台引擎 = 本目录(:8088,仅 127.0.0.1) - ↓ MCP 路由 -L3 子系统 MCP Server(:7777 排班 / :7778 画像,见 scripts/mcp-server-sdk.js) - ↓ dispatcher -L4 业务工具层(子系统内部,2496 个既有业务函数,零侵入) -``` - -## 核心模块 - -| 模块 | 位置 | 说明 | -| --- | --- | --- | -| 服务入口 | `src/main.js` | 127.0.0.1 监听、路由装配 | -| JWT Ed25519 鉴权 | `src/auth/` | `signEdDsa`/`verifyEdDsa`(jwt-ed25519.js),密钥强制 ed25519(jwt-keys.js) | -| 审计·链式哈希 | `src/audit/` | 每条日志承接上一条 SHA-256,篡改任一条整链断裂(audit.js:45,58,90-94) | -| RBAC 权限 | `src/rbac/` | 角色权限缓存与校验 | -| 数据导入 | `src/import/` `src/upload/` | 月度材料/月考/人员名册导入;batch_uuid 防重、同月重复上传即覆盖(§5.1 幂等) | -| 预计算 | `src/precompute/` | 乘务指标预计算——AI 不算账,业务系统算好 | -| 导出 | `src/export/` | 报表导出工作队列 | -| 公共包 | `../packages/shared/` | 模块注册表、常量、备份表定义 | - -## 运行 - -```bash -cp .env.example .env # 按需修改(开发占位值,生产密钥走本地密钥目录) -npm install -npm start # node src/main.js -``` - -## 密钥说明 - -JWT Ed25519 密钥对由 `scripts/generate-jwt-keys.js` 在本地生成,存放于本地密钥目录(`keys/` 已被 .gitignore 排除,**任何情况下不入库**);PII 字段加密密钥(DATA_ENC_KEY / DATA_HMAC_KEY)同理,生产环境由密钥目录管理。