Skip to content
0AntiquePublic

About

HEU-Crush哈尔滨工程大学同校dating社区。Vibe Coding项目,正在校园推广中~

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

HEUCrush

HEUCrush 是仅面向哈尔滨工程大学学生的同校恋爱与交友网站。项目采用独立原创的产品设计;docs/zzudate-* 只记录对 zzudate.com 公开页面与匿名流程的黑盒观察,不包含其源代码、私有接口、数据库或受保护素材。

已实现

  • @hrbeu.edu.cn 校园邮箱一次性注册验证、scrypt 密码哈希、密码登录与验证码找回密码。
  • HttpOnly 不透明会话 Cookie、双提交 CSRF、会话撤销与最多设备数限制。
  • 18+ 注册引导、资料、关系期待、年龄/性别偏好和 30 个兴趣标签。
  • JPG/PNG 内容签名校验,Sharp 生成缩略图、卡片图和大图,S3/MinIO 存储。
  • 北京时间每日中午仅推荐一人,双向偏好与关系目标筛选、7 天有效心意、互相喜欢原子匹配与通知。
  • REST 消息历史、幂等消息发送、已读状态、Socket.IO + Redis Adapter 实时聊天。
  • 拉黑、解除匹配、举报、通知、账号 7 天删除冷静期和自动去标识化。
  • 管理员举报队列、用户暂停/封禁、照片治理与不可变更的操作审计记录。
  • 心意页展示喜欢者的公开资料并支持喜欢或婉拒,单向喜欢即时通知;同一时间只专注一个匹配。
  • 注册必填微信号或手机号并加密保存;双方独立同意后通过同一事务同时交换联系方式,最低专注期 7 天。
  • 隐私政策、用户协议、安全中心、移动端底部导航和响应式桌面界面。
  • MySQL 8、Redis、MinIO、Mailpit 本地环境;Caddy 自动 HTTPS 的生产 Compose。

技术栈

  • Web:Next.js 16、React 19、TypeScript、Tailwind CSS 4、Lucide、Socket.IO Client。
  • API:NestJS 11、Prisma 6、MySQL 8、Redis、Socket.IO、Sharp、SMTP、S3-compatible storage。
  • 交付:pnpm Monorepo、Docker 多阶段镜像、Docker Compose、Caddy HTTPS。

本地启动

需要 Node.js 22+、pnpm 11+ 和 Docker Desktop/Engine。

Copy-Item .env.example .env
docker compose up -d
pnpm install --frozen-lockfile
pnpm prisma:generate
pnpm prisma:migrate:deploy
pnpm seed
pnpm dev

打开 http://localhost:3000。本地 .env 可将 DEV_AUTH_BYPASS=true,注册或找回密码的验证码会在 API 响应中返回;生产环境会硬性拒绝该开关。.env 中 ADMIN_EMAIL 对应的校园邮箱完成注册后会自动获得管理员权限,并可访问 /admin。

本地基础服务端口由 .env 控制;示例默认使用 MySQL 3306、Redis 6379、MinIO 9000/9001、Mailpit 8025。端口冲突时可改用其他宿主机端口(当前开发环境使用 MySQL 3307、Redis 6380)。

验证

pnpm typecheck
pnpm lint
pnpm test
pnpm --filter @heucrush/api test:e2e --runInBand
pnpm build
$env:ENV_FILE = '.env.production.example'
docker compose --env-file .env.production.example -f docker-compose.prod.yml config
Remove-Item Env:ENV_FILE

API 运行后可执行 node scripts/business-e2e.mjs,用两名随机虚构校园邮箱完成照片、互赞、匹配、Socket 实时消息、MySQL 历史、举报、拉黑、删除冷静期和管理员治理闭环。该脚本只允许在 DEV_AUTH_BYPASS=true 的隔离开发环境运行。

生产部署

参见 deploy/README.md。复制 .env.production.example 为 .env.production,设置真实域名、独立随机密钥和可向校园邮箱投递的 SMTP 账号,然后:

docker compose --env-file .env.production -f docker-compose.prod.yml up -d --build

生产部署前仍需要外部资源:域名/DNS、公开服务器、SMTP 凭据,以及按需选择的对象存储账号。仓库不会提交这些密钥。

设计与审计文档

About

HEU-Crush哈尔滨工程大学同校dating社区。Vibe Coding项目,正在校园推广中~

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages