景区打卡,定位+指定随机手势
打卡集齐美食 or 景点徽章
使用徽章购买文创享受折扣
文创购买
非遗文化活动预约
二维码预约核销
客户端和管理端均有订单管理系统
技术栈
后端(Backend)
框架: FastAPI 0.115.6 + Uvicorn
数据库: PostgreSQL(通过 SQLAlchemy ORM)
认证: JWT(python-jose)+ 密码加密(passlib/bcrypt)
微信集成: 微信小程序登录、支付接口
AI 能力: 百度 AI SDK(手势识别功能)
工具: 二维码生成(qrcode + Pillow)、HTTP 客户端(httpx)
前端 - 微信小程序(Client-User)
语言: TypeScript(ES5 编译目标)
框架: 微信小程序原生框架
样式: SCSS
编译: 支持 TypeScript 编译、热重载(compileHotReLoad)
特性: 多框架运行时、API Hook、隔离上下文
管理端(Client-Admin)
形式: 纯 HTML 静态页面(无 package.json,说明不是 Node.js 项目)
技术: 原生 HTML/CSS/JavaScript
部署: 挂载在 FastAPI 的 /admin 路由下
功能: 非遗管理、商品管理、订单管理、用户管理、手势配置测试
数据库模型
WechatUser(微信用户)
UserAddress(收货地址)
HeritageActivity/Session/Booking(非遗体验)
Product(商品)
Order(订单)
UserBadge(徽章)
Collection(收藏)
Checkin(打卡记录)
部署架构
后端: 运行在 5678 端口,支持热重载
数据库: PostgreSQL 15432 端口
管理后台: 通过 FastAPI 静态文件挂载
微信小程序: 独立编译部署