# 小程序前端（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. AppID：`wx7c07793d82732921`

## 与 Monorepo 的关系

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

## Roadmap

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