# 安心验鉴定平台

安心验是一个面向奢侈品 / 潮流品鉴定履约场景的平台项目，当前仓库包含：

- 用户端 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
```

## 推荐先看文档

- [履约状态机](/Users/wushumin/www/biyou/anxinyan/docs/flow/state-machine.md)
- [上线检查清单](/Users/wushumin/www/biyou/anxinyan/docs/deploy/release-checklist.md)
- [履约冒烟检查表](/Users/wushumin/www/biyou/anxinyan/docs/deploy/fulfillment-smoke-checklist.md)
- [当前交付说明](/Users/wushumin/www/biyou/anxinyan/docs/deploy/delivery-notes.md)
- [部署说明](/Users/wushumin/www/biyou/anxinyan/docs/deploy/deploy-plan.md)