79 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 技术与交付模块
## 模块目标
确定技术栈、开发流程、交付节奏和质量标准。
---
## 技术选型(已决策)
| 层级 | 选型 | 说明 |
|------|------|------|
| 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 系统逐步演进。
模型按任务分级:轻任务用便宜模型,核心分析用主力模型,复杂推理用强模型。
---
## 后端开发路线
> 详见:[后端开发优先级](./后端开发优先级.md) / [后端完全体优先级详案](./后端完全体优先级详案.md)
核心开发顺序:**身份权限 → 知识系统 → 学习闭环 → AI 基础设施 → 文件导入 → 商业化 → 后台 → 客服 → 学习画像 → 公开分享 → 增长归因**
---
## 相关文档
- [阶段路线图](../0-阶段路线图/阶段路线图.md)
- [产品与用户模块](../1-产品与用户模块/产品与用户模块.md)
- [AI架构设计](./AI架构设计.md)
- [后端开发优先级](./后端开发优先级.md)
- [后端完全体优先级详案](./后端完全体优先级详案.md)