|
|
25dbceee2d
|
refactor: 清理死代码/提前失败/高内聚低耦合，重写文档
死代码清理：
- 删除未使用的 UI 组件 Card.vue / Tag.vue
- 移除 app.config.js 死字段 healthTimeoutMs（×2）与 isDev()
- 移除 PageShell.vue 死 prop padded（恒为默认值）
- 移除 useLocale.js 死导出 isZh/pick/locale
- 移除 router/index.js 不可达 try/catch，简化为直接 .map()
- 移除 package.json 重复依赖 ical.js（子模块自带）
- 移除 i18n 死键 common.notAvailable / common.serviceUnavailable
- 移除 vite.config.js 陈旧的 /448 /449 dev proxy（z449 为构建期组件，不走该 URL）
提前失败/日志：
- useI18nLazy.js switchLocale 加载语言包失败时 console.error 记录（原静默吞错）
- modules/index.js 字段不全的模块跳过时 console.warn 告警（原与文档承诺不符、静默跳过）
- deploy.sh 补齐 zWhiteBoard / zPDF_package 的 npm install 与子模块初始化
（均为构建期组件 import，全新检出时缺少依赖会构建失败）
文档对齐现状（无 iframe、无外部域名）：
- README 改写为简洁版，修正 iframe/ical.js/子模块数量过时描述
- architecture.md 修正 requiresAlive 示例（同源 /api/health，非外部域名）
与「仅白板使用」断言（PDF 也用）；移除已删 padded prop
- add-module.md 同步移除 padded、修正 requiresAlive 示例
- submodule-timeTableFix.md 修正 ical.js 归属（子模块自带，非父项目共享）
- submodule-zPDF_package.md 子项目数量 3 -> 4
- 新增 submodule-zWhiteBoard.md
- readme-fixes.md 记录本次勘误
|
2026-07-28 11:57:32 +08:00 |
|
|
|
ae540a1a70
|
feat: PDF 页签从 iframe 改为构建期组件挂载，清理 iframe 配置与文档
前后端分离：UI/交互在 zPDF_package，能力由 zTools2 的 /api/pdf/* REST API 提供。
组件经同源 fetch 调用，httpOnly cookie（zk_pdf）经反代第一方自动携带，无需 CORS。
与 timeTableFix 集成范式完全一致。
- src/modules/pdf/Pdf.vue：iframe 包装器重写为组件挂载包装器，套 PageShell +
透传 :locale；删除 pageSrc/getLiveness/scheduleFailCheck/openExternal 等 iframe 逻辑
- src/modules/pdf/index.js：注释从 iframe 改为构建期组件 import（requiresAlive 探针保留）
- src/config/app.config.js：移除 pdf.pagePath（iframe src），保留探针配置
- src/i18n/{zh-CN,en}.js：移除 pdf.openExternal（iframe 降级按钮文案，已无用）
- docs/submodule-zPDF_package.md：集成方式改为构建期组件 import，补 cookie 认证说明
- docs/deployment.md：拓扑去 /api/pdf 页面行，措辞改为组件 fetch
- third_party/zPDF_package：子模块指针升级到 4d12b61（去 iframe 表述）
|
2026-07-27 17:14:07 +08:00 |
|
|
|
304ebc9448
|
feat: 配置简化为同源相对路径，统一 /api/ 路由约定
配合 zTools2 路由统一到 /api/，简化环境感知配置：
- app.config.js：去掉 BASE_URL 的 dev/prod 分支，iframe 与探针一律用同源相对路径
（/api/pdf、/api/health、/api/wb-page/{id}），默认空 baseUrl；保留 VITE_API_BASE 覆盖。
这样无论 dev（vite proxy）还是任意部署环境（反代），同源相对路径都自动指向当前环境 zTools2，
不再误打到 f.zikai.wang 等其它环境域名。
- vite.config.js：dev proxy 从 /api /pdf /health /static /upload /files /wb /ws 多条
简化为单条 /api（含 ws:true，覆盖 /api/ws WebSocket）。
- deploy.sh：Apache vhost 从多条 ProxyPass 简化为单条 /api/，a2enmod 增加 proxy_wstunnel。
- docs/deployment.md：更新拓扑/模式说明，新增路由约定（所有入口在 /api/ 下，反代只需一条规则）。
- 同步更新 zPDF_package 子模块指针（其 vite proxy 亦简化为单条 /api）。
|
2026-07-27 15:44:49 +08:00 |
|
|
|
66f93c67f5
|
feat: 新增整体部署脚本与部署指南（组件独立/整体/持久化三模式）
- deploy.sh：整体部署，构建 zMainPage + rsync 到 /var/www/html + 配置
Apache 反代（/api /pdf /pdf-admin /static 等到 zTools2）+ 重启后端
- docs/deployment.md：三种部署模式文档（组件独立开发 / 整体生产 / systemd 持久化）
- README：补部署指南链接
|
2026-07-27 13:52:40 +08:00 |
|
