智能门锁摄像头项目，包含后端服务、前端界面、树莓派端网关/摄像头程序以及人脸识别相关代码。项目支持账号登录、TOTP 多因素认证、设备绑定、摄像头人脸校验、开门令牌、访客通行码、告警记录、设备心跳和门锁状态管理。
本项目用于智能门锁摄像头系统的本地开发、联调与功能演示。
.
├── BE_smart_lock/ # 后端 Flask 服务
│ └── smart_lock/
│ ├── app/ # 应用代码、模型、路由
│ ├── config.py # 后端配置
│ ├── requirements.txt # Python 依赖
│ └── run.py # 后端启动入口
├── FE_smart_lock/ # 前端项目
│ └── smartlock/ # Vue 2 前端源码
├── paspberry_pi/ # 树莓派端摄像头/网关代码
├── wanganCV/ # 人脸识别相关代码
└── API_DOCUMENTATION.md # 前后端接口文档
- 后端：Flask、Flask-SQLAlchemy、Flask-JWT-Extended、Flask-Bcrypt、PyMySQL、pyotp、cryptography
- 前端：Vue 2、Vue Router、Axios、Vue CLI
- 数据库：默认 SQLite，支持通过
DATABASE_URL切换到 MySQL - 设备端：树莓派摄像头采集、人脸识别结果上报、门锁控制联动
进入后端目录：
cd BE_smart_lock\smart_lock创建并激活 Python 虚拟环境：
python -m venv .venv
.\.venv\Scripts\Activate.ps1安装依赖：
pip install -r requirements.txt启动服务：
python run.py默认监听地址：
http://localhost:8000
后端启动时会自动创建数据库表。默认数据库文件为 Flask instance 目录下的 smart_lock.db。
| 变量名 | 说明 | 默认值 |
|---|---|---|
DATABASE_URL |
数据库连接地址，例如 MySQL 可使用 mysql+pymysql://user:password@host:3306/dbname?charset=utf8mb4 |
sqlite:///smart_lock.db |
JWT_SECRET_KEY |
JWT 签名密钥，生产环境必须固定配置 | 随机生成 |
DEVICE_DISPATCH_REQUIRED |
人脸挑战下发失败时是否直接报错。联调阶段建议 false，无树莓派也可走通流程 |
false |
SMART_LOCK_DEVICE_URL |
默认设备端服务地址，用于后端下发人脸挑战 | 空 |
SMART_LOCK_DEVICE_URL_<DEVICE_ID> |
指定设备的服务地址，例如 SMART_LOCK_DEVICE_URL_LOCK_1 |
空 |
联调阶段如果还没有树莓派端服务，可以保持：
$env:DEVICE_DISPATCH_REQUIRED = "false"这样 /api/mfa/open-door/request 在设备派发失败时会走开发兜底，方便前端先完成流程联调。正式接入设备后建议改为：
$env:DEVICE_DISPATCH_REQUIRED = "true"进入前端目录：
cd FE_smart_lock\smartlock安装依赖：
npm ci启动开发服务：
npm run serve构建生产包：
npm run build前端默认请求后端：
http://localhost:8000
如需修改后端地址，可在前端目录创建 .env.local：
VUE_APP_API_BASE=http://localhost:8000
- 启动后端：
BE_smart_lock\smart_lock\run.py - 启动前端：
FE_smart_lock\smartlock下执行npm run serve - 前端注册用户：
POST /api/register - 首次登录走预登录：
POST /api/login/pre - 按返回的 TOTP 密钥绑定 MFA：
POST /api/login/mfa/bind - 登录后绑定设备：
POST /api/mfa/bind/device - 发起开门认证：
POST /api/mfa/open-door/request - 确认开门并获取开门令牌：
POST /api/mfa/open-door/confirm
完整接口字段请查看 API_DOCUMENTATION.md。
后端基础检查：
$env:PYTHONDONTWRITEBYTECODE = "1"
$env:PYTHONPATH = "BE_smart_lock\smart_lock"
python -B -c "from app import create_app; app = create_app(); print('app created', len(app.url_map._rules))"前端构建检查：
cd FE_smart_lock\smartlock
npm ci
npm run build- 不要提交
__pycache__、.pyc、node_modules、dist、outputs、IDE 配置等生成文件。 - 后端默认开启 CORS，便于本地前后端分端口联调。
- 当前前端使用 Vue 2，安装依赖时可能出现 Vue 2 EOL 或依赖漏洞提示，联调可先忽略，后续可单独规划升级。
- 生产环境必须配置固定的
JWT_SECRET_KEY，并将DEVICE_DISPATCH_REQUIRED设置为true。