momentry_portal/AGENTS.md

Momentry Portal — AGENTS.md

開發指令

用途	指令
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。開發在 M4mini 進行，測試在 M5Max128：

# 一鍵推送 + 部署 + 建置
./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 程式碼