68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
# 叶雷讲数学
|
|
|
|
微信小程序在线数学课程项目。
|
|
|
|
## 目录结构
|
|
|
|
四个子项目**各自独立**：各自安装依赖、各自持有 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)。
|
|
|