数学项目服务端

基于 Express.js 和 SQLite 的数学学习平台后端服务。

安装步骤

# 1. 安装依赖
npm install

# 2. 配置环境变量
cp .env.example .env

# 3. 初始化数据库
node seed/seed_main.js --drop all

# 4. 启动服务器
npm start

服务器默认运行在 http://localhost:8888

管理工具

# 创建管理员账户
node admin-tools.js create-admin

# 查看所有用户
node admin-tools.js list

# 更多命令
node admin-tools.js help

项目结构

src/
├── controllers/     # HTTP请求处理
├── services/        # 业务逻辑
├── data/           # 数据库相关
│   ├── repositories/  # 数据访问层
│   └── schema/       # JSON Schema定义
├── models/          # 数据模型
└── auth/           # 认证相关

docs/
├── api/            # API文档
├── deployment/     # 部署指南
└── architecture/   # 架构文档

环境变量

必需的环境变量（参见 .env.example）：

• JWT_SECRET - JWT签名密钥
• SESSION_SECRET - 会话密钥
• ALLOWED_ORIGINS - CORS允许的源

文档

核心文档

• 文档中心 - 所有文档的入口
• API文档 - 完整的API参考
• 开发指南 - 开发环境设置和规范
• 测试指南 - 测试策略和最佳实践

架构与设计

• 系统架构 - 整体架构设计
• 数据流设计 - 系统数据流
• 安全架构 - 安全设计和实现
• 前端架构 - 前端架构分析
• 状态管理 - 状态管理优化

部署与运维

• 生产部署 - 生产环境部署指南
• 扩展指南 - 系统扩展策略
• 管理员指南 - 管理员权限和操作

数据库文档

• 数据库结构 - 数据库表结构
• 数据库Schema - 详细的数据库模式
• Schema版本控制 - Schema版本管理

管理后台

• 管理后台入门 - 管理后台快速开始
• 管理仪表板 - 仪表板使用指南
• Schema验证编辑器 - Schema编辑器使用
• 验证监控 - 数据验证监控

贡献指南

• 代码规范 - 代码风格和规范
• PR指南 - 提交PR的流程

教程

• 添加新API - 如何添加新的API端点
• Schema验证 - Schema验证教程

归档文档

• 实现指南归档 - 已完成的功能实现文档
• 导入脚本归档 - 数据导入相关文档
• 测试数据 - 测试用例数据