first

README.md

@@ -0,0 +1,73 @@
+# 安心验鉴定平台
+
+安心验是一个面向奢侈品 / 潮流品鉴定履约场景的平台项目，当前仓库包含：
+
+- 用户端 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)