NIU-Life 網站
NIU-Life 是國立宜蘭大學學生的非官方校園助手 App，有 iOS 與 Android 版。這個 repo 是它的官網：捲動敘事的首頁、下載入口、常見問題、許願池、關於我們，以及 App 與網站共用的隱私權政策。
NIU-Life 為個人開發的非官方工具，與國立宜蘭大學並無隸屬、合作或授權關係。
技術
本機開發
需要 Node 22.12 以上（見 .nvmrc）：
npm install
npm run dev # http://localhost:4321
npm run build # 型別檢查（astro check）後輸出到 dist/
npm run preview # 預覽建置結果
專案結構
src/
├── pages/ # 每個檔案是一個網址
│ ├── index.astro 首頁，組合 components/ 的各段落
│ ├── about.astro /about 關於我們
│ ├── privacy.astro /privacy 隱私權政策
│ ├── download.astro /download 依裝置前往商店
│ ├── map.astro /map 校園地圖（全校總覽、樓層平面圖、教室搜尋）
│ ├── open/[feature].astro /open/<功能> 沒裝 App 時的說明頁
│ ├── sitemap.xml.ts
│ └── 404.astro
├── components/ # 首頁段落（Hero、About、Features、Privacy、Faq、Wish、Download）與商店按鈕
├── content/privacy.md # 隱私權政策內文
├── data/campus-map/ # 校園地圖資料，從 Android repo 的 app-content/campus-map 複製
├── scripts/campus-map/ # /map 的地圖繪製、平移縮放、搜尋
├── layouts/Base.astro # <head>、頁首、頁尾
├── scripts/story.ts # 首頁的捲動動畫
├── styles/global.css # 配色（淺色／深色）與共用樣式
└── site.ts # 商店網址、分析工具 ID、要被搜尋引擎收錄的頁面
public/
├── assets/ # 圖示、分享預覽圖、App 畫面、開發者頭像
└── .well-known/ # Android App Links 與 iOS Universal Links 設定
常見修改
- 隱私權政策：iOS 版、Android 版與網站共用
src/content/privacy.md 這一份。修改後請更新 frontmatter 的 updated 日期。
- App 畫面：
public/assets/screens/ 每張畫面有兩種尺寸，540×1200 的 <名稱>.webp 和給手機用的 360 寬 <名稱>-360.webp，換圖時兩份都要換。
- 校園地圖：資料來源是 Android repo 的
app-content/campus-map（OpenStreetMap 總覽與各大樓樓層平面圖，App 也用同一份）。地圖或平面圖更新後執行 node scripts/sync-campus-map.mjs ../niu-app-android，再提交 src/data/campus-map/。網址可以帶 ?b=<大樓>&f=<樓層>&r=<教室>，例如 /map?r=工423。地圖左下角的「© OpenStreetMap 貢獻者」依 ODbL 必須保留。
- 奶娃追蹤（限時功能）：
/map 顯示最近 1 小時的奶娃回報，訪客也能直接回報（src/scripts/campus-map/naiwa.ts）。讀取用 Firestore REST API、不用登入；回報前先顯示說明，同意後用 Firebase 匿名登入（存在瀏覽器），每 5 分鐘一次。奶娃只有一隻，地圖只顯示最新一筆回報；點標記可以回報「還在這裡」「不在這裡了」（mood: gone，最新一筆是它時不顯示）或「在別的地方看到」。Firestore 專案與網頁 API 金鑰由 GitHub Actions 的 repo 變數 NAIWA_PROJECT、NAIWA_API_KEY 在建置時帶入，沒設定時這一層不會出現；本機要看的話，在 .env 放 PUBLIC_NAIWA_PROJECT、PUBLIC_NAIWA_API_KEY（已 gitignore）。規則在 firebase/firestore.rules，由 python3 firebase/naiwa_rules.py 依地圖資料產生（部署前會檢查），地圖資料同步後要重跑並部署：cd firebase && npx firebase-tools deploy --only firestore:rules --project <專案>；規則測試 cd firebase && npm install && npm test。
- 新增頁面：在
src/pages/ 加檔案；要讓搜尋引擎收錄的話，把路徑加進 src/site.ts 的 INDEXED_PAGES，sitemap.xml 會自動列出。
- 頁面標題與分享預覽：由各頁傳給
Base.astro 的 title 與 description 產生；首頁的結構化資料（JSON-LD）在 src/pages/index.astro。
下載連結與 App 連結
https://niu-life.app/download 是對外宣傳用的單一下載連結：iPhone／iPad 前往 App Store，Android 前往 Google Play，電腦則顯示商店按鈕與 QR Code。可以加 utm_* 參數標示來源，例如 ?utm_source=poster&utm_medium=qr。
已安裝 App 的手機開啟下列網址時會直接進入 App：
| 網址 | 開啟 |
|---|
/download | App 首頁 |
/open/schedule | 課表 |
/open/attendance | 快速點名 |
/open/library | 圖書館入館碼 |
/open/mail | 校園信箱 |
/open/moodle | M 園區 |
/open/calendar | 行事曆 |
驗證設定在 public/.well-known/（Android 的 assetlinks.json、iOS 的 apple-app-site-association）。新增 /open/<功能> 時，網站的 src/pages/open/[feature].astro 與 App 端都要一起修改。
分析工具
網站使用 Google Analytics（已關閉 Google 信號與廣告個人化）與 Microsoft Clarity，兩者都等頁面載入完成後才載入，不影響首次顯示。App 本身不使用這兩項服務。詳見隱私權政策。
部署
推送到 main 後，GitHub Actions（.github/workflows/pages.yml）會建置並部署到 GitHub Pages。
聯絡與回報
授權
網站原始碼以 GNU AGPL-3.0 授權公開。iOS 與 Android App 的授權請見各自的 repo。
