义工时长管理系统
功能概述
- 管理台：活动设置、义工时长登记、用户管理、数据导出（表格/图片）
- 用户端：输入姓名查询个人参与活动及累计义工时长
- 响应式：同时适配移动设备与 PC 端
技术栈
- 前端：React 18 + Vite 5 + TypeScript + TailwindCSS 3
- 后端：Node.js + Express + TypeScript
- 数据库：SQLite 3 (better-sqlite3)
- 部署：Docker + Gitea Actions 自动部署
- 域名：https://volunteer.bzw-hheb.top
初始管理员账号
- 用户名：
admin - 密码：
admin123
首次登录后请立即修改密码。
本地开发
# 安装后端依赖
cd server && npm install
# 安装前端依赖
cd ../client && npm install
# 启动后端（端口 3001）
cd server && npm run dev
# 启动前端（端口 5173，代理 /api 到 3001）
cd client && npm run dev
Docker 本地运行
docker compose up -d --build
部署配置（Gitea Secrets）
在仓库 Settings -> Secrets 中配置：
| 名称 | 说明 |
|---|---|
SSH_HOST |
服务器 IP/域名 |
SSH_PORT |
SSH 端口（默认 22） |
SSH_USER |
SSH 用户名 |
SSH_PRIVATE_KEY |
SSH 私钥（对应服务器上的公钥需加入 authorized_keys） |
数据持久化
SQLite 数据库文件位于容器 /app/server/data/volunteer.db，docker-compose.yml 中已配置为 bind mount 到 ./server/data。