# 技术与交付模块

## 模块目标

确定技术栈、开发流程、交付节奏和质量标准。

---

## 技术选型（已决策）

| 层级 | 选型 | 说明 |
|------|------|------|
| 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)
