模块 8 · 运维与结构

Service-based 单体
运维才显现的债

本书的 microservices 不是目标——我们是模块化单体 + 清晰 Agent 边界（像 service-based：少量服务域 + 共享 Agent 库）。 Connascence：改 02-mysql-agent专用.sql 可能牵动风控+问数。

四块映射（共用模块）

鉴权 deps ∥ gateway

决策：一套 JWT；模块禁止 import gateway。Fitness：auth pytest。

平台 API

决策：与 Agent 重复时 platform 为准。Dashboard 每次打 MySQL（性能 trade-off）。

顾问 Agent

未完整接入：无独立深编排 · T-20 未做 · Chat 骨架在 · 答辩勿作主 Demo。

前端 web/

决策：四角色路由；TODO 路由守卫。Vitest 22；E2E 未进库。

运维 checklist（演示 ≠ 产品）

①

Redis 6380 · uvicorn 含 close-all · 前端强刷

②

GET /api/ready + DevReadyBanner

③

手跑 escalation_scan / rebuild_alerts（无 UI）

④

Architecture vitality：CHAT/E2E 未跑项见 TODO

「清空会话无效」最常先查？

结业句： 指挥 AI 时带四问——不变量？阀门？fitness？ADR 里 why 写了吗？