双击就能跑的 H5 基座:用户端、后台和租户都在一个仓库里

0 阅读3分钟

做活动页或轻量业务 H5,重复劳动通常不是页面本身,而是登录、公告、上传、订单,再加上一个能改配置的后台。这些每次都从空项目接,时间都耗在脚手架上。

h5-python-template 把用户端、管理后台和 Django 接口放在一个仓库里。Windows 下双击 start.bat,三个服务一起起来,种子账号可以直接点通主要流程。

仓库地址:github.com/wangyu-oss/…

用户端打开就是一页登录

H5 跑在 http://localhost:5173 。密码登录、短信验证码、游客、微信授权和本机号码都留在同一页。开发环境已经填好演示账号,同意协议后就能进首页。

h5-login.png

不在微信里点「微信授权」,页面会提示请在微信中打开。短信在开发环境把验证码放进接口响应,本机不用先买短信套餐。

用普通用户 zhangsan / 123456 登录后,首页会拉后台配好的标题、轮播和公告。后台改完,刷新这里就能看到。

h5-home.png

底部是首页、公告、消息和我的。消息上的数字是未读站内信。我的页面里可以换浅色或深色、切换简体、繁体和英文,也可以进入上传、海报、表格、签到和问卷。

管理后台看的是另一套页面

管理后台在 http://localhost:5174 ,接口在 http://localhost:8010 。本地默认 SQLite,不需要先装 Redis 或 PostgreSQL。

端地址演示账号
H5http://localhost:5173zhangsan / 123456
管理后台http://localhost:5174admin / 123456
租户管理员同一后台tenant / 123456

这三个密码只用于本机种子数据。注册、找回和修改密码要求至少 8 位,并且同时包含字母和数字。

admin 登录后进的是工作台。上面能看到用户、订单、已支付和埋点,下面是趋势和待处理事项。顶栏可以按客户筛选。

admin-dashboard.png

左侧已经放进日常会改的菜单:客户、用户、角色、菜单、轮播、公告、订单、消息模板、配置、字典和文件。

给新客户单独开一份数据

平台超管可以新建客户。客户有自己的名称和编码,编码全平台唯一。顶栏切换到某个客户之后,再创建的用户和角色会落在这个客户下面。租户管理员只能看到自己这一份用户、订单、内容和日志。

admin-tenants.png

图里的「默认客户」是种子租户,编码 default。旧数据归在这里。超管不选客户时看全部。

现在就能改的部分

本地直接可用的包括:

  • 账号密码、短信验证码、游客、注册、找回密码和注销
  • 角色、菜单和按钮权限,H5 和后台共用一套权限码
  • 轮播、公告、字典、省市区和系统配置
  • 上传、分片合并、站内信、模拟支付和订单超时关闭
  • 埋点、前端异常、IP 黑名单、签到和问卷

微信、支付宝、云短信、邮件和 MinIO 都有入口。把 python/.env.example 复制成 python/.env,填上对应密钥,再在后台配置里切换渠道。缺少商户参数时,支付不会把订单标成已支付。阿里云 OSS 和腾讯云 COS 还要补官方 SDK。直播、OCR、电子合同不在这套模板里。

本机跑起来

需要 Python 3.10 以上和 Node.js 18 以上。双击仓库根目录的 start.bat,停止用 stop.bat。

起来之后看三个地址:

代码、启动说明和演示账号都在仓库里:github.com/wangyu-oss/…