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 运行。
20 lines
920 B
Markdown
20 lines
920 B
Markdown
---
|
||
paths: ["backend/**", "agent/**", "frontend/**"]
|
||
---
|
||
|
||
# 可观测性
|
||
|
||
> 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`）
|