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 运行。
1.3 KiB
1.3 KiB
paths
| paths | ||
|---|---|---|
|
数据生命周期与清理
工作目录 TTL + 磁盘预算 + 日志轮转 + DB 保留。不允许无界增长。
工作目录和日志会无限堆积，必须有清理策略，不允许无界增长。
| 数据 | 保留策略 | 执行方 |
|---|---|---|
{WORK_DIR}/{uuid}/（会话产出的中间/结果文件） |
TTL 默认 24h；总磁盘超阈值（默认 5GB）按 LRU 清理 | Agent 后台定时任务（每小时扫一次） |
| SQLite 会话记录 | 保留 30 天，过期软删除→定期硬删 | Backend 定时任务 |
| 日志文件 | loguru rotation="100 MB" + retention="14 days" + compression="zip" |
各服务 logging 配置 |
- 清理任务幂等、可重入；删除前校验路径在 workDir 内（防穿越）
- 配置项：
SESSION_TTL_HOURS、MAX_DISK_GB、DB_RETENTION_DAYS、LOG_RETENTION_DAYS - 会话结束（done/error）后，临时中间文件可立即清理，仅保留最终结果文件
数据存储概览（示范）
| 层 | 存储 | 内容 |
|---|---|---|
| Backend | SQLite（{WORK_DIR}/app.db） |
会话记录（id、状态、时间戳等） |
| Agent | 文件系统（{WORK_DIR}/{session_id}/） |
会话产出的中间文件与最终结果 |
| Frontend | localStorage | 客户端本地配置（如第三方 API Key） |