CampusShot 产品文档（V1.0）

1. 产品定位

CampusShot 是一个面向校园摄影赛的「参赛+评审+社交」一体化平台，支持用户发布作品、互动聊天、管理员审核，以及 AI 辅助评审与创作引导。

2. 目标用户

1. 参赛学生：发布作品、查看状态、互动交流。
2. 评审/管理员：审核作品、管理用户、查看日志和趋势。
3. 运营方：配置赛题主题、查看数据表现。

3. 核心价值

1. 降低参赛门槛：发布流程简单，前期可用图片链接替代真实上传。
2. 提升评审效率：AI 初筛 + 盲审一致性助手减少人工负担。
3. 提升参赛质量：AI 讲解卡片和赛题匹配给出可执行建议。
4. 增强活跃度：点赞、评论、好友、私聊等社交能力。

4. 功能范围

4.1 用户端（/nss.html）

1. 登录注册（独立页 /auth.html）
2. 首页作品流：点赞、评论、查看详情
3. 发布抽屉：标题、院系、创作说明、封面链接、预览
4. 作品状态管理：已通过/待审核/已驳回筛选
5. 私聊系统：用户间会话、未读、置顶、图片消息、撤回
6. 好友系统：搜索、申请、同意/拒绝
7. 个人主页：头像上传、资料编辑
8. 通知中心：评论/点赞/好友申请等通知
9. AI 客服助手（悬浮可拖动）

4.2 管理端（/admin.html）

1. 数据总览：投稿趋势、待审量、统计卡片
2. 作品审核：通过/违规/批量通过
3. 用户管理：启用禁用、重置密码（123456）、批量操作
4. 挑战赛配置：主题+截止日期
5. 操作日志：查询+导出 CSV
6. AI 审核工具：
   • AI 初筛（分项评分+建议结论）
   • AI 盲审一致性助手（标签/风险点/评语模板）

5. AI 能力（四阶段已完成）

1. 阶段1：AI 初筛（Admin）
2. 阶段2：AI 作品讲解卡片（详情页，一键复制文案）
3. 阶段3：AI 赛题匹配（发布前推荐赛道+匹配理由+标题建议）
4. 阶段4：AI 盲审一致性助手（统一评审口径）

6. 关键业务流程

1. 用户登录 -> 发布作品 -> 进入审核状态
2. 管理员审核 -> 通过后进入公开流
3. 用户在公开流互动（点赞/评论/私聊）
4. 发布/审核环节均可使用 AI 辅助

7. 关键接口（示例）

1. POST /api/posts 发布作品
2. GET /api/posts/{id}/detail 作品详情
3. POST /api/posts/{id}/like-toggle 点赞切换
4. POST /api/ai/track-match AI 赛题匹配
5. GET /api/posts/{id}/ai-insight AI 讲解卡片
6. GET /api/admin/reviews/{id}/ai AI 初筛
7. GET /api/admin/reviews/{id}/blind-assistant 盲审助手
8. POST /api/chat/messages 用户私聊发送

8. 非功能要求

1. 端口：8081
2. 数据库：MySQL（本地）
3. 模型配置：DASHSCOPE_API_KEY（可选，不配走本地规则）
4. 移动端适配：支持（响应式）

9. 运行方式

cd "/Users/jianhuaduan/Documents/New project"
export DASHSCOPE_API_KEY=你的key   # 可选
java -jar target/campusshot-web-0.0.1-SNAPSHOT.jar --server.port=8081

页面入口：

1. 用户端：http://localhost:8081/nss.html
2. 管理端：http://localhost:8081/admin.html
3. 登录页：http://localhost:8081/auth.html

10. 验收标准

1. 用户可完成发布、互动、聊天、好友添加全流程。
2. 管理员可完成审核、用户管理、日志导出。
3. 四项 AI 能力可在页面中直接触发并返回结果。
4. 无编译错误，JAR 可本地启动并访问。