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_FILEAPI 运行后可执行 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 凭据,以及按需选择的对象存储账号。仓库不会提交这些密钥。