知习 ZhiXi 文档中心
所有技术设计和项目规划文档的总索引。
目录结构
├── 技术设计/ 系统怎么建（按项目分文件夹）
├── 开发计划/ 先做什么后做什么（按项目分文件夹）
├── 长期规划/ 为什么做、给谁做
├── 凭据配置/ 服务器密码和密钥（已 gitignore）
└── 图片资源/ 产品图片
状态标识说明
| 前缀 |
含义 |
适用场景 |
[已完成] |
设计已落实到代码，功能可运行 |
技术设计文档 |
[进行中] |
部分实现/持续更新中 |
技术设计 + 开发计划 |
[设计中] |
纯设计文档，尚未开始实现 |
技术设计文档 |
[参考] |
静态参考文档，内容不再变动 |
需求基线等 |
[快照] |
一次性审计快照，记录某个时间点的状态 |
差距分析等 |
技术设计
api-server（后端）
| 文档 |
说明 |
| 进行中-架构总览 |
模块化单体架构、技术栈、目录结构、14个业务模块、API路由规划、数据模型（模块骨架存在，队列/AI异步未完成） |
| 进行中-Redis缓存设计 |
缓存/队列/限流设计，Redis 已连接，BullMQ 队列待替换内存队列 |
| 设计中-AI架构设计 |
AI Provider 抽象、四层模型策略、Agent 演进路线 V0-V3 |
已完成
| 文档 |
说明 |
| 数据库设计 |
27 张表完整设计，Prisma schema 已落地，MySQL 运行中 |
| 安全规范 |
安全基线：Helmet、CORS、JWT Guard、参数校验、限流、Swagger保护 |
| 登录流程-总览 |
登录系统整体设计：前后端职责、Token 策略、5 个 API 接口规划 |
| 登录流程-Apple登录集成 |
Sign in with Apple 后端实现：jose 验签、JWKS、字段信任模型 |
| 登录流程-后端接口 |
dev-login / refresh / logout / /users/me 四个接口的详细实现 |
| 登录流程-数据库设计 |
users / auth_accounts / refresh_tokens 三表 Prisma Schema |
ios-projects（iOS 客户端）
| 文档 |
说明 |
| 进行中-架构设计 |
当前项目文件结构、导航架构、与计划架构的差异表（28项未实现），UI 层完成但无 MVVM |
| 设计中-登录集成 |
iOS 端登录设计：AuthService、Keychain 存储、Token 自动刷新、401 重试，均未实现 |
| 样式规范 |
完整设计系统：颜色、渐变、圆角、间距、字体、29 个共享组件、页面模板 |
| 页面规划 |
22 个页面完整清单，UI 层全部实现（Onboarding 5页 + 主Tab 5页 + 子页12页） |
web-projects（官网）
| 文档 |
说明 |
| 设计中-设计文档 |
官网视觉设计系统："Luminous Clarity" 玻璃拟态浅色主题 |
miniapp-projects（微信小程序）
暂无文档，预留目录。
harmonyos-projects（鸿蒙）
暂无文档，预留目录。
admin-projects（后台管理）
暂无文档，预留目录。
android-projects / webApp-projects
暂无文档，预留目录。
开发计划
跨项目
| 文档 |
说明 |
| 进行中-阶段路线图 |
产品 9 阶段整体路线。阶段0官网部分已完成，阶段1方向选择进行中 |
| 进行中-潜在问题清单 |
代码和策略中已发现问题，按🔴严重/🟠高危/🟡中危分级，持续更新（最新：2026-05-15） |
api-server
| 文档 |
说明 |
| 进行中-后端开发优先级 |
51 模块 14 层级总表 + 8 阶段开发路线 + 每个模块接口/表结构/流程详案 |
ios-projects
web-projects / android-projects / webApp-projects
暂无开发计划文档，预留目录。
长期规划
产品方向
商业化
营销与增长
运营与客服
合规与数据
快速定位
