架构文档

本目录是 retaintive 系统的封面级展示 — 回答"我们做了个什么系统"。给新成员 / 产品 / AI agent 快速建立心智模型。

不是工程实操层。 字段细节 / 隔离设计 / pattern 选型 → 见 系统设计


4 类文档,按需选择

跨层 / 全景

  • 0-system-overview.md — repo / 存储 / 跨 repo 共享 / 环境 回答"系统由哪些 repo / runtime / 存储组成?跨 repo 边界在哪?"

前端

  • 1-frontend.md — Vue 3 SPA / 5 层架构 / 174 页面 / 38 query hook / 部署 回答"前端代码怎么分层?数据怎么从浏览器走到 studio-api 再回来?怎么部署?"

后端

  • 2-backend.md — 后端 Pipeline 全景 / 5 Lambda / 共享写入层 / 7 AI prompt 回答"通话 / 短信 / Lead 进系统后怎么处理?Phase 1 收口到哪一步?7 AI prompt 都在哪?"

Prompt 架构

  • 3-prompt-architecture.md — Prompt / Zod schema / domain registry / LLM call / deterministic guard 职责边界 回答"prompt 里应该写什么?definition 从哪来?final output contract 怎么给 AI?6 份 prompt draft 接入前怎么 review?"

怎么读

  • 新成员 / 不熟悉 retaintive: 从 0-system-overview.md 开始(repo / 存储边界)
  • 改前端代码: 1-frontend.md → Layer 2 五层架构定位代码位置
  • 改后端 Lambda: 2-backend.md → Layer 3a Prompt 全景 + Layer 3b Before-After
  • 改 AI prompt / review prompt draft: 3-prompt-architecture.md → Prompt template + schema audit checklist
  • 不知道某个文档放哪: 工程实操 / 字段细节 → system-design/ ; 全景 / 概念 → 本目录