# DoTouch.AI - AI API 算力中转站

AI 大模型 API 转售平台，基于 OpenAI 兼容格式，向越南及海外用户转售国产大模型能力（阿里云 DashScope: GLM 5.2, DeepSeek V4 系列）。

## 架构概览

```
dotouch-ai/
├── apps/
│   ├── web/          # Next.js 14 (App Router) - 落地页 + 未来控制台
│   └── api/          # NestJS v11 - API 网关服务
├── packages/
│   └── shared/       # 共享类型 & 常量
├── docker-compose.yml  # PostgreSQL 16 + Redis 7
└── deploy/           # Docker 部署配置 (后续)
```

## 技术栈

| 层 | 技术 |
|---|------|
| 前端 | Next.js 14 + TypeScript + Tailwind CSS + next-intl |
| 后端 | NestJS v11 + Prisma (PostgreSQL) + ioredis (Redis) |
| 数据库 | PostgreSQL 16 |
| 缓存 | Redis 7 |
| 包管理 | pnpm (monorepo workspace) |
| 部署 | Docker → 香港节点 |

## 国际化

支持 4 种语言：`vi` (越南语), `en` (英语), `zh-CN` (简体中文), `zh-TW` (繁体中文)

## 快速开始

```bash
# 安装依赖
pnpm install

# 启动开发数据库
docker compose up -d

# 生成 Prisma 客户端
pnpm db:generate

# 启动开发服务器
pnpm dev

# 构建
pnpm build

# 类型检查
pnpm typecheck
```

## 环境变量

复制 `.env.example` 到 `.env` 并填写真实值。

## 测试账号（本地开发）

| 账号 | 用途 | 邮箱 | 密码 |
|---|---|---|---|
| 用户 | 官网 / 用户控制台 | `demo.user@dotouch.ai` | `User2026!` |
| 运营 | 平台管理后台 | `admin@dotouch.ai` | `Admin2026!` |
| 测试主账号 | 接口联调（admin） | `test-e2e@dotouch.ai` | `Test1234` |

## API 端点

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /v1/health | 健康检查 |
| POST | /v1/auth/send-code | 发送邮箱验证码（8 位，15 分钟有效） |
| POST | /v1/auth/register | 注册（邮箱+密码+验证码） |
| POST | /v1/auth/login | 登录（5 次失败/15 分钟限流） |
| POST | /v1/auth/forgot · /reset | 密码重置 |
| POST | /v1/keys · /v1/keys/:id/rotate | API Key 创建 / 轮换 |
| PUT | /v1/keys/:id/limits | Key 用量限额配置 |
| PUT | /v1/account/limits | 账号级用量限额 |
| GET | /v1/usage/quota | 用量进度（限额进度条数据） |
| GET | /v1/models | 模型目录（236 全量） |
| POST | /v1/chat/completions | OpenAI 兼容网关（SSE 流式） |
| GET | /v1/usage · /v1/usage/summary | 用量明细 / 日聚合 |
| GET | /v1/wallet | 钱包余额与流水 |
| POST | /v1/wallet/deposit | 充值（创建支付订单） |
| GET | /v1/wallet/orders | 充值订单列表 |
| POST | /v1/payments/webhook/:provider | 支付回调（webhook） |
| GET | /v1/admin/* | 管理后台（stats/users/models/quotas） |

## 文档树（Documentation Map）

```
docs/
├── README 指南：本文件（根 README 见上）
├── VERSIONING.md            版本与迭代规范（时间戳 + 递增版本号）
├── CHANGELOG.md             变更记录（按功能迭代）
│
├── requirements/            需求文档
│   └── usage-quota-requirements-v1.0.md   用量提醒与限制需求规格（定稿）
│
├── testing/                 测试体系
│   ├── test-cases-v1.0.0.md         端到端测试用例（10 组）
│   ├── feature-acceptance-matrix.md 功能清单与验收标准（F-01~F-14，90+ 用例）
│   └── test-run-log.md              测试运行日志（每轮结果 + 缺陷 + 反馈跟踪）
│
├── compliance/              合规调研
│   ├── top3-transit-compliance-20260808.md    全球 Top3 中转站合规对比
│   └── alibaba-bailian-terms-20260808.md      阿里云百炼条款（转售需书面许可）
│
├── seo/                      SEO 方案与性能基线
│   ├── seo-strategy-v1.0.md          SEO 方案（P1 已执行，P2/P3 待执行）
│   └── performance-baseline-v1.3.0.md 性能基线（SSG TTFB ~13ms）
├── models/                  模型调研（阿里云百炼真实扫描）
│   ├── dashscope-models-20260808.json    236 个在售模型全量清单
│   └── dashscope-pricing-20260808.md     价格与收费方式（含 7 折策略）
│
└── design/                  设计资产与审阅稿
    ├── logo-*.html                  Logo 概念迭代（v1.0.0→v1.3.0→终稿）
    ├── logo-final-b1-*.html         B1 终稿规范（安全区/配色/禁用用法）
    ├── assets/                      品牌素材（SVG×5 / 质感稿 / 动态视频）
    ├── web-v1.1.0/                  官网静态稿（6 页多语言 + 模型大全子页）
    └── console-v1.0.0/              控制台设计稿（用户控制台 + 管理后台）

apps/web/src/components/     官网落地组件（SiteHeader/Hero/AuthModal 等 15 个）
apps/api/src/                后端模块（auth/keys/wallet/payments/gateway/quota/admin）
```

## 许可

UNLICENSED - All rights reserved.