# 后端 — 进行中

> 更新时间：2026-05-20 14:00
> 关联：[总待完成清单](../总待完成清单.md)

---

## ✅ 5/20 已完成

- **CI/CD: api-server deploy pipeline** — `/home/ubuntu/api-server/.gitea/workflows/deploy.yml` 已配置，gitea-runner 正常运行，zhixi-api Docker 容器自动构建部署
- **CI/CD: web-projects deploy pipeline** — `/tmp/web-projects/.gitea/workflows/deploy.yml` 已配置，今日 13:38 部署成功，`/var/www/longde.cloud/`
- **rag-worker 代码部署到 8核32G** — 10 个文件 + .env 已就位，API 密钥已配置
- **gitea-runner-web** — 单一 `gitea-runner` 服务同时处理 api-server + web-projects 两端 CI/CD，无需独立 runner

---

## 🟠 B11 — AI 联调 + Prompt 调优

**状态**：进行中（rag-worker 代码已部署，systemd 待补）

**已完成**：
- [x] DeepSeek Key 已配置（8核32G + .env）
- [x] 硅基流动 Key 已配置（bge-m3 embedding + 其他模型）
- [x] RAG Worker 代码已部署到 `/opt/zhixi/backend/rag-worker/`
- [x] RAG Worker .env 配置完整

**待完成**：
- [ ] 补全 Python 依赖（缺 pydantic/python-docx/markdown/pandas/Pillow/qdrant-client/python-dotenv）
- [ ] 创建 systemd `zhixi-worker` 服务
- [ ] DeepSeek 真实调用测试（通过 rag-worker 端到端）
- [ ] 5 个 Prompt 逐一调优（active-recall / feynman-evaluation / knowledge-import / review-card / learning-trend）
- [ ] 输出格式稳定性验证（Zod schema 通过率）
- [ ] 延迟/成本基准测试

---

## 🔵 B28 — iOS 接口缺口审计

**状态**：待开始
**决策**：🔵 需架构设计

**背景**：用户反馈"iOS 模块逐个修改，有些页面功能不太对，可能涉及到加接口"。

**子任务**：
- [ ] 列出 iOS 全部页面对应的后端 API
- [ ] 逐页检查：字段是否够用、分页是否支持、错误处理是否完善
- [ ] 标记缺口（缺接口 / 缺字段 / 缺错误码）
- [ ] 输出审计报告 → 补充接口清单

---

## 🔵 B29 — 知识库存储架构

**状态**：进行中（COS 凭据已配置，Bucket 待验证）
**决策**：🔵 需架构设计

**已完成**：
- [x] COS 凭据已配置到 8核32G 环境变量（SECRET_ID/SECRET_KEY/BUCKET/REGION/DOMAIN）
- [x] knowledge-source 模块已完成（资料来源 CRUD + DocumentImport 自动生成）
- [x] import-candidate 模块已完成（候选知识点 + KnowledgeItem 自动生成）
- [x] Python parser 已支持 PDF/DOCX/TXT/MD/CSV/XLSX + OCR 预留

**待完成**：
- [ ] 验证 COS Bucket（zhixi-1259685406）已创建且可访问
- [ ] 百度 OCR 开通
- [ ] COS 目录路径规范设计（user-uploads / knowledge-assets / exports）
- [ ] 与 KnowledgeImportWorkflow 的对接方案
- [ ] 大文件分片上传方案

---

## 🆕 B30 — CI/CD Pipeline 完善 ✅ 已完成

**状态**：两端均已配置并验证通过

**已完成**：
- [x] 8核32G: gitea-runner systemd 自启
- [x] 4核4G: gitea-runner systemd 自启（单一 runner 覆盖两端）
- [x] api-server deploy.yml ✅
- [x] web-projects deploy.yml ✅（今日 13:38 部署成功）
- [x] Astro 构建 → Nginx 部署 → 后端健康检查全流程验证

---

## ⚪ 远期（暂不启动）

- B23: Plans + Membership + Subscription（🔴 需先定定价）
- B24: Admin 后台（🟢）
- B25: SupportTicket + Dify + HelpCenter（🟢）
- B26: AIQuota / UsageLimit（🔵）