v0.1.0 — 校园枢纽 · HKUST(GZ) 首个正式版

v0.1.0 — 校园枢纽 · HKUST(GZ) 首个正式版

🌐 在线访问

👉 https://ust.hhuang999.top —— 免安装,直接点击打开即可使用。

源码与本 Release 见仓库主页:https://github.com/hhuang999/ust-inform-trade-cff

---

这是什么

校园二手交易 / 服务 / 需求撮合市场的第一个公开发布版本。本仓库 main 分支线性历史首个 Release。

一个面向港科大(广州)校园社区的交易市场应用,三条产品线:

• 物品(items):发布、图片多图、列表筛选、详情、买卖双方确认完成、订单中心
• 服务(services):发布(时长档位)、撮合、预约、状态机流转
• 需求(needs):发布、撤回、意向人评分、撮合

外加完整的信任与运营闭环:实名学生证审核、信誉标签、评价、举报、违规管理后台、通知中心(含未读角标)、Cron 超时自动完成。

技术栈

• Next.js 16(App Router)+ React 19 + TypeScript
• Prisma 7 + PostgreSQL(生产用 Neon,PrismaPg 驱动适配器)
• Auth.js v5(Credentials + JWT,bcryptjs)
• Cloudflare R2(头像 / 学生证 / 物品图,浏览器预签名 PUT 直传)
• Tailwind CSS 4 / shadcn 风格组件 + 纸感设计系统
• Vitest 单测
• 部署:Vercel(cron 见 vercel.json);亦可自托管(见 README)

本次发布亮点

• 三产品线数据模型与状态机(物品 / 服务 / 需求 / 撮合 / 预约 / 评价 / 举报 / 违规)
• 订单中心 + 通知中心 + 首页真实区块
• 评价 / 举报 / Cron / 管理后台(审核、违规处理)
• 信誉标签(列表卡片 + 卖家意向人评分 / 点击时间)
• R2 浏览器预签名直传(POST policy → PUT,适配 R2)
• Auth.js 登录 / 注册 + 登出 server action
• 学生证实名提交 + 管理端审核(通过 / 驳回 + 通知)
• Prisma 查询瞬时错误重试(消除 Neon 冷启动首屏 ETIMEDOUT 500)
• 物品编辑保存修复(price / originalPrice 接受 null)
• 全产品冒烟手册 + 纸感视觉设计系统

自托管 / 部署

详见仓库 README.md。要点:

• 环境变量见 .env.example(DATABASE_URL / AUTH_SECRET / R2_* / ADMIN_EMAIL / CRON_SECRET)。
• 一键 Vercel:Fork → 导入 → 填环境变量 → Deploy。
• 本地开发:pnpm install → 配 .env.local → pnpm db:migrate → pnpm seed:admin → pnpm dev。

子路径部署(如校园沙箱 /apps/<name>)见 boxset 分支。

---

Full Changelog: git log main · 线性历史。