# queue-call-system

**Repository Path**: dalq/queue-call-system

## Basic Information

- **Project Name**: queue-call-system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-25
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 排队叫号系统 (Queue Call System)

政务服务大厅智能排队叫号系统

## 📁 项目结构

```
queue-call-system/
├── docs/                    # 文档
├── database/                # 数据库脚本
├── backend/                 # Node.js 后端 API
├── web-admin/               # Web 管理后台 (Vue 3)
├── window-call/             # PC 窗口叫号端 (Vue 3)
├── display-screen/          # PC 综合显示屏 (Vue 3)
└── android-kiosk/           # Android 取号机 (Kotlin)
```

## 🛠️ 技术栈

- **前端**：Vue 3 + Vite + Element Plus
- **后端**：Node.js + Express
- **数据库**：MySQL 8.0+
- **Android**：Kotlin + Jetpack Compose

## 🚀 快速开始

### 1. 数据库初始化

```bash
cd database
mysql -u root -p < schema.sql
mysql -u root -p < seed.sql
```

### 2. 后端启动

```bash
cd backend
npm install
cp .env.example .env
# 编辑 .env 配置数据库连接
npm run dev
```

### 3. 前端启动

```bash
# 管理后台
cd web-admin
npm install
npm run dev

# 窗口叫号端
cd window-call
npm install
npm run dev

# 综合显示屏
cd display-screen
npm install
npm run dev
```

### 4. Android 取号机

使用 Android Studio 打开 `android-kiosk/` 目录

## 📊 系统架构

```
┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Android    │────▶│   Node.js    │────▶│    MySQL    │
│  取号机     │     │   后端 API    │     │   数据库    │
└─────────────┘     └──────────────┘     └─────────────┘
                           │
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
   ┌──────────┐     ┌──────────┐     ┌──────────┐
   │ 管理后台  │     │ 窗口叫号  │     │ 综合显示  │
   │  (Vue)   │     │  (Vue)   │     │  (Vue)   │
   └──────────┘     └──────────┘     └──────────┘
```

## 👥 用户角色

| 角色 | 终端 | 功能 |
|------|------|------|
| 办事群众 | Android 取号机 | 身份证录入、选择业务、取号 |
| 窗口工作人员 | PC 窗口叫号端 | 登录、叫号、评价 |
| 大厅管理员 | Web 管理后台 | 配置管理、数据统计 |
| 大厅群众 | 综合显示屏 | 查看排队信息 |

## 📝 开发日志

- 2026-03-20: 项目创建，需求确认