体育活动室在线管理系统

一个集活动发布、报名管理、支付订单、社交互动于一体的现代化体育活动管理平台

15+

API接口

10

测试用例

3

CI/CD工作流

4

数据模型

项目演示

💡 核心功能

用户管理系统

注册、登录、个人资料管理,JWT身份验证

活动发布与管理

创建活动、设置时间地点、参与人数限制

报名与订单系统

在线报名、订单管理、支付集成(模拟)

社交互动

用户动态、活动评价、社交广场

🎯 项目特色

  • 响应式设计,支持移动端
  • 完整的身份验证与授权
  • 现代化前后端分离架构
  • 完整的CI/CD自动化流程
  • 代码质量监控与测试覆盖

API 接口文档

用户管理 API

POST /api/user/register

用户注册

POST /api/user/login

用户登录

GET /api/user/profile

获取用户资料

PUT /api/user/profile

更新用户资料

活动管理 API

POST /api/activity

创建活动

GET /api/activities

获取活动列表

GET /api/activity/:id

获取活动详情

DELETE /api/activity/:id

删除活动

报名管理 API

POST /api/registration

创建报名

GET /api/registrations

获取报名列表

PUT /api/registration/:id

更新报名状态

DELETE /api/registration/:id

取消报名

通用 API

GET /

首页健康检查

GET /api/get_user

获取用户信息

POST /api/upload

文件上传

项目架构

前端层

  • • React 18 + Hooks
  • • React Router v7
  • • Tailwind CSS
  • • Vite 构建工具
  • • 响应式设计

后端层

  • • Node.js + TypeScript
  • • Midway.js 框架
  • • RESTful API
  • • JWT 身份验证
  • • 文件上传支持

数据层

  • • TypeORM + SQLite
  • • 实体关系映射
  • • 数据库迁移
  • • 测试数据隔离
  • • 自动同步架构

📁 项目结构

🎨 前端结构 (webfrontend/)

webfrontend/
├── src/
│   ├── api/           # API 请求封装
│   ├── pages/         # 页面组件
│   │   ├── Home/      # 首页
│   │   ├── Login/     # 登录页
│   │   ├── Activity/  # 活动相关
│   │   └── Profile/   # 个人中心
│   ├── assets/        # 静态资源
│   └── App.jsx        # 主应用组件
├── index.html         # 入口文件
└── vite.config.js     # Vite 配置

⚙️ 后端结构 (webbackend/)

webbackend/
├── src/
│   ├── controller/    # 控制器层
│   ├── service/       # 业务逻辑层
│   ├── entity/        # 数据实体
│   ├── dto/           # 数据传输对象
│   ├── config/        # 配置文件
│   ├── middleware/    # 中间件
│   └── filter/        # 异常过滤器
├── test/              # 测试文件
└── uploads/           # 文件上传目录

🛠️ 技术栈

前端技术

React 18

React Router

Tailwind CSS

Vite

JavaScript

响应式设计

后端技术

Node.js

TypeScript

Midway.js

TypeORM

SQLite

JWT

开发工具 & DevOps

GitHub Actions

Jest Testing

ESLint

VS Code

Git

CI/CD

🔄 CI/CD 流水线

Basic CI

  • ✅ 代码规范检查
  • ✅ TypeScript 类型检查
  • ✅ 前后端构建验证
  • ✅ 安全漏洞扫描
  • ✅ 自动化测试运行

Code Quality

  • 📊 代码质量分析
  • 🔍 深度安全扫描
  • 📈 项目统计报告
  • 🧹 代码规范检查
  • 📋 质量门禁控制

Multi-Version

  • 🔧 Node.js 18.x 测试
  • 🔧 Node.js 20.x 测试
  • 🔧 Node.js 22.x 测试
  • 📦 Webpack 构建验证
  • 🌐 跨版本兼容性