Files
..

小程序前端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                 # 本文件

开发指南

  1. 使用 微信开发者工具 打开本目录(apps/miniprogram/
  2. 首次打开后,在工具中执行"构建 npm"以生成 miniprogram_npm/
  3. AppIDwx7c07793d82732921

与 Monorepo 的关系

  • 本项目为独立前端工程,不参与 Python uv workspace
  • H5 原型设计稿位于 docs/h5_ui/(从原 Prototype/ 目录迁移)
  • 未来将通过 FastAPI 后端(apps/backend/)与 ETL 数据层交互

Roadmap

  • 接入 FastAPI 后端 API替换当前静态/模拟数据
  • TDesign 组件库升级至最新版本
  • 完善页面路由与业务功能(会员中心、助教预约、订单查询等)
  • 集成 CI/CD代码检查、自动上传体验版
  • 多门店支持(基于 site_id 的数据隔离)