# Momentry Portal — AGENTS.md

## 其他專案（M4mini）

- **markbase** — M4mini 上正在開發的重要專案

## 開發指令

| 用途 | 指令 |
|------|------|
| Vue dev server (port 1420) | `npm run dev` |
| Tauri 桌面應用 | `npm run tauri dev` |
| 完整建置（typecheck → build） | `npm run build` |
| 純 Vite preview | `npm run preview` |

`npm run build` 會先執行 `vue-tsc --noEmit`（型別檢查），成功後才執行 `vite build`。

## 專案架構

- `src/` — Vue 前端，`@/` 別名指向 `./src/`
- `src-tauri/` — Rust 後端（Tauri v2），`src/api/` 有七個模組：`health`、`search`、`identity`、`video`、`person`、`translation`
- `src-tauri/config.rs` — 從環境變數 `MOMENTRY_API_URL` / `MOMENTRY_API_KEY` 讀取設定
- 無測試、無 lint/formatter 設定檔、無 CI

## API 雙模式

`src/api/client.ts` 根據執行環境自動切換：
- **Tauri 模式**：透過 `@tauri-apps/api/core` 的 `invoke` 呼叫 Rust commands
- **瀏覽器模式**：直接 HTTP fetch 到后端 API

## 環境與認證

- `.env.development` 提供 `VITE_API_BASE_URL`、`VITE_API_KEY`（僅瀏覽器模式使用）
- 登入狀態存於 `localStorage('momentry_user')`
- API 設定存於 `localStorage('portal_config')`
- 401 回應會自動清除登入狀態並跳回 `/login`

## 跨機器推送與測試（M4mini → M5Max128）

Gitea 伺服器在 `m5max128.local:3000`（admin / `AccusysTest!`）。開發在 M4mini 進行，測試在 M5Max128：
```bash
# 一鍵推送 + 部署 + 建置
./deploy.sh [commit message]

# 或手動
git commit -am "..." && git push
ssh accusys@m5max128.local "cd ~/momentry_portal && git pull && npm run build"
```

## 注意事項

- `tsconfig.json` 啟用 `strict` + `noUnusedLocals` + `noUnusedParameters` — 未使用的變數/參數會造成 `vue-tsc` 建置錯誤
- Tauri v2 使用 plugins 架構：`shell`、`http`（`unsafe-headers`）、`fs`、`global-shortcut`
- 視窗 Zoom 快捷鍵：`Cmd+=` / `Cmd+-` / `Cmd+0`
- Dev server port **1420**（strictPort: true）— `tauri.conf.json` 的 `devUrl` 與 `vite.config.ts` 一致
- 此專案從 `momentry_core` 分離出來，前端不包含後端 Rust 程式碼