# 访客预约系统

**Repository Path**: johnson191008/campus-visitor-system

## Basic Information

- **Project Name**: 访客预约系统
- **Description**: 为高校定制开发的一款多角色、全流程的访客管理系统，涵盖访客、教职工、安全办、保安与管理端，实现了从线上预约、多级审批、消息通知到扫码核验的数字化闭环，极大地提升了校园安全管理效率。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-11-25
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: PHP, Laravel

## README

# 校园访客系统

这是一个校园访客管理系统，包含前端和后端。前端是微信小程序，后端使用Laravel框架开发。

## 项目特点

- 提供访客预约、审批、进出校管理功能
- 支持二维码生成与扫描验证
- 集成企业微信认证
- 提供管理员后台和安全人员操作界面

## 技术架构

- 前端：微信小程序
- 后端：Laravel 9+
- 数据库：MySQL
- 第三方服务：企业微信、微信支付

## 目录结构

```
├── Front-end/        # 微信小程序前端代码
├── Rear-end/         # Laravel后端代码
├── campus_vistor.sql # 数据库结构文件
```

## 主要功能模块

### 前端
- 首页与隐私政策页面
- 访客预约表单
- 二维码生成与扫描
- 审批状态查看
- 安全人员进出登记
- 管理员统计报表

### 后端
- 用户认证与权限管理
- 访客预约管理
- 两级审批流程
- 二维码生成与验证
- 进出记录管理
- 企业微信集成
- 数据统计与导出

## 数据模型

- User: 用户模型，关联微信信息
- Visitor: 访客信息
- Staff: 校内员工信息
- Approval: 审批记录
- ApprovalHistory: 审批历史
- SecurityLog: 进出记录
- SecurityController: 安全人员操作接口

## API服务

- QrCodeService: 二维码生成服务
- WechatService: 微信通知服务
- WechatWorkService: 企业微信集成服务

## 安装指南

1. 克隆仓库
2. 安装依赖 `composer install`
3. 配置数据库 `.env`
4. 运行迁移 `php artisan migrate`
5. 导入数据库 `mysql -u username -p campus_vistor < campus_vistor.sql`
6. 启动服务 `php artisan serve`

## 开发者

- 主要开发者: Johnson
- 项目起始时间: 2023年

## 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

## 项目状态

当前为稳定版本，已可用于生产环境

## 贡献指南

欢迎贡献代码，请遵循以下流程：
1. Fork 仓库
2. 创建新分支
3. 提交代码
4. 发起 Pull Request

## 问题反馈

发现问题请提交 Issue，包含以下信息：
- 问题描述
- 复现步骤
- 预期行为
- 实际行为
- 系统环境信息

## 致谢

感谢 Laravel 框架和微信小程序平台的支持

## 相关文档

- [Laravel官方文档](https://laravel.com/docs)
- [微信小程序开发文档](https://developers.weixin.qq.com/miniprogram/dev/framework/)