灵工坊 (LingGongFang)

基于 Taro 框架的酒店清洁服务预约微信小程序。

功能特性

• 多角色支持: 酒店管理员、清洁工人、普通用户
• 订单管理: 下单、抢单、签到、验收、退款完整流程
• 资质认证: 用户资质申请与审核
• 钱包系统: 充值、提现、余额抵扣
• 位置服务: 基于位置的服务区域管理

技术栈

技术	版本	说明
Taro	4.1.2	跨端开发框架
React	18.x	UI 框架
TypeScript	5.x	类型安全
Redux Toolkit	2.x	状态管理
Tailwind CSS	4.x	样式框架

快速开始

环境要求

• Node.js >= 18
• Yarn 或 npm
• 微信开发者工具

安装依赖

yarn install

开发模式

# 微信小程序开发
yarn dev

# H5 开发
yarn dev:h5

生产构建

# 微信小程序
yarn build

# H5
yarn build:h5

代码检查

# ESLint 检查
yarn lint

# 代码格式化
yarn format

项目结构

src/
├── packages/              # 业务分包
│   ├── main/             # 主功能模块 (首页、订单、个人中心)
│   ├── cleaning/         # 清洁服务模块
│   ├── hotel/            # 酒店管理模块
│   ├── wallet/           # 钱包模块
│   ├── qualification/    # 资质认证模块
│   └── common/           # 通用页面
├── components/           # 组件库
│   ├── ui/              # 基础 UI 组件
│   ├── business/        # 业务组件
│   └── layout/          # 布局组件
├── services/api/        # API 服务 (自动生成)
├── states/              # Redux 状态管理
├── hooks/               # 自定义 Hooks
├── utils/               # 工具函数
├── constants/           # 常量定义
└── config/              # 配置文件

文档

• 快速开始 - 环境配置与项目启动
• 架构说明 - 项目架构与设计理念
• 开发指南 - 开发规范与最佳实践
• 部署文档 - 构建与部署流程

环境配置

复制环境配置示例文件:

cp env.example .env.development
cp env.example .env.production

修改对应环境的配置:

# API 地址
API_BASE_URL=https://api.example.com

# 调试模式
DEBUG_MODE=true
LOG_LEVEL=debug

常用命令

命令	说明
yarn dev	微信小程序开发模式
yarn dev:h5	H5 开发模式
yarn build	微信小程序生产构建
yarn build:h5	H5 生产构建
yarn lint	ESLint 代码检查
yarn format	Prettier 代码格式化
yarn openapi	从 OpenAPI 生成 API 代码

开发规范

• 使用 Tailwind CSS 内联样式，避免使用 CSS 文件
• 使用 Lucide 图标: <View className="i-lucide-{icon}" />
• 使用封装的导航函数，避免直接使用 Taro.navigateTo
• 所有 UI 文本和代码注释使用中文

许可证

MIT License