File size: 2,564 Bytes
27843d5 6e876c1 27843d5 6e876c1 27843d5 6e876c1 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | ---
title: 肆带贰球队系统
emoji: ⚽
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---
# 肆带贰 · 球队管理系统
深圳「肆带贰」足球俱乐部（SHENZHEN SI DAI ER FC）的内部球队管理系统，基于 [Shiny for Python](https://shiny.posit.co/py/) 构建。
## 功能
- **登录鉴权**：队员/管理员分级，密码哈希存储，支持改密、管理员重置
- **名单管理**：队员资料、球衣号、赛季信息
- **数据展示**：按赛季查看球队数据
- **图片导出**：将名单/数据渲染为图片便于分享
## 技术栈
| 层 | 选型 |
|----|------|
| Web 框架 | Shiny for Python |
| 数据层 | SQLAlchemy ORM |
| 存储 | 默认 SQLite，可切 Postgres（环境变量切换，代码零改动） |
| 数据处理 | pandas / openpyxl |
| 图片 | Pillow |
| 测试 | Playwright |
## 快速开始
依赖管理使用 [uv](https://github.com/astral-sh/uv)：
```bash
# 安装依赖
uv sync
# 本地运行（热重载）
uv run shiny run app.py --reload
```
首次运行会自动初始化数据库并写入名单与示例数据，浏览器打开 <http://127.0.0.1:8000>。
## 配置
通过环境变量配置，无需改动代码：
| 变量 | 作用 | 默认 |
|------|------|------|
| `DATABASE_URL` | 数据库连接串，部署时指向云端 Postgres | 本地 `data/team.db`（SQLite） |
| `SDE_DEFAULT_PASSWORD` | 队员初始密码 | 内置兜底（仅限本地开发，生产务必覆盖） |
> ⚠️ 正式部署请设置 `SDE_DEFAULT_PASSWORD`，并提醒队员首次登录后立即修改密码。
## 项目结构
```
monsoon-app/
├── app.py # 入口：UI 装配 + 服务端逻辑
├── src/
│ ├── config.py # 全局配置（球队信息、品牌色、数据库连接）
│ ├── db.py # 数据库引擎
│ ├── models.py # ORM 模型
│ ├── repo.py # 数据访问层
│ ├── security.py # 密码哈希
│ ├── seed.py # 初始数据
│ ├── theme.py # 样式
│ ├── export_img.py # 图片导出
│ └── view_*.py # 各页面视图（登录 / 主页 / 个人 / 管理）
├── data/ # 本地数据库（不入库）
├── www/ # 静态资源
└── tests/ # Playwright 测试
```
## 数据隐私
真实队员数据（含姓名、密码哈希）仅存于本地 `data/` 目录，已通过 `.gitignore` 排除，**不会进入版本库**。
|