chore: initial import to Nexus_Edu

backend/README.md

@@ -0,0 +1,137 @@
+# EduNexus Backend API
+
+后端API服务，基于Express + Prisma + MySQL。
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+cd backend
+npm install
+```
+
+### 2. 配置环境变量
+
+复制`.env.example`为`.env`并配置数据库连接：
+
+```bash
+cp .env.example .env
+```
+
+编辑`.env`：
+```env
+DATABASE_URL="mysql://用户名:密码@localhost:3306/edunexus"
+```
+
+### 3. 初始化数据库
+
+```bash
+# 生成Prisma客户端
+npm run prisma:generate
+
+# 同步数据库schema
+npm run prisma:push
+```
+
+### 4. (可选) 导入示例数据
+
+在MySQL中执行：
+```bash
+mysql -u root -p edunexus < ../database/seed.sql
+```
+
+### 5. 启动服务器
+
+```bash
+# 开发模式
+npm run dev
+
+# 生产模式
+npm run build
+npm start
+```
+
+服务器将在 http://localhost:3001 启动
+
+## API端点
+
+### Auth `/api/auth`
+- `POST /register` - 注册
+- `POST /login` - 登录
+- `GET /profile` - 获取个人信息 🔒
+- `PUT /profile` - 更新个人信息 🔒
+- `POST /change-password` - 修改密码 🔒
+
+### Exams `/api/exams`
+- `GET /` - 获取试卷列表 🔒
+- `GET /:id` - 获取试卷详情 🔒
+- `POST /` - 创建试卷 🔒
+- `PUT /:id` - 更新试卷 🔒
+- `DELETE /:id` - 删除试卷 🔒
+- `POST /:id/nodes` - 添加节点 🔒
+- `PUT /:id/nodes/:nodeId` - 更新节点 🔒
+- `DELETE /:id/nodes/:nodeId` - 删除节点 🔒
+
+### 其他模块
+- `/api/org` - 组织架构 (TODO)
+- `/api/curriculum` - 教材知识 (TODO)
+- `/api/questions` - 题库 (TODO)
+- `/api/assignments` - 作业 (TODO)
+- `/api/submissions` - 提交 (TODO)
+- `/api/grading` - 批阅 (TODO)
+
+> 🔒 = 需要JWT认证
+
+## 认证
+
+API使用JWT Bearer Token认证。
+
+1. 调用`/api/auth/login`获取token
+2. 在请求头中添加：`Authorization: Bearer <token>`
+
+## 项目结构
+
+```
+backend/
+├── src/
+│   ├── controllers/     # 控制器
+│   ├── routes/          # 路由
+│   ├── middleware/      # 中间件
+│   ├── utils/           # 工具函数
+│   └── index.ts         # 入口文件
+├── prisma/
+│   └── schema.prisma    # Prisma模型定义
+└── package.json
+```
+
+## 数据库
+
+使用Prisma ORM管理MySQL数据库：
+
+```bash
+# 查看数据库
+npm run prisma:studio
+
+# 创建迁移
+npm run prisma:migrate
+
+# 重置数据库
+npm run prisma:push
+```
+
+## 开发指南
+
+- 所有API返回JSON格式
+- 使用UUID作为主键
+- 支持软删除 (isDeleted字段)
+- 所有表包含审计字段
+- ExamNode支持无限层级嵌套
+
+## 待完成
+
+- [ ] 完善其他6个模块的API实现
+- [ ] 添加数据验证中间件
+- [ ] 实现文件上传功能
+- [ ] 添加单元测试
+- [ ] 添加API文档（Swagger）