# qevin

**Repository Path**: moonwei/qevin

## Basic Information

- **Project Name**: qevin
- **Description**: 使用qoder重构内网部分。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 新易访内网系统

## 项目概述

新易访内网系统是一个基于Vue 3 + FastAPI的访客管理系统，主要用于医院、企业等机构的访客登记和管理。

## 快速开始

### 前端启动
```bash
cd frontend
npm install
npm run dev
```

或者直接运行:
```bash
cd frontend
start_dev_server.bat
```

### 后端启动
```bash
cd backend
# 创建虚拟环境
python -m venv .venv
# 激活虚拟环境
.venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 启动服务器
python start_server.py
```

或者直接运行:
```bash
cd backend
start_server.bat
```

## 项目规划

### 技术栈
- **前端**: Vue 3.5.21 + TypeScript 5.9.2 + Element Plus 2.11.2 + Vite 7.1.5
- **后端**: Python 3.13 + FastAPI + SQLite
- **加密库**: cryptography 42.0.5
- **状态管理**: Pinia 3.0.3
- **路由**: Vue Router 4.5.1

### 功能模块

#### 门卫功能
- [x] 二维码核验
- [x] 今日核验记录查看

#### 管理员功能
- [x] 密钥管理
- [x] 特殊访客管理
- [x] 门卫账号管理
- [x] 统计分析
- [x] 审计日志

#### 超级管理员功能
- [ ] 系统管理
- [ ] 数据包生成
- [ ] 系统监控

### 目录结构

#### 前端目录结构
```
frontend/
├── src/
│   ├── api/              # API接口
│   ├── assets/           # 静态资源
│   ├── components/       # 组件
│   │   ├── admin/        # 管理员组件
│   │   ├── common/       # 通用组件
│   │   ├── guard/        # 门卫组件
│   │   └── superadmin/   # 超级管理员组件
│   ├── router/           # 路由配置
│   ├── stores/           # 状态管理
│   ├── types/            # 类型定义
│   ├── utils/            # 工具函数
│   └── views/            # 页面视图
└── ...
```

#### 后端目录结构
```
backend/
├── src/
│   ├── api/              # API路由
│   ├── core/             # 核心配置
│   ├── database/         # 数据库相关
│   ├── middleware/       # 中间件
│   ├── models/           # 数据模型
│   ├── schemas/          # Pydantic模式
│   ├── services/         # 业务逻辑
│   └── utils/            # 工具函数
└── ...
```

## 进度记录

### 已完成任务
- [x] 项目初始化和目录结构搭建
- [x] 前端基础组件开发（登录页面、门卫功能组件）
- [x] 后端核心配置和数据库模型设计
- [x] 后端API路由和业务服务开发
- [x] 管理员功能组件开发（密钥管理、特殊访客管理、门卫管理）
- [x] 管理员功能组件完善（统计分析、审计日志）
- [x] 启动脚本编写

### 待完成任务
- [ ] 超级管理员功能组件开发
- [ ] 前后端联调测试
- [ ] 系统集成测试
- [ ] 部署文档编写

## 开发规范

本项目严格遵循MyFav开发规范，包括：
1. 文档管理规范
2. 开发流程规范
3. 问题解决规范
4. 执行约束规范
5. 环境与输出规范

## 结果说明

目前项目已完成基础框架搭建和核心功能开发，包括前后端基础架构、门卫功能模块和管理员功能模块。后续需要开发超级管理员功能模块并进行系统测试。