知习 ZhiXi 文档中心

所有技术设计和项目规划文档的总索引。

---

目录结构

├── 技术设计/      系统设计 + 开发计划（已合并）
├── 长期规划/      为什么做、给谁做
├── 凭据配置/      服务器密码和密钥（已 gitignore）
└── 图片资源/      产品图片

---

技术设计

api-server（后端）

设计与规划：

文档	说明
架构总览	模块化单体架构、技术栈、目录结构、14个业务模块、API路由规划、数据模型
后端开发路线图	51 模块 14 层级总表 + 8 阶段开发路线 + 每个模块接口/表结构/流程详案
后端待完成事项清单	当前待推进的详细任务
AI架构设计	AI Provider 抽象、四层模型策略、Agent 演进路线 V0-V3
Redis缓存设计	缓存/队列/限流设计

已完成：

文档	说明
已实现功能汇总	全部已完成功能一览：基础设施、14 模块、AI 三层架构、安全基线
后端实现状态	各模块完成度 + 基础设施状态 + 待推进方向
数据库设计	27 张表完整设计，Prisma schema 已落地
安全规范	安全基线：Helmet、CORS、JWT Guard、RolesGuard、参数校验、限流
当前状态与决策清单	技术决策与当前状态记录
AI架构决策清单	AI 层具体决策记录
登录流程/总览	登录系统整体设计
登录流程/Apple登录集成	Sign in with Apple 后端实现
登录流程/后端接口	登录相关接口实现
登录流程/数据库设计	登录相关表设计

ios-projects（iOS 客户端）

设计与规划：

文档	说明
架构设计	项目文件结构、导航架构、差异表
登录集成	AuthService、Keychain 存储、Token 刷新
功能需求清单	iOS 功能需求基线
缺失项与待补全方向	架构/页面/功能缺失项梳理

已完成：

文档	说明
已实现功能汇总	全部已完成功能一览：架构层、22 页面、Auth、设计系统、代码质量
样式规范	完整设计系统：颜色、渐变、圆角、间距、字体、29 个共享组件
页面规划	22 个页面完整清单
差距分析	现有资源盘点 + P0 任务分解

跨项目

文档	说明
总待完成清单	← 主文件：后端/iOS/策略所有待完成事项，按优先级排列，链接到各详细文档
阶段路线图	产品 9 阶段整体路线
潜在问题清单	按🔴严重/🟠高危/🟡中危分级，持续更新

web-projects（官网）

文档	说明
设计文档	官网视觉设计系统："Luminous Clarity" 玻璃拟态浅色主题

预留目录

miniapp-projects harmonyos-projects admin-projects android-projects webApp-projects — 暂无文档。

---

长期规划

产品方向

文档	说明
进行中-个人开发者创业计划	整体创业策略：Apple-first、验证优先级、长期架构
参考-产品与用户模块	产品定位、目标用户、核心价值主张
参考-产品方向深度评估	知识库方向选择评估维度和候选方案
参考-技术与交付模块	技术选型决策、开发流程、交付标准

商业化

文档	说明
进行中-商业化与支付模块	订阅定价、Apple IAP、会员权益体系

营销与增长

文档	说明
进行中-营销与增长模块	营销策略总纲
参考-营销冷启动调研方案	冷启动阶段获客调研方案
参考-冷启动与增长深度调研	增长策略深度调研

运营与客服

文档	说明
进行中-运营与客服模块	运营策略总纲
参考-客服设计详案	客服流程和工单系统设计

合规与数据

文档	说明
设计中-数据反馈与迭代模块	数据埋点、用户反馈收集、迭代流程
设计中-合规与公司化模块	公司注册、ICP备案、隐私合规、Apple审核要求

---

快速定位

我想知道...	看这个
现在该做什么？	总待完成清单
后端整体怎么设计？	架构总览
后端完成了哪些功能？	已实现功能汇总
后端实现到什么程度了？	后端实现状态
后端先开发哪些？	后端开发路线图
数据库有哪些表？	数据库设计
登录怎么做？	登录流程/总览
iOS 完成了哪些功能？	已实现功能汇总
iOS App 架构？	iOS架构设计
iOS 还差什么？	缺失项与待补全方向
接下来做什么？	阶段路线图
有哪些已知问题？	潜在问题清单
产品方向怎么定的？	产品方向深度评估
怎么收费？	商业化与支付模块
怎么获客？	营销冷启动调研方案
服务器密码、SSH密钥？	服务器凭据