11 Commits

Author SHA1 Message Date
liufumingren
78cee0fe1a feat(doc): 首页登录分流 + 文档站(简易 CMS / 静态 HTML / sitemap)
- 首页:`/` 未登录原地显示登录页(不再跳 /login),已登录直接进 `/dashboard`;
  看板路由由 `/` 迁到 `/dashboard`,侧边栏「首页」与无权限回跳同步;
  桌面端「工具 → 打开配置页」的 `/?token=` 免登录仍然可用
- 文档站:`/doc/**` 由后端整站生成静态 HTML(顶部分类 tab 全局切换、左侧栏目 → 内容页、
  右侧本页目录);`/sitemap.txt` 新链接追加到末尾,下架 / 删除的会被清理
- 平台管理 · 文档管理(`/admin/doc`):分类 / 栏目 / 内容页(Markdown)简易 CMS,
  内容页有编辑表单与列表,保存后自动重生成目录与静态页面
- 登录页右下角、顶栏(登录后)、看板右上角新增进入文档站的链接
- 部署:nginx 模板为 `/doc`、`/doc/`、`/sitemap.txt` 增加反代(否则会落到 SPA 回退);
  Vite dev server 增加同名代理;`middleware/frontend.js` 排除这些路径
- 登录页插画改为内联 SVG(沿用工作区已有的未提交改动)
- 测试:新增 Markdown 渲染单测;后端 218 个用例通过,前端 typecheck / build 通过

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 20:33:46 +08:00
liufumingren
0c59bede7e feat(admin): 平台管理新增套餐管理(改价 / 改天数 / 上下架 / 删除)
- 后端:新增 service/admin_plan.js、controller/web/admin_plan.js,
  GET/POST /api/web/admin/plans、PUT/DELETE /api/web/admin/plans/:id(需平台管理员)
- 套餐 code 创建后不可改(历史订单已快照 plan_code);留空按天数自动生成(如 p30)
- 前端:新增 /admin/plans「套餐管理」页面,并接入「平台管理」菜单与路由
- 续期下单只按库里的售价算钱,改完即生效、不用发版
- 文档与测试同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 16:23:17 +08:00
liufumingren
11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00
liufumingren
3e2bd56416 feat(平台管理): 平台管理员与平台管理台(主体管理 / 订单管理 / 管理员)+ 顶栏下载入口
- 新表 admin_members(user_id 唯一、name、role、status、remark,软删):平台级管理员,
  与「主体管理员」完全分开;迁移会把内置管理员(username=admin,没有则 id=1)先入表
- 鉴权:middleware/platform_admin.js —— admin_members 启用行 **或** INTERNAL_ADMIN_IDS(内置/救急入口),
  其余一律 403 not_platform_admin;接口挂在 /api/web/admin/*
- 主体管理:GET 所有主体(成员数/管理员/是否过期)+ PUT 改授权到期时间
  (直接设 expireAt 或 extendDays 顺延),改完失效 subjectState 缓存,设备心跳立刻生效
- 订单管理:GET 所有订单(主体名/下单人/续期前后)+ POST 确认订单 ——
  复用支付回调的 payNotify()(标记已支付 + 主体顺延 + 失效缓存 + 幂等),渠道记 manual
- 管理员:GET/POST/DELETE /api/web/admin/members(按账号加人、不能删自己/最后一个);
  软删行仍占唯一键,查重带 paranoid:false + restore 复用
- 前端:左侧菜单新增「平台管理」组(只有平台管理员可见,路由 meta.platformAdmin 守卫、
  不需要选主体),新增 AdminSubjectsView / AdminOrdersView / AdminMembersView
- 顶栏右侧新增「下载桌面端 / 下载 Android 扫码台」两个按钮(与权限无关,所有人都显示),
  版本号读 /download/version.json 与 /download/android_client/version.json,未发布则置灰提示
- 测试:admin.test.js 12 例(403/表内/内置/列表/添加/重复/删自己/主体列表/改期限/顺延/订单/确认幂等)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:21:16 +08:00
liufumingren
e6198a4334 web 端权限收紧:业务数据接口与菜单仅主体管理员
后端
- 新增 middleware/subject_admin.js:在 subjectAuth 之后校验「创建者 或 role=1」,否则 403
  { status: subject_forbidden, message: 只有主体管理员可以查看该数据(请联系主体管理员) }
- 挂到全部业务数据接口:/api/web/devices*、/records、/nvrs*(含 credential)、/cameras*、
  /workstations*、/workstation-scan-channels
- 有意不拦:/api/web/stats(首页概览)、/api/web/pack-query(桌面端打包查询,工位日常要用)

前端
- 路由加 meta.adminOnly(设备/录像机/摄像头/工作台/扫码记录,dev 的测试页同样),
  守卫里非管理员直接回首页 ?denied=1
- AppLayout 菜单按 isSubjectAdmin 过滤,成员只看到 首页 / 主体·成员 / 个人中心
- 首页对成员改成说明卡片(不再请求 stats、不显示设备/通道/记录数),被挡回时给出提示

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:00:09 +08:00
liufumingren
228723e0c3 设备端扫码上报 + 桌面端/Android 正式包发布脚手架
AndroidStation(原中控改造为纯设备端)
- 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报
- 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报
- 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满
- 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」
- 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启)
- 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖

发布脚手架
- backend/android_client:Android 正式包构建(build.ps1 + package.config.json)
- backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish
- 桌面端安装包改为 download/desktop,Android 为 download/android_client;
  version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json
- 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」
- git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 05:53:27 +08:00
liufumingren
27df32d7bc feat(frontend): 主体/工作站/摄像机/NVR 页面与本地服务对接 2026-10-19 22:04:06 +08:00
liufumingren
c12ea3b197 移除探活接口:状态合进 /api/query;插件支持直接协议唤起 + 失败兜底
一、本机服务(桌面端)
- 删除 GET /api/health(说明页同步)。
- GET /api/query/{code} 合并状态,一次请求就能决定「展示结果」还是「提示唤起」:
  200 { ok, state:"ok", code, loggedIn, user, env, server, data }
  401 { ok:false, state:"need-login", ... } / 400 "bad-request" / 404 "not-found" / 500 "error"
  不论成败都带 loggedIn/user/env/server;只有网络层失败才代表「软件没启动」。
  原因:探活通过 ≠ 查询时软件还在(用户可能中途退出),两次请求之间状态会错位。

二、前端 /local
- api/local.ts:删 localHealth / checkLocalHealth / waitForHealth / waitForLoggedIn;
  新增 queryLocal()(非 2xx 但带 state 的 JSON 也正常返回)与 waitForQuery()(轮询同一接口)。
  request() 改为先读 body,这样 401 能拿到 state 而不只是状态码。
- LocalServiceView.vue:状态机改为单接口驱动
  连不上 → offline(下载/启动提示);need-login → 自动 activate-login + 轮询 query 等登录;
  ok → 展示;其它 → 展示错误。
  「重新查询」也走同一逻辑:用户中途退掉软件时点重查会**直接落到「服务暂不可用 + 可唤起」提示**,
  不再是一个莫名其妙的失败。
- 空 code 也发一次请求(服务端回 400 bad-request + 登录状态),所以没有 code 时同样能驱动页面状态。

三、Chrome 插件(extension/,工作区改动,暂未提交 —— 与另一会话的 WIP 混在同几个文件里)
- 默认目标模板改为 yuncang://open?code={code}:点击「查看打包视频」**直接唤起本机软件并带参**,
  不再先开网页;旧的 http 默认模板在配置升级(v2→v3)时自动换成协议模板,用户自定义的不动。
- content.js:按协议分流(http(s) → background 开标签页;其它 → 本页用户手势内用隐藏 iframe 触发)。
- 唤不起的兜底(浏览器不会告诉网页协议是否成功,必须超时猜):
  4 秒内页面没失焦 → 右下角卡片「没打开本机软件?」+「在网页中查看」(fallbackUrl)+「下载安装」
  (downloadUrl)+ 关闭。
- 新增配置:fallbackUrl(默认 http://localhost:7301/local?code={code})、downloadUrl(留空不显示下载按钮);
  options 页与使用说明同步。

四、验证
- /api/health → 404;/api/query/ABC123 → 200 state:ok + data;
  /api/query/ → 400 state:bad-request + loggedIn/user/env/server。
- 浏览器 /local?code=ABC123:正常展示;**杀掉软件后点「重新查询」→ 立即显示
  「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮 + 已安装启动按钮**。
- 插件脚本 node --check 全通过;PSTRules.buildUrl 输出 yuncang://open?code=YT1234567890,
  v2 旧配置升级后模板自动变为协议、fallbackUrl/downloadUrl 就位。
- 前端 vue-tsc + vite build 通过;桌面端 0 警告 0 错误。

五、文档
- desktop/README.md:接口表改为两个接口 + 状态码/state 对照表 + 响应示例;
  「和前端/插件怎么配合」改为插件直接唤起;新增「插件直接唤起与唤不起时的提示」一节。
2026-10-17 11:10:34 +08:00
liufumingren
700394b56f 本机服务端口改 17300,/api/health 带登录状态,网页可唤起软件登录
- 端口 17311 → **17300**(桌面端常量、localhost/127.0.0.1 双前缀、前端 LOCAL_BASE、
  插件默认目标与说明、两个 README 全部同步)。
- `/api/health` 返回值加上 `loggedIn` / `user`(由 App 提供:IsLoggedInProvider、UserNameProvider),
  前端只认 `ok`(探活),再用 `loggedIn` 决定要不要唤起登录。
- 新增 `POST /api/activate-login`:叫本机软件把登录窗(已登录则主界面)带到前台。
  用 POST 而不是 GET,避免被浏览器/聊天工具的链接预取误触发;CORS Allow-Methods 加了 POST。
- `/api/query/{code}` 未登录时返回 401(前端会转去唤起登录)。
- 桌面端:App 记住登录窗引用,收到 LoginRequested 时切回 UI 线程激活它(托盘里也能叫出来)。
- 前端 `/local?code=`:
  - 路由加 alias `/local/`;
  - 新增 need-login 状态:探活到「软件在跑但没登录」→ 自动 POST activate-login →
    每秒探活等登录(30s 上限)→ 登录完成后自动查询;期间有「再叫一次登录窗口」按钮与托盘提示;
  - api/local.ts 增加 localHealth()(online/loggedIn/user)、requestLocalLogin()、waitForLoggedIn();
    waitForHealth() 改为返回状态而非 bool;老版本软件没有 loggedIn 字段时按已登录处理(向后兼容)。
- 实测(7301 + 模拟的 17300):打开 /local/?code=… → 「本机软件未登录 / 正在等待登录…」→
  mock 翻成已登录后自动切到查询结果(5 行);杀掉 mock 后显示「服务暂不可用」且探测地址为 17300。
2026-10-17 10:28:01 +08:00
liufumingren
7198dd1eb4 前端:新增不需要登录的「本机软件」公共页 /local?code=
给 Chrome 插件用:点运单号旁的按钮直接打开这一页(插件里的默认目标地址模板已改成
http://localhost:7301/local?code={code},线上换域名即可)。

- 打开即探活 GET http://localhost:17311/api/health:
  - 连不上/超时/被 CORS 拦 → 「服务暂不可用」+「本地打印服务未启动,请下载安装后再试」
    + 居中的「下载 云仓视频溯源软件」按钮 + 「重新检测」(页面上也打出探测地址,方便排查);
  - 可用 → 用 ?code= 调 GET http://localhost:17311/api/query/{code},把返回按
    「项目 / 值」两列展示,另附可展开的原始 JSON(本机软件返回结构未知,做通用渲染)。
- 没带 code 时给一个输入框手动查;提交后把 code 同步进地址栏(命名路由 local-service)。
- 路由 meta.public,并且**已登录时也不被踢回首页**(和扫码确认页一样始终显示,
  因为插件/手机是直接打开它的)。
- 本机服务地址可用 VITE_LOCAL_SERVICE 覆盖(换端口或改用 127.0.0.1 时)。

⚠️ 本机软件需要放行 CORS(Access-Control-Allow-Origin),否则浏览器会拦掉跨域请求,
表现和「软件没启动」一样(页面只能提示服务暂不可用)。

实测:7301 前端 + 一个模拟的 17311 本机服务 —— 无服务时提示文案与居中正确;
起服务后 /local?code=321408064481797 自动查出 6 行信息;不带 code 时手动输入可查。
2026-10-17 10:02:48 +08:00
liufumingren
bd2363bf00 chore: 初始化仓库(backend / frontend / extension 三块)
- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权;
  已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF),
  开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。
  单测 91 个通过(不需要本机数据库)。
- frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 /
  首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。
- extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。
- 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、
  .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
2026-10-17 08:50:32 +08:00