# 会议管理

**Repository Path**: hadlooop/course-selection-system

## Basic Information

- **Project Name**: 会议管理
- **Description**: 基于 Go + Gin + MySQL + Vue 3 的会议宣传、报名与后台管理平台。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Simon Meet 会议系统

基于 **Go + Gin + MySQL + Vue 3** 的会议宣传、报名与后台管理平台。

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## 功能概览

| 模块 | 说明 |
|------|------|
| **宣传门户** | 多宣传页、子域 `*.域名` 解析、LED 顶栏滚动、会场信息展示 |
| **会议报名** | 访客在线报名；后台审核报道/签退；扫码报到 |
| **管理后台** | RBAC（用户/角色/权限/菜单）、会议与宣传页 CRUD、操作/登录日志 |
| **报名运维** | 分页列表、Excel 导出、单人 A4 报名单打印、会议报名名单打印 |

## 项目结构

```
simon-meet/
├── frontend/           # Vue 3 + Vite 前端 → [frontend/README.md](frontend/README.md)
├── backend/            # Gin API 服务 → [backend/README.md](backend/README.md)
├── docker/             # Docker Compose 构建与运行 → [docker/README.md](docker/README.md)
├── scripts/deploy/     # 原生部署（rsync + systemd + Nginx）→ [scripts/deploy/README.md](scripts/deploy/README.md)
└── skills/             # Agent 技能（simon-meet、RBAC、UI 规范等，见 skills/README.md）
```

## 环境要求

- **Go** 1.25+（后端）
- **Node.js** 20+（前端）
- **MySQL** 8+（远端或本地）
- 可选：**Redis**（宣传页缓存）、**MinIO**（图片与头像）

## 快速开始（本地开发）

### 1. 数据库

```bash
cd backend
cp .env.example .env   # 填写 DB_*、JWT_SECRET、MinIO 等
go run ./cmd/migrate   # 建表 + 种子数据（可重复执行）
```

默认管理员：`admin` / `admin123`

### 2. 后端

```bash
cd backend
go run ./cmd/server    # 默认 :8080
```

### 3. 前端

```bash
cd frontend
npm install
npm run dev            # 默认 http://localhost:5173
```

| 地址 | 说明 |
|------|------|
| http://localhost:5173/ | 宣传门户 / 子域宣传页 |
| http://localhost:5173/p/{slug} | 指定 slug 宣传页 |
| http://localhost:5173/checkin | 扫码报道/签退 |
| http://localhost:5173/admin/login | 管理后台登录 |

开发时 Vite 将 `/api` 代理到 `http://localhost:8080`。

## 部署方式

| 方式 | 文档 |
|------|------|
| Docker Compose | [docker/README.md](docker/README.md) |
| 服务器原生（推荐生产） | [scripts/deploy/README.md](scripts/deploy/README.md) |

生产示例：`./scripts/deploy/deploy.sh`（前后端部署，可选 `--migrate`、`--no-push`）。

## API 基础

- 前缀：`/api/v1`
- 响应：`{ "code": 200, "message": "ok", "data": ... }`
- 管理端：`Authorization: Bearer <JWT>`

### 公开接口（节选）

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/promo/home` | 首页宣传（Redis 缓存） |
| GET | `/promo/:slug` | 按 slug 宣传页 |
| GET | `/promo/site-config` | 站点配置（门户域名等） |
| GET | `/conferences` | 已发布会议 |
| POST | `/registrations` | 提交报名 |
| POST | `/registrations/checkin` | 申请现场报道 |
| POST | `/registrations/checkout` | 申请签退 |

### 管理接口（节选）

| 模块 | 路径前缀 |
|------|----------|
| 认证 | `/auth/login`、`/auth/me`、`/auth/profile` |
| 宣传页 | `/admin/promo` |
| 会议 | `/admin/conferences` |
| 报名 | `/admin/registrations`（含 `/export`、`/roster`） |
| RBAC | `/admin/users`、`/roles`、`/menus` |
| 审计 | `/admin/operation-logs`、`/login-logs` |

完整路由见 `backend/internal/router/`（入口 `router.go`，模块说明见 [skills/simon-meet/reference.md](skills/simon-meet/reference.md#http-路由)）。

## 配置说明

| 文件 | 用途 |
|------|------|
| `backend/.env` | 数据库、JWT、Redis、MinIO、CORS、日志 |
| `docker/.env` | Docker 构建与运行环境 |
| `scripts/deploy/deploy.env` | 部署目标机、Nginx、构建变量、Git 推送 |

勿将含密码的 `.env` 提交到 Git（已在 `.gitignore`）。

## 开源协议

版权所有 © 百因。本项目采用 [MIT License](LICENSE) 发布。你可以自由使用、修改与分发，但需保留版权声明与许可全文；软件按「原样」提供，不提供任何担保。

## 相关文档

- [scripts/desktop/README.md](scripts/desktop/README.md) — 管理后台桌面客户端打包（Tauri）
- [backend/README.md](backend/README.md) — 后端分层、数据表、权限码、环境变量
- [frontend/README.md](frontend/README.md) — 前端路由、页面、构建与代理
- [docker/README.md](docker/README.md) — 镜像加速、MinIO 代理
- [scripts/deploy/README.md](scripts/deploy/README.md) — 生产部署与运维命令
- [AGENTS.md](AGENTS.md) / [skills/](skills/) — Agent 与领域参考