75 lines
1.6 KiB
Markdown
75 lines
1.6 KiB
Markdown
# 安心验鉴定平台
|
||
|
||
安心验是一个面向奢侈品 / 潮流品鉴定履约场景的平台项目，当前仓库包含：
|
||
|
||
- 用户端 H5 / 小程序共用前端
|
||
- 管理后台
|
||
- `webman` 后端 API
|
||
- 部署、流程、数据库与产品文档
|
||
|
||
## 目录说明
|
||
|
||
- `server-api`
|
||
后端服务，负责订单、仓库、履约、报告、消息、工单等业务接口
|
||
- `user-app`
|
||
uni-app 用户端，H5 与小程序共用代码
|
||
- `admin-web`
|
||
Vue 3 管理后台
|
||
- `docs`
|
||
产品、流程、接口、部署与交付文档
|
||
|
||
## 技术栈
|
||
|
||
- 后端：PHP 8.1+ / webman / MySQL / Redis
|
||
- 用户端：uni-app / Vue 3 / TypeScript / Pinia
|
||
- 后台：Vue 3 / Vite / TypeScript / Element Plus
|
||
|
||
## 当前已完成主链路
|
||
|
||
- 用户下单与资料上传
|
||
- 用户提交送检运单
|
||
- 后台标记鉴定中心签收
|
||
- 鉴定补料与单次鉴定
|
||
- 报告出具与验真
|
||
- 用户确认寄回地址
|
||
- 后台登记回寄运单
|
||
- 后台标记用户签收
|
||
- 用户消息中心通知联动
|
||
|
||
## 本地常用命令
|
||
|
||
### 后端
|
||
|
||
```bash
|
||
cd server-api
|
||
php start.php start -d
|
||
php start.php reload -d
|
||
php tools/smoke_check.php
|
||
php tools/release_audit.php
|
||
```
|
||
|
||
### 用户端
|
||
|
||
```bash
|
||
cd user-app
|
||
npm run dev:h5
|
||
npm run type-check
|
||
npm run build:h5
|
||
```
|
||
|
||
### 管理后台
|
||
|
||
```bash
|
||
cd admin-web
|
||
npm run build
|
||
```
|
||
|
||
## 推荐先看文档
|
||
|
||
- [履约状态机](docs/flow/state-machine.md)
|
||
- [上线检查清单](docs/deploy/release-checklist.md)
|
||
- [履约冒烟检查表](docs/deploy/fulfillment-smoke-checklist.md)
|
||
- [当前交付说明](docs/deploy/delivery-notes.md)
|
||
- [部署说明](docs/deploy/deploy-plan.md)
|
||
- [分支协作规范](docs/development/branch-workflow.md)
|