04 / The Circular Net
Circular Ticket
一款活动与票务产品:参与者发现活动并购票;主办方创建活动、在入口扫码验票,并以 NGN 或 USD 收款。
- 公司
- The Circular Net
- 角色
- 独立负责 Web 前端
- 时间
- 2026年3月 – 至今已上线
- 链接
- 访问网站
- 技术栈
- Next.jsReact 19TypeScriptTailwind CSSnpm workspacesTanStack QueryTanStack TableRedux ToolkitZodStripe
04
Circular Ticket
活动与票务:网站 + Web 应用
Next.jsReact 19TypeScriptTailwind CSS
截图即将上线
我做了什么
- 01带 SEO 元数据、站点地图和 OG 图片的公开活动页
- 02多步骤活动创建向导:日程、票种、嘉宾和混合场地
- 03浏览器扫码验票、扫码中心和工作人员扫码权限
- 04NGN/USD 钱包、交易记录、收款账户和提现申请
- 05五步 KYC 流程和主办方认证设置
- 06面向主办方的订单、报名统计和表格导出
系统
两个应用,一个共享包
关键决策
- 01
共享逻辑,不共享界面
共享包里是服务、hooks、schema 和规则。界面在每个平台保持原生,两个应用都不像对方的移植版。
- 02
一条规则,只放一处
提现资格、订单状态映射和货币格式化都只存在一份。Web 和移动端在钱的问题上不可能不一致。
- 03
为每个状态做设计
加载、出错、筛选后为空和真正为空,在每个数据页面都是不同的状态。信息密集的主办方后台因此清晰了很多。
01
问题
主办方需要一个地方完成发布活动、售票、签到、身份验证和收款。而 Web 与移动应用各自重复 API 调用和业务规则,正在慢慢分化。
02
过程
我先做了 Web 应用,然后把它和新的 Expo 应用一起迁入基于 npm workspaces 的 monorepo。服务、查询 hooks、校验 schema,以及货币格式化、提现资格等规则都移入一个共享包;界面仍按平台各自实现。每个领域(活动、订单、钱包、提现、KYC 和扫码)都对接了线上 API,包括 Stripe 入驻和银行提现。
03
成果
Web 应用已上线 circularticket.com。两个应用引用同一套服务与规则,比如“何时可以申请提现”这样的改动只需要做一次。
04
收获
共享代码首先是依赖问题,其次才是代码问题。版本对齐和对 Web 与原生之间 hoisting 的谨慎处理,比共享代码本身更重要。