完善文档

docs/data/README.md

@@ -0,0 +1,3 @@
+# Data
+
+数据层文档目录。

docs/data/database.md

@@ -0,0 +1,18 @@
+# PostgreSQL
+
+PostgreSQL 是主关系数据库。
+
+负责：
+
+- 业务数据
+- 用户
+- Session
+- Run
+- Task
+- 长期记忆
+- 审计
+- 元数据
+
+SQLAlchemy 2.0 + Alembic。
+
+数据库 Schema 是持久化契约，重大变化必须通过 migration。

docs/data/file-storage.md

@@ -0,0 +1,11 @@
+# FileStorage
+
+定义统一 `FileStorage` 接口。
+
+实现：
+
+- Local File System
+- MinIO
+- S3 / OSS / COS
+
+业务代码不得直接拼接具体对象存储 SDK。

docs/data/graph-store.md

@@ -0,0 +1,10 @@
+# GraphStore
+
+定义统一 `GraphStore` 接口。
+
+实现：
+
+- Neo4j：开发 / 测试
+- NebulaGraph：大规模生产
+
+主要用于知识图谱、实体关系、复杂多跳关系。

docs/data/redis.md

@@ -0,0 +1,13 @@
+# Redis
+
+Redis 负责高频、短生命周期数据：
+
+- Cache
+- Working Memory
+- Session State
+- Task Runtime State
+- Rate Limit
+- Distributed Lock
+- Event Buffer
+
+Redis 数据默认不作为核心业务数据唯一来源。

docs/data/vector-store.md

@@ -0,0 +1,11 @@
+# VectorStore
+
+定义统一 `VectorStore` 接口。
+
+实现：
+
+- ChromaDB：开发
+- PostgreSQL + pgvector：中小规模生产
+- Milvus：大规模生产
+
+上层 Memory 与 RAG 不依赖具体实现。