# 元智校友网 (Alumni Connect) - 完整版

> 面向中国学生群体的校友社交网络（13-22 岁）。找同学、办聚会、沉淀共同记忆。

## 产品定位

中国学生群体（13-22 岁，初中到研究生）的校友社交平台。区别于通用社交（微信/微博），专注"同校同专业"的精准连接 + 班级共建。

## 核心场景

### 1. 找同学
用户搜索"中国科学院大学" → 看到这所大学的班级列表 → 申请加入"高能所2011级" → 加入后看到 8 位同学 → 进入 PublicProfile → 点"💬 发起私聊" → 调 im-bot partner API 在 im-bot 创建两人 room → 返回 joinUrl → 前端跳转到 im-bot.online 私聊

### 2. 办聚会
班级管理员在 ClassDetail 创建活动 → 填写时间地点 → 自动同步 im-bot 群 → 同学在 Events 看到 → 报名 → 活动当天签到

### 3. 沉淀记忆
班级相册（cover_url、成员共创）、动态（vlog + 图文 + 活动 tag）、课程评价（学长给学弟留下参考）、学长问答（高中生问大学怎么样）

## 主要功能模块

- **搜索大学 + 同学**：双 tab，同学搜索只返回跟当前用户有交集的人（隐私）
- **班级管理**：创建/编辑/加入/退出/管理员/相册/动态/活动
- **积分系统**：每日签到（连签奖励）+ 商城兑换（实物/虚拟卡密）+ 流水
- **im-bot 集成**：partner API 把 im-bot 群聊作为班级消息通道，私聊作为同学 1v1 通道
- **未成年人保护**：13 岁以下拒绝注册、13-14 岁强制家长同意、13-17 岁单日积分上限、夜间模式

## API 端点

### Auth
- POST /api/auth/register
- POST /api/auth/login
- POST /api/auth/login-sms (手机号+验证码)
- GET /api/auth/me
- PATCH /api/auth/me
- DELETE /api/auth/me
- POST /api/auth/sso/imbot-token

### Cohorts (班级/圈子统一)
- GET /api/cohorts?school=X&major=Y&year=Z — 列学校下班级
- GET /api/cohorts/mine — 我加入的班级
- GET /api/cohorts/:id — 班级详情 (成员限定)
- POST /api/cohorts/:id/join — 申请加入
- POST /api/cohorts/:id/photos — 上传班级照片

### Search
- GET /api/schools/search?q=xxx — 搜学校（公开）
- GET /api/users/search?q=xxx — 搜同学（仅限交集：follows 双向 + 共同 group）

### Points
- GET /api/points/balance
- POST /api/points/checkin — 每日签到（10/20/30/40/50 分）
- GET /api/points/checkin/status
- GET /api/shop/items
- POST /api/shop/redeem

### IM (im-bot 集成)
- POST /api/imbot/dm — 发起 1v1 私聊（调 im-bot partner API）

### Follows
- POST /api/follows — 添加联系人
- DELETE /api/follows/:targetId
- GET /api/follows/:userId — 关注列表 + my_view

### QA (学长问答)
- POST /api/qa/questions — 提问（消耗 5 分）
- POST /api/qa/answers — 回答（得 15 分）

## 技术栈

- 前端：Vue 3 + TypeScript + Vite (SPA)
- 后端：Node.js + Express + TypeScript
- 数据库：PostgreSQL（primary）+ SQLite（兼容）
- 缓存：无（轻量级）
- 搜索：PostgreSQL ILIKE + 索引
- 鉴权：JWT (HS256, 7 天)
- 即时通信：partner im-bot（不自建）
- 部署：Docker + NAS 容器

## 隐私边界

- 同学列表 = 必须加入班级才可见（GET /api/cohorts/:id/members 需 auth + member）
- 同学搜索 = 仅返回有交集的人（follows 双向 + 共同 group）
- 私聊消息 = 100% 走 im-bot，校友网不存任何聊天内容（合规）
- 用户隐私字段 (email/phone) 不暴露在公开 profile

## 关键合规

- PIPL 第 31 条：13 岁以下拒绝注册、强制生日
- 未保法 72-74 条：13-17 岁单日积分上限、夜间模式
- 民法典 8/14/18 岁分界：分级合规处理

## 联系

- 官网 https://xiaoyou.3.14pi.cn
- im-bot https://im-bot.online
- ICP 备案 京ICP备2026043547号-3