# kindergartenweb

**Repository Path**: yahveyeye_admin/kindergartenweb

## Basic Information

- **Project Name**: kindergartenweb
- **Description**: 稚翼天瞳——幼儿园空地一体智能守护系统是一个深度融合人工智能、物联网与Web技术的综合性安全管理平台。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 稚翼天瞳——幼儿园空地一体智能守护系统（管理端）

## 概述
面向幼儿园安全与运营管理的 Web 后台，接收监控端的实时事件与视频分析结果，提供状态监控、事件处置、人员档案管理与统计报表。

## 环境要求
- Python 3.12.x（依赖锁定到 cp312，例如 TensorFlow 2.17.1 仅有 cp312 轮子）
- uv（虚拟环境与依赖管理）
- Podman + MySQL 8.0（容器化数据库）

## 启动数据库（必须先完成，Podman）
```bash
# 启动 MySQL 8.0 容器
podman run -d --name mysql-kindergarten \
  -e MYSQL_ROOT_PASSWORD=K1nderg@rtenDB! \
  -e MYSQL_DATABASE=kindergarten \
  -p 3306:3306 \
  -v mysql-data:/var/lib/mysql \
  mysql:8.0

# 导入数据库结构与数据
podman exec -i mysql-kindergarten mysql -uroot -p'K1nderg@rtenDB!' kindergarten < kindergarten.sql
```
数据库连接默认已配置在 `config.py`：
```python
SQLALCHEMY_DATABASE_URI = "mysql+mysqlconnector://root:K1nderg%40rtenDB%21@127.0.0.1/kindergarten?charset=utf8&auth_plugin=mysql_native_password"
```

> Podman 提示无法连接时：
> 1) `podman system connection list` 查看连接是否存在（不要在命令行里加注释）。  
> 2) `podman machine list` 查看默认 VM。  
> 3) 如果没有 VM：`podman machine init --now`；已有但未启动：`podman machine start`。  
> 启动后再执行上面的 `podman run`。

## 快速开始（代码与依赖）
```bash
# 1) 安装 uv（macOS/Linux）
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2) 创建本地虚拟环境（使用 .python-version 的 3.12）
uv venv --python 3.12

# 3) 安装依赖（严格按照 uv.lock）
uv sync --frozen
# 如要使用已激活环境，改用：uv sync --active
```

## 启动应用（数据库就绪后）
```bash
uv run python runit.py
# 访问 http://localhost:5001
```

如需在其他环境安装依赖，可导出 requirements：
```bash
uv export --format requirements-txt --no-hashes > requirements.txt
```

## 功能与账号
- 功能：幼儿/员工/志愿者管理，事件信息管理，用户权限管理，实时推送与报表。
- 默认账号：
  - 管理员：admin@test.com / 123
  - 经理：manager@test.com / 123456
  - 测试：336@test.com / 12345678

## 运行注意事项
- 保证 MySQL 容器运行，密码与 `config.py` 保持一致。
- 首次运行建议在联网环境下获取依赖与静态资源。
- 开发可设置 `DEBUG=True` 以便排错。
- 安全问题与待办清单见 `CODE_HEALTH_CHECK.md`。

## 背景摘录（原项目介绍）
- 监控端接入固定摄像头/无人机，执行人脸识别、行为分析、轨迹追踪，实时推送事件。
- 管理端负责事件处置、可视化报表及档案管理，将被动防控转为主动预警。