Skip to content

v0.1.0 — Initial Open Source Release

Choose a tag to compare

View all tags
@DevMinions DevMinions released this 28 May 05:32
· 87 commits to main since this release
v0.1.0
22ed3e8

首个开源版本 ✨

UniDormManager 是一套基于 Go + React 19 的现代化大学宿舍管理系统。本版本剥离了不完整的客户端，聚焦 Server (Gin + PostgreSQL) + Web 管理端 (React + Vite + Tailwind) 两个成熟稳定的子项目作为 v0.1.0 出仓。

🚀 包含的核心功能

  • 学生管理（信息维护、宿舍分配、按楼栋作用域过滤）
  • 楼栋与房间管理（含楼层属性、容量/入住统计）
  • 报修管理（CRUD + 状态流转）
  • 公告管理
  • 查寝评分（含房间汇总与排行）
  • 门禁记录与晚归告警处理
  • 调宿申请与多步审批
  • RBAC 权限管理（系统管理员通过通配自动获得所有权限）
  • 仪表板（KPI + 楼栋入住率图表 + 报修状态饼图）
  • Prometheus /metrics + 健康检查 /health

🏗️ 技术栈

  • 后端: Go 1.23 · Gin · pgx · PostgreSQL 16 · Redis 7 (可选缓存) · JWT
  • 前端: React 19 · TypeScript · Vite · Tailwind CSS · Recharts · Lucide React
  • 部署: docker-compose（PostgreSQL + Redis + 后端 + 前端 + 可选 Nginx + 可选 Grafana）
  • CI: GitHub Actions（测试 + 构建 + Trivy 安全扫描 + ghcr.io 镜像推送）

✅ 质量基线

  • cd UniDormManagerServer && go test ./... 全绿
  • tests/audit_api.py 后端 36 个接口实测全 PASS（含 auth/RBAC/分页/CRUD 闭环）
  • tests/audit_web.js Web E2E 17/17 PASS（Playwright + 系统 Chrome 抓 9 张 README 截图）
  • 已修复全部已知 schema/RBAC/SQL 参数错位等 bug

🔐 安全实践

  • 默认 admin 密码不再硬编码 admin123，首启 crypto/rand 生成 16 字符随机密码，日志一次性打印（可被 ADMIN_INITIAL_PASSWORD 环境变量覆盖）
  • Private Vulnerability Reporting 已启用，漏洞通过 GitHub Security tab 上报
  • JWT_SECRET 强制要求生产环境替换
  • .env、本地 IDE 配置等已 gitignore

📚 文档

见 README 文档列表：Docker 部署 / 数据库初始化 / 完整部署 / API 接口 / 开发规范 / 用户操作手册 / 变更日志 / 贡献指南

🙏 致谢

感谢 @anthropics/claude-code 全程辅助这次开源整理工作。

Assets 2
Loading