QUTCraft Platform（社团智枢）

平台划分为公开门户与管理工作台两部分。门户只读取已发布的公开信息，草稿、成员邮箱、审核记录与服务端凭据仅在受控的管理 API 中处理。

后端采用 Go、Gin 与 GORM，数据库迁移为版本化方案：SQL 内嵌于 API 二进制，按序执行并记录于 schema_migrations 表。认证使用 JWT 与基于 resource:action 的 RBAC 中间件，Access Token 仅驻留前端内存，刷新通过 HttpOnly Cookie 轮换。

前端采用 Vue 3、Vite 与 TypeScript，遵循 Material Design 3 设计语言。接口以 OpenAPI 3.1 契约为先，前端类型与接口文档同步演进，并支持契约 Mock 与远程 API 两种运行模式（VITE_API_MODE）。

已实现的管理能力包括：内容工作区（Markdown 编辑、审核与退回、发布与下线闭环、带差异统计的不可变修订历史）、资源文件工作区（上传队列、受控下载、未关联文件清理）、成员与权限管理（预创建待激活账户、邀请模板、投递结果与失败重试）、加入申请审核、审计记录查询，以及多组织会话切换。

AI 活动策划模块的边界为：智能体只读取显式选择的组织知识，输出带引用的方案与类型化建议操作；项目、里程碑与公告草稿必须经人工批准后创建，内容不会自动发布。

本平台部署于青岛理工大学 QUTCraft Minecraft 社团。部署环境由 Docker Compose 提供 MySQL、Redis、API、Web 与可选 MinIO，API 以 nonroot 身份运行。