diff --git a/README.md b/README.md index 87b5d6b..97beace 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,14 @@ # 云仓视频溯源系统 -前后端分离 + 一个浏览器扩展 + 一个 Windows 本机软件(WPF),四个目录: +前后端分离 + 一个浏览器扩展 + 一个 Windows 本机软件(WPF)+ 一个微信小程序,五个目录: ``` packService/ -├── backend/ # Egg.js 3(纯 API;MySQL + Redis) -├── frontend/ # Vite + Vue3 + TypeScript(用户端 SPA) -├── extension/ # Chrome MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 -└── desktop/ # WPF 本机软件:HTTP 17300(查询/唤起/下载)+ WS 17301(拉通道/预览/云台)+ yuncang:// 启动协议 +├── backend/ # Egg.js 3(纯 API;MySQL + Redis) +├── frontend/ # Vite + Vue3 + TypeScript(用户端 SPA) +├── miniprogram/ # uni-app + Vue3 + TypeScript(微信小程序:抽屉登录(个人中心为整页登录)/ 协议弹窗 / 首页统计 / 扫码记录 / 我的) +├── extension/ # Chrome MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 +└── desktop/ # WPF 本机软件:HTTP 17300(查询/唤起/下载)+ WS 17301(拉通道/预览/云台)+ yuncang:// 启动协议 ``` ## 端口约定(⚠️ 本机项目多,不要用 Vite 默认的 5173) @@ -17,6 +18,7 @@ packService/ | 前端 dev(Vite) | **7301** | `cd frontend && npm run dev` | | 前端 preview(dist) | **7302** | `cd frontend && npm run preview` | | 后端 dev | **7300** | `cd backend && npm run dev` | +| 小程序 H5 预览(可选) | **7304** | `cd miniprogram && npm run dev:h5` | | 本机软件(WPF,只监听 loopback) | **17300**(HTTP)/ **17301**(WebSocket) | `cd desktop && dotnet run`(详见 [`desktop/README.md`](desktop/README.md)) | | 扩展自测页(可选) | **7310** | `npx --yes http-server extension/test -p 7310` | @@ -41,6 +43,7 @@ packService/ - [x] 目录拆分为 `backend/` + `frontend/` - [x] 前端脚手架(Vite + Vue3 + TS)跑通,登录页走通 `/api/web/auth/*` +- [x] 小程序脚手架 `miniprogram/`(uni-app + Vue3 + TS):微信一键登录(code2Session)+ 账号登录双 tab / 首页统计 / 扫码记录 / 个人中心;登录前需阅读并同意协议(版本落库);不强制登录(启动不弹窗,点功能或 401 才提示,符合小程序审核) - [x] 浏览器扩展 `extension/`(MV3,零构建):注入第三方 WMS 页面,在运单号**旁边**渲染「查看打包视频」按钮 → 点按钮打开溯源页 - [x] **后端去掉服务端渲染**:删除 `app/controller/page/`、`app/view/`、`app/lib/page.js`、nunjucks / session / CSRF 配置与依赖,后端只剩 JSON 接口 - [x] 页面全部迁移到前端:登录 / 注册 / 找回密码 / 扫码 / 扫码确认 / 首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页 @@ -49,7 +52,7 @@ packService/ - [x] 新增用户端接口:`/api/web/{stats,devices*,records,test/*}`(范围一律限定在令牌对应的那个用户) - [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址 -后端接口细节见 [`backend/README.md`](backend/README.md),扩展用法见 [`extension/README.md`](extension/README.md)。 +后端接口细节见 [`backend/README.md`](backend/README.md),扩展用法见 [`extension/README.md`](extension/README.md),小程序用法见 [`miniprogram/README.md`](miniprogram/README.md)。 ## 前端页面风格约定(`frontend/`)