13dbff885d97e04a4f694fb3d5339c9ea85d815d
Deploy to Server / deploy (push) Successful in 1m51s
- 批量解析:智能区分字段分隔符(Tab优先,否则中英逗号/分号),避免竖线误伤;支持工作组被切到多个字段后自动合并 - 工作组匹配:新增多种分隔符与忽略空格匹配;当义工号字段非纯数字且命中工作组时自动识别为工作组(兼容3列格式:班级,姓名,工作组) - 列表展示:前端二次按班级locale排序(中文+数字感知)+ 姓名,与后端SQL排序互补
义工时长管理系统
功能概述
- 管理台:活动设置、义工时长登记、用户管理、数据导出(表格/图片)
- 用户端:输入姓名查询个人参与活动及累计义工时长
- 响应式:同时适配移动设备与 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。
Languages
TypeScript
98.8%
CSS
0.6%
Dockerfile
0.4%
HTML
0.2%