附录

项目信息

技术栈

文件结构

QR-Code-Gate/
├── app.py              # Flask 主应用（60+ 路由）
├── models.py           # 数据模型 + 业务逻辑
├── api_client.py       # C3 API 客户端
├── config.json         # 运行时配置
├── data/
│   ├── accounts.json   # 账户池
│   ├── approvals.json  # 审批记录
│   ├── admins.json     # 管理员
│   ├── devices.json    # 门禁设备缓存
│   └── admins/
│       └── leon.json   # 超管凭证
├── templates/          # Jinja2 模板（9 个）
│   ├── base.html
│   ├── index.html
│   ├── visitor.html
│   ├── approve.html
│   ├── qr.html
│   ├── dev.html
│   ├── remote.html
│   ├── admin.html
│   └── emp_pass.html
└── static/
    ├── css/
    └── js/

核心文件说明

账户模型设计

账户模型（AccountsModel）

class Account:
    def __init__(self, account_no, visitor_name="", visitor_phone="",
                 allocated=False, allocated_by=None, allocated_at=None,
                 expires_at=None):
        self.account_no = account_no      # C3 门禁账户编号
        self.visitor_name = visitor_name   # 访客姓名
        self.visitor_phone = visitor_phone # 访客手机号
        self.allocated = allocated         # 是否已分配
        self.allocated_by = allocated_by   # 哪个管理员分配的
        self.allocated_at = allocated_at   # 分配时间
        self.expires_at = expires_at       # 到期时间（分时分配用）

门禁设备（DoorsModel）

class DoorDevice:
    def __init__(self, id, name, dev_mac, enabled, group_name):
        self.id = id                    # 设备 ID
        self.name = name                # 门禁名称（doorName）
        self.dev_mac = dev_mac          # 设备 Mac 地址
        self.enabled = enabled          # 是否启用
        self.group_name = group_name    # 所属分组

门禁点位

共 404 个门禁点位（启用 387 个），分两大类：

URL 路由

测试脚本

项目附带完整的测试脚本：

安全机制

联系方式

← 常见问题 返回首页