wangdl/startup-plan
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
startup-plan/技术设计/api-server/进行中.md
WangDL 23a6999b56 docs: 推送所有未提交的文档更新 
- 5/19-5/20 工作日志
- 后端实现状态更新
- 服务器部署方案更新
- 知识库设计更新
- 进行中文档更新
- 执行计划与任务清单更新

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-20 18:10:44 +08:00

3.3 KiB
Raw Blame History

后端 — 进行中

更新时间：2026-05-20 14:00 关联：总待完成清单

✅ 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 待补）

已完成：

  • DeepSeek Key 已配置（8核32G + .env）
  • 硅基流动 Key 已配置（bge-m3 embedding + 其他模型）
  • RAG Worker 代码已部署到 /opt/zhixi/backend/rag-worker/
  • 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 待验证） 决策：🔵 需架构设计

已完成：

  • COS 凭据已配置到 8核32G 环境变量（SECRET_ID/SECRET_KEY/BUCKET/REGION/DOMAIN）
  • knowledge-source 模块已完成（资料来源 CRUD + DocumentImport 自动生成）
  • import-candidate 模块已完成（候选知识点 + KnowledgeItem 自动生成）
  • 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 完善 ✅ 已完成

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

已完成：

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

⚪ 远期（暂不启动）

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