四端上传

2026-09-29 15:25:40 +08:00
1 parent 25bbb5f9c8
commit c6e2cb4d5b
@@ -0,0 +1,67 @@
+# 叶雷讲数学
+
+微信小程序在线数学课程项目。
+
+## 目录结构
+
+四个子项目**各自独立**：各自安装依赖、各自持有 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)。
+