⏳ 历史快照(冻结于 2026-10-05,不再更新)——现行口径(铁律/容器/业务流/数据流/定时任务)以 audit.html 第 0 节 为准;2026-10-14 起的变更记录在 audit.html 第 9 节。页内 mercury/Dell/222 为已退役链路的历史标签(2026-10-18 清零,勿作现行拓扑)。
ZZIPFORCE 系统手册 定时任务 Hub 页面 UVPVP 页面 两系统对比

双系统手册

两套系统的完整参考:ZIPFORCE Hub(新 SaaS,zipforcehub.com)与 UVPVP(老 Portal,uvpvp.zipforcetek.com)。含 Hub 的部署目录地图、ARQ 定时任务(20+)与宿主调度清单(12 条)、两套全部页面的功能说明,以及两套系统的对比。

生成于 2026-09-12 · 2026-09-24 增补目录地图 Hub · arq 20+ 任务 + 宿主 12 条 · 34 页 UVPVP · ~40 页 对比分析
第一部分 · ZIPFORCE Hub

部署目录地图与定时任务

2026-09-24 机器资产收编后的归口全景(与 /pipeline 页 🗂 目录地图卡片、注册表架构文档第八章同源)。任务定义全部代码化:worker 容器 ARQ cron(下表,调度时间 UTC)+ saas 根目录 5 个 .sh 脚本;宿主 root crontab 12 条调度行已落地仓库清单 saas/host-crontab.txt(变更铁律:先改清单,再跑 install-host-crontab.sh 幂等安装)。

目录 / 资产角色说明
/opt/six-claude/workspace/saas/唯一真实代码库api/web/tools/pg-init/secrets/Caddyfile/compose + 5 个定时脚本(backup/aba/kol/promotion/four_layer_audit),所有改动只在此
/opt/saas/workspace/zipforce-hub/文档工作区changelog/需求单/审计报告/context/截图,挂 Caddy /srv/zipforce-hub(changelog 站 /audit/ 归档)
/opt/collection/统一采集器compose 卷挂进 worker /collection,三品牌 adapter + 凭证 + 状态快照
saas/host-crontab.txt宿主调度清单12 条 crontab 三组:SaaS 脚本调度(5) / 必须宿主跑(容器无 SSH 的 sourcing 每分钟分发 + mercury 备份×2 + 隔周结算回补 + PM 库备份)/ 刻意在外监控(2)
zipforce-saas_pgdata 卷数据库本体/var/lib/docker/volumes/,backup.sh 每日 03:30 备份至 saas/backups/
/opt/saas/monitor-agent/外部监控刻意在 SaaS 外(监控者不住被监控者里),每日 07:10 审计 SaaS 全状态出日报
/opt/zipforce-hub-installer/部署安装包install.sh/images/migrations,分发用
saas/backups/residual-workspaces-20260924/已归档残留09-11 三份多窗口 saas 副本(dashboard/finance/sourcing,mv + tar.gz 双保险可逆),防"改错库";同名 tar.gz 在 backups/
第二部分 · ZIPFORCE Hub

Hub 页面手册

34 个页面(27 个功能页 + 7 个认证/法律/落地页),按侧边导航分组。每页列出整体功能、标签页、KPI 卡片、图表、表格、输入控件、按钮与数据来源(逐页读 Next.js 源码梳理)。

全局组件(所有功能页共享)

  • 侧边导航: 8 分组 27 功能页链接,按模块订阅/员工授权显示(未开通=锁+去开通,未授权=置灰)
  • 顶栏品牌切换: 全部/各品牌 tab(>1品牌时显示),全局筛选
  • 通知铃铛: 库存紧急补货/回款异常/PO滞留/数据管道断更 四类计数,5分钟轮询,点击跳对应页
  • AI 助手(AIChat): 右下角浮动,输入框(Enter发送)+发送按钮+开关,基于本租户数据问答
  • 四维矩阵(MatrixSection): 工作台/财务/选品复用,平台×国家×品牌×SKU 64组数据透视
  • 退出登录: 侧栏底部,吊销会话跳/login
第三部分 · UVPVP 老系统

UVPVP 页面手册

uvpvp.zipforcetek.com(Flask + Gunicorn :8004 + 静态壳)。按业务模块分组。5 个品牌主看板(zf/fg/onno × amazon/noon)逐页读源码梳理——amazon 主看板各 77-84 个 chart、noon 主看板各 36 个 chart;其余模块信息源自官方交接文档《FULLSTACK_HANDOVER.md》(2026-09-03)。架构:固定 HTML 壳 + fetch 登录保护的 PG API(/dashboard-data/...),数据不内嵌。

第四部分

两系统对比

ZIPFORCE Hub 与 UVPVP 在架构、技术栈、页面覆盖、数据链路上的差异。