鋒兄AI管理系統
家庭數位中控台（zh-TW）：訂閱、食品／商品庫存、銀行／電子票證、筆記與文件、常用連結、影音播客、例行事項，以及比價、金融報價、新聞與 FFmpeg 媒體工具。
日常入口是 / 的單頁模組切換，不是每個模組一條獨立路由。現況以 app/page.tsx 與 docs/INDEX.md 為準。
功能
日常工作台（需 Appwrite）
- 鋒兄首頁 / 儀表 — 到期、餘額、媒體流量與容量摘要
- 鋒兄訂閱 — 扣款日、多幣別、CSV、本機垃圾桶
- 鋒兄試用/首購 — 依服務展開多帳號、試用／首購狀態、價格與試用／首購／到期日（扣款日）
- 鋒兄重灌 — Windows／Mac 軟體、授權序號（預設隱藏，可設查看密碼）、訂閱週期與費用、CSV、網站與備註
- 鋒兄食品 — 庫存、到期、商品庫存
- 鋒兄筆記 / 文件 — 筆記附件預覽；PDF／Office／程式碼／ZIP
- 鋒兄常用 — 網站群組、favicon、行內編輯
- 鋒兄圖片 / 影片 / 音樂 / 播客 — 上傳、佇列、歌詞、IndexedDB 快取
- 鋒兄銀行 — 帳戶與電子票證餘額
- 鋒兄例行 — 日期遞移與天數差
- 鋒兄設定 / 關於 — 帳號切換、建表、文件中心
鋒兄工具
- 鋒兄比價（手動價格紀錄）
- 手機比價（地標網通 + 傑昇通信，週期歷史）
- 圖片 + 語音 = 影片
- PNG / JPEG 轉換
- 影片合併
- YouTube / Bilibili 轉 MP3／MP4
鋒兄子工具
- 鋒兄Tube（頻道與倒台指數）
- 鋒兄金融（CNBC / Yahoo 報價、自訂標的）
- 鋒兄新聞（鎖定網站焦點）
跨模組
- 亮色 / 暗色 / 跟隨系統，舒適 / 緊湊密度
- PWA、語音導覽、到期 Web Push
- 媒體佇列與離線快取（每類約 500MB）
技術棧
- 框架: Next.js 16（App Router + Turbopack）、React 19、TypeScript 5.9
- 樣式: Tailwind CSS 4、Radix / shadcn 風格、Lucide、Geist
- 後端: Next.js API routes + Appwrite 21（Database、Storage）
- 部署: Vercel（含 cron）與 Docker
資料表
設定頁可初始化 17 個 collection（見 app/api/create-table/route.js）：
food · subscription · trialpurchase · reinstall · article · commonaccount · bank · routine · image · video · music · podcast · commondocument · landtophistory · manualprice · sitevisit · menuusage
新增的 trialpurchase（8 欄位）與 reinstall（12 欄位）採獨立資料表，不變更既有訂閱／食品資料。初始化只新增資料表或補齊缺少欄位，重試不刪除紀錄；新表不授予公開存取權限，沿用伺服器 API key 操作。序號遮罩與查看密碼只是畫面隱藏，不是加密保管庫。
另有 Web Push 訂閱表由 /api/push-subscribe 動態建立。
快速開始
- 安裝依賴：
npm install
- 複製環境變數並填入 Appwrite：
NEXT_PUBLIC_APPWRITE_ENDPOINT=
NEXT_PUBLIC_APPWRITE_PROJECT_ID=
NEXT_PUBLIC_APPWRITE_DATABASE_ID=
NEXT_PUBLIC_APPWRITE_BUCKET_ID=
NEXT_PUBLIC_APPWRITE_API_KEY=
npm run dev，開啟 http://localhost:3000- 第一次使用：進 鋒兄設定 → 一鍵建立缺失 Table
也可在設定頁用 localStorage 覆寫連線，不必重部署。
專案結構
app/ # App Router：主頁、少量獨立路由、API
app/api/ # CRUD、上傳、比價、金融、新聞、轉檔
components/layout/ # DashboardLayout（頂欄、手機底欄、佇列、語音）
components/modules/ # 各功能模組
components/ui/ # 共用元件與播放器
hooks/ # 資料、快取、通知、語音
lib/ # Appwrite 設定、比價／新聞／金融邏輯
docs/INDEX.md # 選單與資料表現況索引
排程（Vercel cron）
- 每日推播到期、補送到期通知
- 每週一抓地標網通歷史價格
文件
功能驗證
npm run test:unit 執行欄位與既有功能單元測試。先啟動 npm run dev，再執行 npm run test:management，會以只綁定 loopback 的記憶體 Appwrite fixture 驗證新功能 CRUD、33／133 帳號分頁、欄位驗證、權限錯誤與非破壞性建表，不連接正式 Appwrite。若伺服器不在 3000 port，可設定 MANAGEMENT_TEST_URL。
授權
MIT License
