文件
yjyf/README.md

68 行
4.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 优匠优服(YJYF)同城服务平台
## 一、项目架构概述
本项目采用 **前后端分离的全栈工程架构**:
- **移动/小程序客户端**:位于 `yjyf-app/`,基于 **uni-app (Vue) + SCSS**,适配微信小程序、H5、App 等。
- **服务端接口与后台**:位于 `server/`,基于 **FastAdmin / ThinkPHP 5.x**,提供 RESTful API 与 RBAC 运营管理后台。
- **数据库**:位于 `db/`,MySQL 5.7+ / 8.0(utf8mb4 字符集),提供完整的阶段演进建表 SQL。
---
## 二、标准项目目录结构
```text
yjyf/
├── yjyf-app/ # 小程序/移动客户端源码(uni-app 前端工程)
│ ├── pages/ # 业务页面目录
│ │ ├── index/ # 平台主页(pages/index/index)
│ │ ├── service/ # 服务分类列表、服务详情、价格测算
│ │ ├── order/ # 订单模块(快速下单、确认订单、订单详情、评价)
│ │ ├── master/ # 师傅端(资质入驻、接单大厅、工作台、报价管理、钱包、信用)
│ │ ├── merchant/ # 商户端(商家入驻、商家工作台、批量下单、企业订单、发票)
│ │ ├── address/ # 用户服务地址管理
│ │ ├── coupon/ # 领券中心与我的优惠券
│ │ ├── message/ # 消息通知中心
│ │ ├── mine/ # 个人中心(角色切换、设置)
│ │ └── login/ # 统一登录与微信静默/授权登录
│ ├── static/ # 静态资源(保留 logo.png 与 icons/ 服务图标库)
│ │ └── icons/ # 扁平双色矢量服务类目图标
│ ├── utils/ # 前端核心工具库
│ │ ├── api.js # 接口清单(与后端 api 控制器一一映射)
│ │ ├── request.js # 网络请求封装(Token 鉴权、响应拦截、统一异常提示)
│ │ ├── role.js # 角色上下文状态管理(user / master / merchant)
│ │ └── wxlogin.js # 微信静默授权登录
│ ├── App.vue # uni-app 入口组件
│ ├── main.js # Vue 初始化入口
│ ├── pages.json # 页面路由与窗口配置
│ ├── manifest.json # 跨端发行与 AppID 配置
│ └── uni.scss # 全局主题样式变量
├── server/ # 后端服务端源码(FastAdmin / ThinkPHP)
│ ├── application/ # 业务应用模块
│ │ ├── admin/ # 后台管理控制器与视图(订单、师傅、商户、结算、提现等)
│ │ ├── api/ # 客户端 RESTful API 控制器(Home, Order, Master, Merchant 等)
│ │ └── common/ # 公共模型、类库、业务枚举(如 OrderStatus)
│ ├── public/ # Web 入口目录(admin.php, index.php)
│ ├── addons/ # FastAdmin 插件扩展
│ ├── composer.json # 后端依赖配置
│ └── think # ThinkPHP 命令行脚手架
├── db/ # 数据库架构与演进脚本
│ ├── schema_phase1.sql ~ schema_phase10_admin_config_zh.sql
│ └── README_phase5.md # 数据同源与后台模块部署规范
├── tests/ # 接口与业务闭环自动化测试套件
└── scripts/ # 运维补丁与部署脚本
```
---
## 三、开发与运行指引
### 1. 小程序端开发(HBuilderX)
- 在 **HBuilderX** 中打开 `yjyf-app/` 文件夹(或在命令行通过相关 CLI 启动构建);
- 配置 `yjyf-app/manifest.json` 中的微信小程序 AppID;
- 点击「运行」→「运行到小程序模拟器」→「微信开发者工具」。
### 2. 路由与多角色规范
- 所有页面统一存放于 `yjyf-app/pages/{模块名}/{页面名}.vue`;
- 启动页统一为 `pages/index/index`;
- 系统支持 `user`(个人业主)、`master`(维修师傅)、`merchant`(合作商户)三种身份,前端调用 `/api/auth/switchRole` 实现安全角色切换。