# 叶雷讲数学

微信小程序在线数学课程项目。

## 目录结构

四个子项目**各自独立**：各自安装依赖、各自持有 lockfile，互不依赖。
仓库根目录不放任何 Node 配置，也不会有 `node_modules`。

| 目录 | 角色 | 技术栈 |
|---|---|---|
| `yelaymaths/` | 微信小程序 | 原生小程序 |
| `yelaymaths_api/` | 服务端 API | NestJS + Prisma + MySQL 5.7 |
| `yelaymaths_admin/` | 管理后台 | Next.js 15 + Tailwind |
| `yelaymaths_data.yeomai.site/` | 课程数据（图片 / 视频） | 静态文件 |
| `docs/` | 设计与部署文档 | — |

历史版本代码保留在 `前端/`、`服务端/`、`数据库/`，仅作参考，迁移完成后可删除。

## 快速开始

### 1. 服务端

```bash
cd yelaymaths_api
pnpm install
cp .env.example .env          # 填写数据库连接串与各类密钥
pnpm prisma:generate
pnpm prisma:migrate           # 建表
pnpm dev                      # http://127.0.0.1:3000
```

### 2. 迁移旧数据

```bash
cd yelaymaths_api
pnpm legacy:check                        # 体检，确认旧数据可无损映射
pnpm legacy:migrate -- --dry-run         # 试运行，核对行数
pnpm legacy:migrate                      # 正式迁移
```

详见 [`yelaymaths_api/tools/legacy/README.md`](yelaymaths_api/tools/legacy/README.md)。

### 3. 管理后台

```bash
cd yelaymaths_admin
pnpm install
cp .env.example .env.local    # 填写 API 地址
pnpm dev                      # http://127.0.0.1:3001
```

首次打开用登录页的「创建管理员账号」入口初始化超管。

### 4. 小程序

用微信开发者工具打开 `yelaymaths/`，先在 `yelaymaths/config/index.js` 里填写 API 与静态资源域名，
然后执行【工具 → 构建 npm】。

## 部署

见 [`docs/部署指南.md`](docs/部署指南.md)。

## 设计文档

见 [`docs/重构开发文档.md`](docs/重构开发文档.md)。