# 子项目 timeTableFix（git submodule）

timeTableFix（ICS 日程整理器）作为 **git submodule** 被 mainPage 引入，位于 `third_party/timeTableFix`，独立仓库为 https://git.zikai.wang/zikai/timeTableFix.git 。

## 集成方式

mainPage 侧的 `src/modules/timetable/Timetable.vue` 包装器 import 子模块的 `src/App.vue` 作为组件，套 `PageShell` 统一容器与标题，并持有 KeepAlive 匹配名 `defineOptions({ name: 'timetable' })`。

- 子模块 `App.vue` 保持纯净（不持 name、不依赖宿主），可独立 `npm run build` / `npm test` / 部署。
- 构建期集成（非 iframe），共享 mainPage 的构建与 KeepAlive 缓存。子模块自身依赖（如 `ical.js`）在 `third_party/timeTableFix/node_modules`，由其自身 `package.json` 管理。
- 子模块样式已隔离（scoped + `ttf-` 前缀类名），全局重置仅在独立 app 的 `main.js` 加载，不污染宿主。

## 克隆（含子模块）

```bash
git clone --recursive https://git.zikai.wang/zikai/zMainPage.git mainPage
```

若已 clone 但未带子模块：

```bash
cd mainPage
git submodule update --init --recursive
```

> 构建前需在子模块目录内 `npm install`（mainPage 的 Vite 编译子模块 `.vue`，但子模块依赖如 `ical.js` 须各自安装）：

```bash
cd third_party/timeTableFix && npm install
```

## 升级子模块到最新版本

```bash
cd mainPage
git submodule update --remote third_party/timeTableFix      # 拉取最新
cd third_party/timeTableFix && git checkout master           # 固定到目标分支/commit
cd ../..
git add third_party/timeTableFix                             # 更新 gitlink 指针
git commit -m "chore: 升级 timeTableFix 子模块"
npm run build                                                # 重新构建 mainPage
git push                                                     # 推送 mainPage（gitlink）
```

> 推送顺序：先确保子模块的 commit 已推到 timeTableFix.git，再推 mainPage 的 gitlink，否则别人 clone mainPage 时拉不到子模块对应 commit。

## 移除子模块集成（仅移除 mainPage 页签，不影响 timeTableFix 本身）

```bash
cd mainPage
git submodule deinit -f third_party/timeTableFix
git rm third_party/timeTableFix
git commit -m "chore: 移除 timeTableFix 子模块集成"
```

同时删 `src/modules/timetable/` 文件夹即移除页签。timeTableFix 独立仓库不受影响。

> timeTableFix 仅作为 submodule 被 mainPage 构建期集成，无独立线上入口。独立开发/测试用其自身的 `npm run dev` / `npm test`。