init: 项目初始提交 - NeoZQYY Monorepo 完整代码

apps/miniprogram/README.md

@@ -0,0 +1,57 @@
+# 小程序前端（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` 的数据隔离）