|
|
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 |
|
|
|
04f11b5432
|
feat: 新增 PDF 转换页签（iframe 嵌入 zTools2 /pdf，zPDF_package 子模块）
mainPage 用 iframe 嵌入 zTools2 同源托管的 /pdf 页面（PDF 转换：上传 epub、
进度显示、下载、用户软删/管理员硬删）。同源使 cookie 第一方生效，无需 CORS。
- src/modules/pdf/：页签模块（requiresAlive 存活校验 + iframe + 降级提示）
- src/config/app.config.js：新增 pdf 服务配置（baseUrl/healthPath/pagePath）
- i18n：tabs.pdf 中英文案 + pdf.openExternal
- third_party/zPDF_package：git submodule（源码管理，iframe 集成非构建期编译）
- docs/submodule-zPDF_package.md：集成/升级/移除文档
- README：更新结构、子模块列表、文档链接
|
2026-07-27 11:35:28 +08:00 |
|
|
|
3e5c1d5494
|
feat: 升级 timeTableFix 子模块（时区选择）+ 修正 README 构建路径
- 子模块 timeTableFix 升级至时区选择版本：加载自动检测用户时区，取不到
回退墨尔本；仅作新建事件默认 tzid 与下载 ICS 的 X-WR-TIMEZONE，不换算
- 修正 README：构建输出到 dist/（非 /root/html），由 npm run deploy rsync
到站点根；补 npm run deploy 命令；细节记于 docs/readme-fixes.md
- 集成构建验证通过（npm run build）
|
2026-07-27 09:51:43 +08:00 |
|
Zikai
|
d9309756c7
|
fix: 子模块 i18n 桥接 -- 透传 :locale prop，修复嵌入页显示 i18n ID
根因：子项目组件用 useI18n({useScope:'global'}) 注入，嵌入时解析到宿主
mainPage 的 i18n 实例（不含子项目文案）-> 文案回退成 key（显示 ID）。
修复：
- z449 / timeTableFix 组件改用 useLocale composable 直读自身模块级 i18n 实例
- ttf 新增独立 i18n（中英 locale + useLocale），抽取所有硬编码中文
- mainPage 侧 Timetable/MobileGameWrapper 包装器透传 :locale prop
- 两个子模块 gitlink 更新至各自修复 commit
验证：构建后两个子模块 chunk 含真实中文文案，无 useI18n 注入残留
|
2026-07-24 09:02:38 +00:00 |
|
Zikai
|
6ad6c15e9d
|
feat: 拆分移动游戏项目为独立 z449 子模块（git submodule + i18n prop 桥接）
- mobile-game 模块源码迁出至独立仓库 z449（third_party/z449），独立可渲染/维护
- z449 App.vue 为便携式组件：自带独立 vue-i18n 实例与 locale 文案
- mainPage 侧 MobileGameWrapper 透传 :locale prop，子模块 watch 同步语言
- mainPage i18n 精简：仅保留 tabs.mobileGame，删除 mobileGame.* 大块文案
- 文档：新增 docs/submodule-z449.md，更新 README/architecture/add-module
|
2026-07-23 07:04:08 +00:00 |
|
|
|
b3960f503a
|
docs: 移除 systemd 部署与 /ttf/ 独立入口说明
本项目仅作为 mainPage submodule 集成，无独立线上入口。
保留独立开发/测试说明（npm run dev/test/build）。
|
2026-07-23 04:45:49 +00:00 |
|
|
|
4334dec00d
|
docs: 精简 README，细节拆分到 docs/
README 仅保留概览/结构/基础设施/安装/开发命令；
架构、新增页签、子模块管理细节移至 docs/ 下三个 md：
- docs/architecture.md：模块注册/PageShell/KeepAlive/存活校验
- docs/add-module.md：新增页签步骤 + 元数据字段速查 + 常见变体
- docs/submodule-timeTableFix.md：submodule 升级/clone/移除/独立访问
|
2026-07-23 04:09:42 +00:00 |
|
