# Aitori React App

造型师后台前端，现已接入本仓库里的 `NestJS + Prisma + MySQL` 后端，可本地联调体验：

- 登录
- 仪表盘
- 客户列表 / 详情 / 新建 / 编辑
- 模板列表 / 详情
- 发型模拟结果 / 微调 / 术后跟进

## 环境要求

- Node.js `20.x`
- 本地可用的 MySQL `3306`
- 本地可用的 Redis `6379`
- 如需真实媒体存储，可提供 Google Cloud Storage service account 并填写到 `backend/.env`

## 前端安装

```bash
npm install
```

## 后端准备

后端目录在 `backend/`，先安装依赖并准备环境变量：

```bash
cd backend
npm install
cp .env.example .env
```

当前初始化阶段建议在 `.env` 中至少维护数据库、Redis 与基础应用配置：

```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
```

初始化 Prisma Client：

```bash
npm run prisma:generate
```

启动后端：

```bash
npm run start:dev
```

默认 API 地址：

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

默认登录账号：

- 当前登录接口骨架已接通，但业务实现尚未完成
- 提交有效格式的邮箱和密码会返回受控的 `501`

## 启动前端

回到项目根目录：

```bash
cd ..
npm run dev -- --host 127.0.0.1 --port 5173
```

默认访问地址：

- `http://127.0.0.1:5173/`

## 推荐体验路径

建议按这条路径体验：

```text
登录 -> 仪表盘 -> 客户列表 -> 打开客户详情 -> 发起模拟 -> 查看结果 -> 微调 / 术后跟进
```

模板相关也可以继续点：

```text
登录 -> 仪表盘 -> 模板列表 -> 模板详情
```

## 验证命令

前端：

```bash
npm run test
npm run typecheck
npm run build
```

后端：

```bash
cd backend
npm run prisma:validate
npm run test:e2e
```

## 当前说明

- 模板图库已从真实模板列表接口映射得到
- 术后选项当前使用前端本地静态选项，避免阻塞主流程联调
- 模拟结果保存、微调、术后跟进都走真实后端接口
- 当前更推荐复用你本机已有的默认 MySQL / Redis，而不是强依赖 `docker compose`
- 真实 GCS 凭证只应写入本机 `backend/.env`，不要提交到仓库示例文件