baozaotumao
df48c36422
把规则从原 ppt-gen 项目泛化为通用脚手架，覆盖 19 个文件： - ddd/architecture/design-discipline/error-codes/communication-* 等： 领域术语、错误码、消息示例、扩展点、状态流统一为「订单」示范域 - agent-dag/agent.md/agent-concurrency/agent-llm-*：DAG 节点、配置、并发、 LLM 适配从「对话→预览→生成→截图→合成」改为「intake→process→validate→finalize」 - backend-db：Session 实体/状态机/ORM/仓储/checkpoint 对齐新流水线 - 移除幻灯片专属依赖与产物：agent 去 playwright/python-pptx， Dockerfile 去 Chromium 系统库，.gitignore 去 *.pptx - 保留合法通用项：ANSI（PTY 处理）、Playwright（E2E 测试工具）、Gemini CLI（真实 provider） 验证：gemini-cli/openai-api 两变体生成退出 0，生成项目零 PPT 残留， backend/agent 骨架均可 import 运行。
920 B
920 B
paths
| paths | |||
|---|---|---|---|
|
可观测性
correlation_id 全链路 + 结构化日志 + 健康探针。
- correlation_id 贯穿全链路：前端生成 → WS header/首帧带上 → Backend（作 request_id）→ Agent（随 session_id 一起进日志）。三层日志可用同一 id 串联检索。
- 结构化日志：JSON 每行一条（见各服务 logging 章节）
| 层 | 文件 | 格式 |
|---|---|---|
| Backend | {WORK_DIR}/logs/backend.log |
JSON，每行一条，含 request_id |
| Agent | {WORK_DIR}/logs/agent.log |
JSON，每行一条，含 session_id |
| Frontend | console（dev）/ 可接 Sentry（prod） | 结构化对象 |
- 探针：每个服务暴露
GET /health（存活）与GET /ready（依赖就绪，如 Agent 检查外部依赖可用） - 禁止
print()/console.log()，统一用各层 logger（见conventions.md）