VLoop/README.md

feedsystem_video_go

基于 Go + Vue 3 的短视频 Feed 系统，含账号、视频、点赞、评论、关注、Feed 流，支持 Redis 缓存与 RabbitMQ 异步 Worker（API 与 Worker 可拆分部署）。

功能

模块	功能
账号	注册/登录/改名/改密/登出，头像上传，个人简介，Refresh Token 双 Token 鉴权
视频	上传/发布/删除，按作者查看，详情（三级缓存），#话题标签
点赞	点赞/取消/是否已赞/已赞列表，SSE 实时通知
评论	发布/删除/列表，@提及 通知
关注	关注/取关/粉丝列表/关注列表/粉丝计数，SSE 实时通知
Feed	最新/点赞榜/热度榜/关注流/话题标签流，冷热分离+游标分页，虚拟滚动
私信	发送/对话列表
通知	SSE 实时推送，未读计数，已读标记

Docker Compose 一键启动

docker compose up -d --build

访问：

• 前端：http://localhost:5173
• 后端 API：http://localhost:8080
• RabbitMQ 管理台：http://localhost:15672（admin / password123）

默认 .env 自动生成 JWT 密钥。生产环境请修改 JWT_SECRET。

测试数据

启动后内置 100 个测试用户（user001 ~ user100，密码均为 123456），user001 已发布视频并拥有粉丝/点赞数据。

本地开发

# 启动依赖
docker compose up -d mysql redis rabbitmq

# 后端
cd backend
CONFIG_PATH=configs/config.compose-local.yaml go run ./cmd

# Worker
CONFIG_PATH=configs/config.compose-local.yaml go run ./cmd/worker

# 前端
cd frontend
npm install && npm run dev

接口清单

账号 /account

方法	路径	鉴权	说明
POST	/register	否	注册（限流 5次/时/IP）
POST	/login	否	登录，返回 access_token + refresh_token
POST	/refresh	否	刷新 access_token（用 refresh_token）
POST	/changePassword	否	改密码（需旧密码）
POST	/findByID	否	按 ID 查用户
POST	/findByUsername	否	按用户名查
POST	/getProfile	否	用户主页（视频数/获赞/粉丝数）
POST	/logout	JWT	登出（同时失效双 token）
POST	/rename	JWT	改名
POST	/uploadAvatar	JWT	上传头像（jpg/png/webp，≤10MB）
POST	/updateProfile	JWT	更新简介/头像

视频 /video

方法	路径	鉴权	说明
POST	/publish	JWT	发布视频（自动提取 #话题）
POST	/uploadVideo	JWT	上传视频文件（mp4，≤200MB）
POST	/uploadCover	JWT	上传封面（jpg/png/webp，≤10MB）
POST	/listByAuthorID	否	按作者查视频
POST	/getDetail	否	视频详情（三级缓存）

点赞 /like

| POST | /like | JWT | 点赞 | | POST | /unlike | JWT | 取消点赞 | | POST | /isLiked | JWT | 是否已赞 | | POST | /listMyLikedVideos | JWT | 我赞过的视频 |

评论 /comment

| POST | /listAll | 否 | 评论列表（分页200，按时间升序） | | POST | /publish | JWT | 发布评论（支持 @username 提及） | | POST | /delete | JWT | 删除评论 |

关注 /social

| POST | /follow | JWT | 关注 | | POST | /unfollow | JWT | 取关 | | POST | /getAllFollowers | JWT | 粉丝列表（含粉丝数） | | POST | /getAllVloggers | JWT | 关注列表（含关注数） | | POST | /getCounts | JWT | 粉丝/关注计数 |

Feed /feed

| POST | /listLatest | 软鉴权 | 最新视频（游标分页） | | POST | /listLikesCount | 软鉴权 | 点赞排行（复合游标） | | POST | /listByPopularity | 软鉴权 | 热度榜（快照分页） | | POST | /listByFollowing | JWT | 关注流 | | POST | /listByTag | 软鉴权 | 按 #话题 浏览 |

通知 /notification

| GET | /stream?token= | 是 | SSE 实时推送 | | POST | /list | 是 | 通知列表 | | POST | /markRead | 是 | 标记已读（传 id 单条，不传全标） | | POST | /unreadCount | 是 | 未读计数 |

私信 /message

| POST | /send | JWT | 发送私信 | | POST | /list | JWT | 对话列表 |

环境变量

变量	默认值	说明
JWT_SECRET	feedsystem-dev-secret-key	JWT 签名密钥，生产须改
MYSQL_ROOT_PASSWORD	123456	MySQL root 密码
REDIS_PASSWORD	123456	Redis 密码
RABBITMQ_USER / RABBITMQ_PASS	admin / password123	RabbitMQ 账号

详见 .env.example。