WangDL
fe608da385
- 文档从扁平结构迁移至分类目录 (api-server/ios-projects/web-projects/长期规划) - 更新总待完成清单 (B1-B6 全部完成, I1-I7 全部完成) - 新增后端实现状态、已实现功能汇总等已完成文档 - 新增 iOS 功能需求清单、架构设计、差距分析等文档 - 清理旧版未维护文档 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
# 技术与交付模块
|
||
|
||
## 模块目标
|
||
|
||
确定技术栈、开发流程、交付节奏和质量标准。
|
||
|
||
---
|
||
|
||
## 技术选型（已决策）
|
||
|
||
| 层级 | 选型 | 说明 |
|
||
|------|------|------|
|
||
| iOS | Swift / SwiftUI | Apple 原生，MVVM + Service + Repository |
|
||
| 后端 | NestJS + TypeScript | 模块化单体架构 |
|
||
| ORM | Prisma | 类型安全，自动生成 TS 类型 |
|
||
| 数据库 | MySQL | 服务器已部署 |
|
||
| 缓存/队列 | Redis + BullMQ | 缓存 + 队列 + 限流 + 临时状态 |
|
||
| AI | Provider 抽象 + Mock + 真实模型 | MiniMax / DeepSeek / OpenAI 等可替换 |
|
||
| 部署 | Docker Compose + Nginx | 4核4G 轻量云，域名 api.longde.cloud |
|
||
| 官网 | Astro | SEO 友好，静态生成 |
|
||
| 后台管理 | Vite + React + Ant Design + ProComponents + TanStack Query | 预留 |
|
||
|
||
---
|
||
|
||
## 前后端协作流程
|
||
|
||
1. 选一个业务流程
|
||
2. 根据流程拆接口
|
||
3. 后端设计表结构、DTO、接口、Swagger
|
||
4. 前端根据 Swagger 写 Model / Service
|
||
5. 前端接页面 → 联调 → 发现问题 → 回头改接口/DTO/表结构
|
||
6. 稳定后再做下一个流程
|
||
|
||
---
|
||
|
||
## iOS 多设备工程策略
|
||
|
||
| 设备 | 策略 |
|
||
|------|------|
|
||
| iPhone + iPad | 同一个 Xcode Project，同一个 iOS App Target |
|
||
| Mac | 单独 Mac 版本 Target |
|
||
| Watch | watchOS Target |
|
||
|
||
---
|
||
|
||
## 第一版技术范围
|
||
|
||
**必须：** iOS 客户端、核心功能、简单后端、AI API 调用、本地数据存储、Apple IAP
|
||
|
||
**暂不做：** 安卓客户端、微信/支付宝支付、复杂后台管理系统、Web 学习端
|
||
|
||
---
|
||
|
||
## AI 架构
|
||
|
||
> 详见：[AI架构设计](../../技术设计/api-server/AI架构设计.md)
|
||
|
||
核心原则：从"业务分级工作流"开始，暂不做完全自治 Agent。后期通过用户学习画像、长期记忆和受控 Skill 系统逐步演进。
|
||
|
||
模型按任务分级：轻任务用便宜模型，核心分析用主力模型，复杂推理用强模型。
|
||
|
||
---
|
||
|
||
## 后端开发路线
|
||
|
||
> 详见：[后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
|
||
|
||
核心开发顺序：**身份权限 → 知识系统 → 学习闭环 → AI 基础设施 → 文件导入 → 商业化 → 后台 → 客服 → 学习画像 → 公开分享 → 增长归因**
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
||
- [产品与用户模块](./[参考]-产品与用户模块.md)
|
||
- [AI架构设计](../../技术设计/api-server/AI架构设计.md)
|
||
- [后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
|