万趣小程序_系统开发案例-程序员客栈

技术信息

语言技术
Python、postgres、Docker、Vue、小程序系统类型
小程序轻应用行业分类
生活旅游

作品详情

行业场景

目的地定制游行业的线上内容长期分散在朋友圈、微信群、Excel报价表和客服手机中。运营修改首页轮播、线路卖点常需开发发版，前台展示与运营维护版本不一致；售前咨询依赖人工转述，用户截图给顾问后，顾问再追问日期、人数、行李、用车偏好，线索散落聊天记录，无法统计、分派、跟进和复盘丢单。

WonderQ 的立项目标，是把“内容靠人工、线索靠聊天、权限靠自觉”的流程产品化：运营不写代码即可自助维护前台内容；用户在小程序/H5 内完成浏览玩法、查看路线详情、联系顾问、提交出行需求的闭环；每条线索进入后台可检索、可流转、可审计的状态机；后台按角色、部门、数据范围控制权限；一套前端同时覆盖 H5 与微信小程序，后台采用标准 RBAC 与审计，并保持后端契约稳定兼容。

业务场景有五个特征：
1. 内容即商品。首页轮播、玩法分类、路线卡片、路线详情、团队共创、客片案例、顾问资料共同构成决策材料，任何过期内容都会影响转化，必须由运营高频、低门槛维护。
2. 顾问是转化关键。价格区间、行程亮点、费用包含与不含、注意事项，以及顾问头像和二维码，都需后台可配置、前台可一键触达。
3. 线索形态多样。普通咨询允许游客提交；用车需求必须登录，记录服务类型、车型快照、出行日期、上下车地点、人数和行李数。后台按新建、已分配、已联系、方案中、已成交、无效跟进。
4. 用户回访需归并。同一用户重复浏览同一条路线或案例，应合并为一条记录并更新时间；用户只能查看自己的提交记录，联系方式必须脱敏。
5. 多端交付。移动端以微信小程序和 H5 为主，后台为桌面端，共用同一套后端数据和契约，接口风格与响应结构需稳定兼容。

综上，WonderQ 是面向定制游的内容运营、线索转化与权限审计一体化平台，通过内容自助化、咨询闭环化、线索状态化、权限精细化、多端统一化，解决小团队试错中的重复开发与流程失控问题。

功能介绍

WonderQ 按三端拆分：前台负责获客留资，后台负责内容运营与线索管理，后端提供统一鉴权、权限、审计和媒体能力。

一、H5/微信小程序前台
首页：轮播、玩法推荐、用车卡片与需求入口、团队共创、极境视界。
玩法：分类导航+路线卡片，可带关键词进入需求页。
路线详情：行程概览、亮点、费用包含/不含、注意事项、图集、参考价、关联顾问。
管家：顾问列表、服务原则、联系弹层与二维码。
共创/客片：列表与详情，详情异步写入浏览历史。
我的：游客/登录态区分、用车提交、提交记录与只读详情、历史浏览。
认证与需求：微信手机号登录、通用线索提交、带 JWT 的用车需求提交。

二、运营后台
登录会话：图形验证码、记住我、Token 刷新、退出。
工作台：统计概览、最近线索。
首页工作台：轮播、用车卡片、玩法推荐、团队共创、极境视界维护与排序。
内容领域：玩法分类/路线、路线详情/参考价、顾问资料、共创正文、客片图集。
线索：按类型、状态、关键词筛选，分页、状态流转、详情弹窗。
媒体：OSS 图片上传、素材库分页。
系统管理：用户、角色、菜单、部门、角色数据范围授权。
布局权限：RuoYi 风格侧栏、多页签、按钮级权限、动态路由。

三、后端 API
Public API：站点配置、首页内容、玩法分类/路线、路线详情、顾问展示、客户登录、线索提交、用车记录、浏览历史。
Admin API：登录会话、动态路由/菜单、用户角色菜单部门、工作台、站点模块 CRUD/排序、内容 CRUD/排序、线索查询与状态更新、媒体上传与素材分页。
公共能力：统一响应、JWT、RBAC 与数据范围、审计日志、验证码、Redis 会话与限流、微信手机号登录、OSS 地址处理、Alembic 迁移与初始化数据.

整体形成“前台浏览留资、后台运营跟进、后端统一治理”的功能闭环。

项目实现

采用“契约先行、页面驱动”的三端分离架构。主要任务：维护三端契约；实现后端模型与Alembic迁移、Public/Admin双域API、JWT/RBAC/审计/Redis/微信登录/OSS；搭建RuoYi风格后台及内容、线索、系统管理；开发前台首页、玩法、详情、管家、我的等页面；完成测试、联调与构建。
技术栈：MiniAPP用uni-app、Vue3、TS、Tailwind、z-paging；后台用Vue3、TS、Vite、Element Plus、Pinia；后端用FastAPI、SQLAlchemy2、Alembic、PostgreSQL、Redis、JWT、Pydantic、OSS。响应统一code/msg/data，Public API服务H5/小程序，Admin API用Bearer Token。
亮点：契约文档为唯一事实源；管理员短令牌+Cookie刷新轮换，客户独立JWT；验证码哈希、一次性、限流；动态路由组件白名单；稳定UUID；OSS地址治理；客户数据隔离、手机号脱敏、浏览历史去重；多端类型与归一化统一。
难点：跨端字段同步；历史模块迁移清理；小程序/H5差异；排序、单例、删除冲突；权限缓存一致性；三端联调回归成本高。