WangDL
5c3f493071
- 删除旧版 v0.1 规划，只保留完全版 - 更新全部 7 大模块文档，补充具体决策和实操内容 - 新增 AI架构设计、营销冷启动调研方案、客服设计详案等子文档 - 新增 潜在问题清单（56项技术+方向问题） - 整理图片到 images/ 目录
69 lines
2.0 KiB
Markdown
69 lines
2.0 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架构设计](./AI架构设计.md)
|
||
|
||
核心原则：从"业务分级工作流"开始，暂不做完全自治 Agent。后期通过用户学习画像、长期记忆和受控 Skill 系统逐步演进。
|
||
|
||
模型按任务分级：轻任务用便宜模型，核心分析用主力模型，复杂推理用强模型。
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
- [阶段路线图](../0-阶段路线图/阶段路线图.md)
|
||
- [产品与用户模块](../1-产品与用户模块/产品与用户模块.md)
|
||
- [AI架构设计](./AI架构设计.md)
|