# Aitori Backend

用于支撑 `frontend/` 的 NestJS 服务端骨架，当前已接入：

- `NestJS`
- `Prisma + MySQL`
- `Redis`
- 统一响应结构 `{ ok, data, error }`
- `Swagger`

## 环境要求

- Node.js `20.x`
- MySQL `3306`
- Redis `6379`

## 本地配置

复制环境变量：

```bash
cp .env.example .env
```

当前默认本地配置：

```env
PORT=3000
APP_BASE_URL=http://localhost:3000
DATABASE_URL=mysql://root:123456@localhost:3306/aitori_stylist
REDIS_URL=redis://:123456@localhost:6379
JWT_SECRET=replace-me
JWT_EXPIRES_IN=7d
CORS_ORIGIN=http://127.0.0.1:5173
NODE_ENV=development
```

## 安装与启动

```bash
npm install
npm run prisma:generate
npm run start:dev
```

## 校验命令

```bash
npm run build
npm run test:e2e -- --runInBand
npm run prisma:validate
```

## 当前接口状态

- `GET /api/v1/health`：可用
- `POST /api/v1/auth/stylist/login`：参数校验可用，业务逻辑返回 `501`
- `GET /api/v1/customers`：返回空列表结构
- `GET /api/v1/templates`：返回空列表结构
- `POST /api/v1/simulations`：参数校验可用，业务逻辑返回 `501`

## 文档入口

- Health: `http://localhost:3000/api/v1/health`
- Swagger: `http://localhost:3000/api/docs`