医美 AI SaaS 平台 - API 后端

基于 Hono + TypeScript + Prisma 的医美 SaaS 平台 API 服务。

技术栈

• 框架: Hono (轻量高性能 Web 框架)
• 语言: TypeScript
• ORM: Prisma
• 数据库: PostgreSQL
• 认证: JWT + API Key
• 验证: Zod

快速开始

1. 环境要求

• Node.js 20+
• PostgreSQL 16+
• npm 或 pnpm

2. 安装依赖

npm install

3. 配置环境变量

复制 .env.example 到 .env 并修改配置：

cp .env.example .env

主要配置项：

DATABASE_URL="postgresql://postgres:password@localhost:5432/med_ai?schema=public"
JWT_SECRET="your-super-secret-jwt-key"
PORT=3000

4. 初始化数据库

# 生成 Prisma Client
npm run db:generate

# 同步数据库结构
npm run db:push

# 初始化种子数据
npm run db:seed

5. 启动开发服务

npm run dev

服务启动后访问: http://localhost:3000

演示账号

• 邮箱: admin@demo.com
• 密码: 123456

项目结构

src/
├── index.ts              # 入口文件
├── app.ts                # Hono 应用配置
├── core/                 # 核心基础设施
│   ├── middleware/       # 中间件
│   │   ├── auth.ts       # JWT + API Key 认证
│   │   ├── tenant.ts     # 多租户隔离
│   │   ├── validator.ts  # 请求验证工具
│   │   └── error.ts      # 错误处理
│   ├── response.ts       # 统一响应格式
│   ├── errors.ts         # 错误类定义
│   ├── context.ts        # Context 类型
│   └── db.ts             # Prisma Client
│
└── modules/              # 业务模块
    ├── auth/             # 认证模块
    ├── tenant/           # 租户管理 (平台级)
    ├── customer/         # 客户管理
    ├── project/          # 项目管理
    ├── appointment/      # 预约管理
    └── order/            # 订单管理

API 概览

认证接口 /api/auth

客户管理 /api/customers

项目管理 /api/projects

预约管理 /api/appointments

订单管理 /api/orders

租户管理 /api/platform/tenants (平台管理员)

响应格式

成功响应

{
  "code": 0,
  "message": "success",
  "data": { ... },
  "timestamp": 1705747200000
}

分页响应

{
  "code": 0,
  "data": {
    "list": [...],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 100,
      "totalPages": 5
    }
  },
  "timestamp": 1705747200000
}

错误响应

{
  "code": 400,
  "message": "请求参数错误",
  "errors": [
    { "field": "phone", "message": "手机号格式不正确" }
  ],
  "timestamp": 1705747200000
}

错误码

开发脚本

npm run dev          # 开发模式 (热重载)
npm run build        # 构建
npm run start        # 生产模式启动
npm run db:generate  # 生成 Prisma Client
npm run db:push      # 同步数据库结构
npm run db:migrate   # 数据库迁移
npm run db:studio    # Prisma Studio
npm run db:seed      # 初始化种子数据

文档

• 数据库设计 - 84 张表详细设计
• API 规范 - 420+ 接口文档
• 设计方案 - 项目设计方案

License

MIT