project-phoenix

Phoenix Project（凤凰计划）是一款专为德国全天学校（Ganztagsbetreuung / OGS & Hort）设计的自托管、GDPR-by-design 看护管理平台。它用基于NFC的签到签退终端取代纸质考勤表，并提供对学生出勤和房间占用情况的实时监控。 核心功能： - NFC学生追踪：儿童在运行 PyrePortal（Tauri + React）的树莓派平板自助终端上刷卡进出，数据实时推送至员工仪表板。 - 房间与分组管理：查看和管理房间占用、看护分工、混合分组及活动安排。 - 家长门户：跨校监护人次账号，支持多语言界面（德语、英语、俄语、阿尔巴尼亚语）。 - 在线报名：可配置的公共报名表，支持分阶段入学、照护服务和同意条款。 - 员工工时追踪：符合德国工时法（ArbZG）的工作时段记录、余额核算和休假流程。 - 多租户架构：多个 Träger（运营机构）和学校可共存于同一部署中，通过 PostgreSQL 行级安全（RLS）隔离，各自拥有独立子域名和操作员门户。 - 单校运行时设置：租户管理员可在无需重新部署的情况下配置系统行为。 - 内置在线手册：支持在 CI 中生成可打印的 PDF 文档。 技术架构：后端采用 Go 1.27 + Chi 路由 + Bun ORM；前端为 Next.js 16 / React 19 / TypeScript / Tailwind CSS 应用；数据库使用 PostgreSQL 17，含 15 个领域 Schema、SSL 加密及 RLS；认证方式为 JWT + 刷新令牌 + 双重认证；部署方案为 Docker Compose，环境配置经 SOPS 加密；CI/CD 由 GitHub Actions 驱动。NFC 终端通过设备认证的 /api/iot/* 端点通信。 该项目与一所真实 OGS 同步开发，并得到明斯特大学（Universität Münster）的研究支持。平台提供可配置的保留策略、只追加审计日志以及符合德国数据保护要求的删除权支持。