做活动页或轻量业务 H5,重复劳动通常不是页面本身,而是登录、公告、上传、订单,再加上一个能改配置的后台。这些每次都从空项目接,时间都耗在脚手架上。
h5-python-template 把用户端、管理后台和 Django 接口放在一个仓库里。Windows 下双击 start.bat,三个服务一起起来,种子账号可以直接点通主要流程。
用户端打开就是一页登录
H5 跑在 http://localhost:5173 。密码登录、短信验证码、游客、微信授权和本机号码都留在同一页。开发环境已经填好演示账号,同意协议后就能进首页。
不在微信里点「微信授权」,页面会提示请在微信中打开。短信在开发环境把验证码放进接口响应,本机不用先买短信套餐。
用普通用户 zhangsan / 123456 登录后,首页会拉后台配好的标题、轮播和公告。后台改完,刷新这里就能看到。
底部是首页、公告、消息和我的。消息上的数字是未读站内信。我的页面里可以换浅色或深色、切换简体、繁体和英文,也可以进入上传、海报、表格、签到和问卷。
管理后台看的是另一套页面
管理后台在 http://localhost:5174 ,接口在 http://localhost:8010 。本地默认 SQLite,不需要先装 Redis 或 PostgreSQL。
| 端 | 地址 | 演示账号 |
|---|---|---|
| H5 | http://localhost:5173 | zhangsan / 123456 |
| 管理后台 | http://localhost:5174 | admin / 123456 |
| 租户管理员 | 同一后台 | tenant / 123456 |
这三个密码只用于本机种子数据。注册、找回和修改密码要求至少 8 位,并且同时包含字母和数字。
admin 登录后进的是工作台。上面能看到用户、订单、已支付和埋点,下面是趋势和待处理事项。顶栏可以按客户筛选。
左侧已经放进日常会改的菜单:客户、用户、角色、菜单、轮播、公告、订单、消息模板、配置、字典和文件。
给新客户单独开一份数据
平台超管可以新建客户。客户有自己的名称和编码,编码全平台唯一。顶栏切换到某个客户之后,再创建的用户和角色会落在这个客户下面。租户管理员只能看到自己这一份用户、订单、内容和日志。
图里的「默认客户」是种子租户,编码 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/…