57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
# 小程序前端（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` 的数据隔离） |