河马照相馆属于“AI影像生成 + 微信生态消费闭环”类项目，面向儿童成长照、亲子写真、节日主题照、创意模板照等轻量化影像场景。相比传统影楼依赖人工修图、重交付、低频复购的模式，该项目将影像服务标准化为“模板浏览 - 照片上传 - AI生成 - 在线充值 - 社交分享”闭环，降低了内容生产成本和用户使用门槛。项目特别适合母婴儿童摄影、私域流量运营、节日活动营销、模板化内容售卖等业务场景，通过“胶卷”虚拟资产体系承载次数消费，通过邀请码赠送和分享传播增强拉新与留存能力，具备较强的微信内转化效率和裂变传播属性。
项目在用户侧形成了完整的微信端体验链路。用户首次进入小程序后，可通过微信手机号快捷登录，系统自动建立用户资产与身份信息；首页支持按年龄段筛选模板、查看可用胶卷、过滤已生成模板，并以分页方式浏览模板库。进入模板详情后，用户可查看多张预览图、识别模板是否曾使用，并基于“重新选图”或“使用上次照片”发起生成。生成前系统会校验胶卷余额，不足时直接拉起充值流程；充值支持小程序内微信支付，同时提供 H5 JSAPI 支付页作为补充支付入口。生成任务提交后，用户可以在生成详情页实时查看多张结果图的完成状态，并在全部生成完成后批量保存到相册。除此之外，项目还提供充值订单查询、个人中心、头像更新、邀请码兑换免费胶卷、领取记录查看等能力。后台侧则覆盖模板管理、预览图维护、商品管理、用户与资产查询、人工补胶卷、订单与支付流水追踪、生成记录检索、分享记录与免费领取记录分析，满足运营、客服和内容维护的实际需求。
项目采用“多端前端 + Go 微服务后端”的实现方案。前端层由 Taro + React 构建微信小程序主应用，承载模板浏览、登录、支付、上传与生成交互；React + Vite 构建独立 H5 支付页，用于微信内 JSAPI 补充支付场景；React + Vite + Ant Design 构建后台管理系统，支持运营配置和数据审计。后端以 Gin 提供统一 HTTP API，对外封装认证、模板、生成、支付、上传、资产、后台管理等接口；内部再拆分为 Generate、Recharge、Payment、Upload、OSS 等 gRPC 服务，实现职责解耦。数据层使用 MySQL 存储用户、模板、预览图、生成记录、订单、支付流水、资产流水等核心实体，并通过读写分离模式支撑查询与事务写入；Redis 用于登录态、微信 access_token 等缓存。技术上最核心的是生成链路：一次模板生成会按预览图拆分成多条记录，先在事务内完成胶卷扣减与资产流水落账，再异步提交到生成服务队列；生成服务调用 Coze 工作流执行图像合成，将结果回传并落 OSS，API 服务再基于批次号聚合展示状态。为保证业务可靠性，系统对支付回调做签名校验，对生成失败做按张粒度退款补偿，并通过资产流水唯一约束实现幂等控制；同时配有关闭过期订单的定时任务，以及基于 SSH、迁移校验、systemd 重启和失败回滚的发布机制，兼顾了可维护性与线上稳定性。
评论