fix: preserve phase documentation in integration branch

README.md

@@ -106,4 +106,34 @@ Vite 通常使用 http://localhost:5173。
 
 前端包括问答、知识库管理、来源与更新、实验评估四个页面。实验评估页面没有虚构数据；所有页面明确标记当前功能状态。
 
-注意：当前 API 尚未接入 Embedding、RAG、网络搜索或后台更新任务；本地 Embedding 评估工具单独见下方。管理接口已有认证与角色校验，审核表单核验人仍是人工输入字段。服务保持仅本机访问，完整生产部署及前端登录联调尚未验收。`.env` 不要提交到 Git。
+注意：当前 API 尚未接入 Embedding、RAG、网络搜索或后台更新任务；本地评估工具见下方。管理接口已有认证与角色校验；审核表单的核验人仍是人工输入字段。服务保持仅本机访问，完整生产部署及前端登录联调尚未验收。`.env` 不要提交到 Git。
+
+### 后端测试和迁移回滚
+
+在 `backend` 目录安装 `requirements-dev.txt` 后执行：
+```bash
+ruff check .
+ruff format --check .
+pytest -q
+```
+
+测试需要真实 PostgreSQL + pgvector：设置 `TEST_DATABASE_URL`（`postgresql+psycopg://...`），或另行 `pip install pgserver` 使用可选的本机临时实例。`pgserver` 仅用于测试，不是应用运行依赖；外部测试数据库账号需有建 Schema 权限且已启用 vector 扩展。每个测试使用独立 Schema，不会清空业务表。测试使用的占位正文和审核人不代表真实资料。
+
+迁移命令为 `alembic upgrade head`，可重复执行。仅撤回切分/索引版本时，备份后执行 `alembic downgrade 0004_auth_sessions`，保留账号、会话、知识和检索记录。继续撤回认证时，备份后执行 `alembic downgrade 0003_retrieval_runs`，删除用户/会话/预算表，保留知识和检索历史。继续执行 `alembic downgrade 0002_catalog` 还会删除检索历史。需要撤回阶段 2 时，先备份，再执行 `alembic downgrade 0001_baseline`；它保留基础知识字段，但会删除新增来源、文档、审核字段与所有历史记录，软删除的基础条目也会重新可见。降级须配合对应旧版后端，当前应用会拒绝旧 Schema。恢复完整数据应使用备份。不要在有业务数据的数据库执行 `downgrade base`。
+
+## 团队协作文档
+
+- [项目章程](docs/PROJECT_CHARTER.md)
+- [开发计划](docs/DEVELOPMENT_PLAN.md)
+- [阶段 1 详细开发计划](docs/PHASE_1_DEVELOPMENT_PLAN.md)
+- [共同开发规范](docs/CONTRIBUTING.md)
+- [系统架构](docs/ARCHITECTURE.md)
+- [任务分工](docs/TASKS.md)
+- [三人团队工作计划](docs/TEAM_WORKPLAN.md)
+- [技术决策](docs/DECISIONS.md)
+
+目标 Gitea 仓库：`https://gitea.kronecker.cc/saint/border-red-post-nalati`。
+
+## 本地 Embedding 评估（可选）
+
+已提供独立 CPU 评估工具、固定版本 BGE Provider 和合成测试集。安装、实际资源/编码结果、指标定义及局限见 [本地模型评估](docs/LOCAL_EMBEDDING_EVALUATION.md)。模型包与缓存不属于默认 FastAPI 运行依赖；当前评估不改变正式 API 或写入业务数据库。