班级盒子

班级盒子是一个面向班级日常事务的微信小程序。它把考试安排、作业信息、活动通知、班级公告、资料链接等内容集中到一个地方，让同学不用再从聊天记录里反复翻找重要信息。

这个项目适合班级、社团、学习小组或课程团队使用：管理员负责发布和维护事项，成员完成身份认证后即可查看、收藏和订阅提醒；管理员也可以使用 AI 快速发布，把一句话通知整理成可确认、可修改的事项草稿。

它能解决什么

班级信息常常散落在群聊、私聊、文件和截图里。时间一久，考试时间、作业截止日期、活动地点、通知原文都容易被新的消息淹没。

班级盒子提供一个更稳定的入口：

• 重要事项统一发布，按类型整理。
• 每条事项有清晰的时间、地点、课程/活动名称和详细说明。
• 支持图片、附件和外部链接，资料不再只靠聊天记录转发。
• 成员可以收藏事项，也可以订阅下一次通知提醒。
• 管理员可以手动发布，也可以用 AI 辅助生成草稿后再确认发布。
• 管理员可以编辑、删除、置顶自己有权限管理的内容。

主要功能

• 班级事项：发布、查看、编辑、删除、置顶。
• 分类管理：考试安排、作业信息、活动信息、班级通知、其他。
• 资料补充：支持图片、附件和链接。
• AI 快速发布：管理员输入一句话，自动整理标题、分类、时间、地点和正文草稿。
• 收藏列表：保存自己关心的事项。
• 消息提醒：通过微信订阅消息提醒下一条通知。
• 意见反馈：已认证成员可以提交问题和建议，超级管理员可以集中查看反馈。
• 身份认证：只允许班级成员进入主要功能。
• 权限管理：普通成员、管理员、超级管理员分层使用。
• 安全校验：发布和编辑内容会经过内容安全检测。
• 操作记录：关键操作会写入日志，便于后续追踪。

使用角色

角色	可以做什么
未认证用户	只能进行班级身份认证
已认证成员	查看事项、收藏事项、订阅提醒、提交意见反馈
管理员	手动发布或 AI 辅助发布事项，管理自己发布的事项
超级管理员	管理所有事项和关键内容，查看用户反馈，也可使用 AI 辅助发布

页面概览

• 首页：浏览和筛选班级事项。
• 详情页：查看事项内容、图片、附件、链接，并进行收藏。
• 发布页：管理员选择 AI 快速发布或手动发布；编辑已有事项时使用手动表单。
• 我的：查看身份状态、订阅提醒、进入收藏、我的发布、意见反馈和超级管理员反馈查看。
• 成员认证：填写姓名和学号完成班级身份认证。
• 管理员认证：通过一次性邀请码开通管理员权限。
• 意见反馈：已认证成员提交 2 到 300 字的问题或建议。
• 查看反馈：超级管理员按时间倒序查看用户提交的反馈。

自行部署

本仓库是开源版本，不包含正式项目的真实 AppID、云环境 ID、订阅消息模板 ID、openid、班级成员名单、管理员邀请码或云文件地址。

如果你想部署自己的班级盒子，需要准备：

• 微信开发者工具
• 微信小程序 AppID
• 微信云开发环境
• 订阅消息模板
• 班级成员名单
• 管理员或超级管理员邀请码
• 如需启用 AI 快速发布，还需要可由云函数访问的 AI 服务配置

快速步骤：

git clone https://github.com/Cheems-sudo/Class-Box.git
cd Class-Box
cp project.config.example.json project.config.json
cp miniprogram/config.example.js miniprogram/config.js
cp cloudfunctions/sendNoticeMessage/config.example.js cloudfunctions/sendNoticeMessage/config.js
cp cloudfunctions/saveNoticeSubscriber/config.example.js cloudfunctions/saveNoticeSubscriber/config.js

然后在这些本地配置文件中填入自己的 AppID、云环境 ID 和订阅消息模板 ID，再使用微信开发者工具打开项目并部署云函数。

AI 快速发布通过 parseNoticeWithAI 云函数调用兼容 /chat/completions 的服务。需要在云函数环境变量或服务端配置中设置 AI_API_KEY、AI_BASE_URL 和 AI_MODEL；这些值不要写入小程序前端代码，也不要提交到仓库。

完整部署步骤见 docs/deploy.md。

数据与安全

班级盒子依赖微信云开发数据库。你需要自行创建以下集合：

• notices
• users
• admin_invite_codes
• class_members
• subscribers
• favorites
• feedbacks
• security_counters
• ai_usage_logs
• operation_logs

数据库字段说明见 docs/database.md，权限建议见 docs/database-permissions.md。

部署前的隐私和权限配置建议见 docs/security.md。

技术说明

项目由微信小程序前端和微信云函数组成。

miniprogram/      # 小程序页面、样式和配置
cloudfunctions/   # 权限校验、事项管理、订阅提醒等云函数
docs/             # 部署、数据库和安全文档

主要云函数包括：

• checkAdmin：检查当前用户认证状态和权限。
• verifyMember：完成班级成员身份认证。
• createNotice / updateNotice / deleteNotice：管理事项。
• updateNoticePin：更新置顶状态。
• parseNoticeWithAI：将管理员输入的一句话解析为事项草稿。
• saveNoticeSubscriber / sendNoticeMessage：保存订阅授权并发送提醒。
• applyAdminInvite：处理管理员邀请码。
• submitFeedback / listFeedbacks：提交意见反馈，并供超级管理员查看反馈列表。

内容安全检测在 createNotice、updateNotice 和 parseNoticeWithAI 等云函数内部执行，不依赖独立的前端校验作为安全边界。

当前限制

• 项目依赖微信小程序和微信云开发环境。
• 页面交互需要在微信开发者工具或真机中测试。
• 班级成员名单、邀请码和订阅消息模板需要部署者自行配置。
• AI 快速发布只生成文字草稿，首版不自动生成图片、附件或链接；最终发布仍需要管理员确认。
• 意见反馈首版只支持提交和超级管理员只读查看，不提供回复、删除、处理流转或导出。

反馈

如果你发现问题，或有适合班级场景的新想法，可以在 GitHub Issues 中提出。

许可证

本项目采用 MIT 许可证。详见 LICENSE。