小程序前端(miniprogram)
微信小程序前端项目,基于 Donut 多端框架 + TDesign 组件库 技术栈,为台球门店会员提供移动端服务入口。
技术栈
- 框架:微信小程序原生 + Donut 多端(
projectArchitecture: multiPlatform) - UI 组件:TDesign 小程序版(
tdesign-miniprogram ^1.12.2) - 语言:TypeScript
- 类型定义:
miniprogram-api-typings
目录结构
apps/miniprogram/
├── miniprogram/ # 小程序主体代码
│ ├── app.ts # 应用入口
│ ├── app.json # 全局配置(页面路由、窗口、TabBar 等)
│ ├── app.wxss # 全局样式
│ ├── pages/ # 页面目录
│ │ ├── index/ # 首页
│ │ └── logs/ # 日志页
│ ├── miniprogram_npm/ # 构建后的 npm 包(TDesign 组件)
│ ├── i18n/ # 国际化资源
│ ├── miniapp/ # Donut 多端原生资源
│ └── utils/ # 工具函数
├── miniapp/ # 顶层 Donut 原生资源
├── typings/ # TypeScript 类型定义
├── doc/ # 项目文档(PRD 等)
├── i18n/ # 顶层国际化资源
├── reports/ # 报表输出
├── project.config.json # 微信开发者工具项目配置
├── project.miniapp.json # Donut 多端配置
├── tsconfig.json # TypeScript 编译配置
├── package.json # npm 依赖声明
└── README.md # 本文件
开发指南
- 使用 微信开发者工具 打开本目录(
apps/miniprogram/) - 首次打开后,在工具中执行"构建 npm"以生成
miniprogram_npm/ - AppID:
wx7c07793d82732921
与 Monorepo 的关系
- 本项目为独立前端工程,不参与 Python uv workspace
- H5 原型设计稿位于
docs/h5_ui/(从原Prototype/目录迁移) - 未来将通过 FastAPI 后端(
apps/backend/)与 ETL 数据层交互
Roadmap
- 接入 FastAPI 后端 API,替换当前静态/模拟数据
- TDesign 组件库升级至最新版本
- 完善页面路由与业务功能(会员中心、助教预约、订单查询等)
- 集成 CI/CD(代码检查、自动上传体验版)
- 多门店支持(基于
site_id的数据隔离)