DoTouchAI

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 → 香港节点

国际化

支持 9 种语言：vi (越南语), en (英语), zh-CN (简体), zh-TW (繁体), id-ID (印尼语), ms-MY (马来语), th-TH (泰语), zh-HK (香港繁体), ar-SA (沙特阿拉伯语, RTL)

快速开始

方式 A：一键 demo（推荐先看效果，无需安装依赖）

docker compose -f docker-compose.demo.yml up -d --build
open http://localhost:3000   # 官网（9 语言）

完整部署说明与演示脚本：docs/demo-runbook-v1.6.0.md；团队任务清单：docs/team-tasks-v1.6.0.md

方式 B：本地开发

# 安装依赖
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.