# 複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み 毎朝、複数のデータ源（スプレッドシート/会計CSV/社内API等）を横断して LLM に要約・優先順位付けさせ、その結果を自分でホストしている PWA ダッシュボードに自動表示する構成。「毎朝ダッシュボードを開くだけで、今日やるべきことTOP3と各データ源の現在地が出ている」状態を作る。 ## 全体構成（5パーツ） ``` ① データ源(Sheets/CSV/API…) ↓ 読む ② CIジョブ(GitHub Actions 等・シークレット保持) ↓ LLMで要約/優先順位付け → JSON生成 ↓ HTTPS POST (共有シークレットヘッダ) ③ 自作PWAの ingest エンドポイント (トンネルで公開) ↓ ローカルの state JSON に保存 ④ widget が GET して表示 ``` 要点: **重いデータ取得と LLM 呼び出しは CI 側（シークレットを持てる場所）で行い、結果 JSON だけを PWA に POST する**。PWA 自身は Google 等の資格情報を持たなくてよい。ローカルPCで動く PWA でも、トンネル公開していれば CI から到達できる。 ## なぜ「CI→POST」なのか（設計判断） - PWA をローカルPCでホストしている場合、そのプロセスから外部SaaSへ認証付きアクセスするのは資格情報配置が面倒。CI には既にシークレットがある。 - OSのタスクスケジューラでのローカル定時実行が権限/ポリシーで塞がれている環境でも、CI の cron なら確実に回る。 - 生成物は小さな JSON なので、トンネル公開した ingest への POST で十分。 ## 実装（PWA 側 / Next.js App Router 例） **state ヘルパ** `lib/.ts`: ```ts import fs from 'fs'; import os from 'os'; import path from 'path'; const CACHE = path.join(os.homedir(), '.-state', '.json'); export function readCache(){ try{ if(!fs.existsSync(CACHE))return{cache:null,mtime:null}; const st=fs.statSync(CACHE); return {cache:JSON.parse(fs.readFileSync(CACHE,'utf-8')),mtime:st.mtime.toISOString()};}catch{return{cache:null,mtime:null}} } export function writeCache(c:any){ fs.mkdirSync(path.dirname(CACHE),{recursive:true}); fs.writeFileSync(CACHE,JSON.stringify(c),'utf-8'); } ``` **ingest（POST・共有シークレット認証）** `app/api//ingest/route.ts`: ```ts export const runtime='nodejs'; export const dynamic='force-dynamic'; export async function POST(req){ const secret=process.env._INGEST_SECRET?.trim(); const given=(req.headers.get('x--secret')||'').trim(); if(!secret||given!==secret) return new Response('forbidden',{status:403}); let body; try{ body=await req.json(); }catch{ return new Response('bad json',{status:400}); } if(!body||!Array.isArray(body.items)) return new Response('bad shape',{status:400}); writeCache(body); return Response.json({ok:true}); } ``` **read（GET・鮮度判定つき）** `app/api//route.ts`: `readCache()` を返し、`generatedAt` から N 時間超なら `stale:true`。 **widget**: `/…/api/` を fetch して表示。重要度で色分け（red/orange/yellow）+ 各データ源の現在地行。 ## 実装（CI 側 / Python 例） 対象データ源を読む → LLM に「今日やることTOP3＋各源の現在地」を**厳密JSONスキーマ**で出力させる → ingest へ POST。 ```python res = requests.post(os.environ["_INGEST_URL"], json=payload, headers={"x--secret": os.environ["_INGEST_SECRET"]}, timeout=30) res.raise_for_status() ``` cron は遅延しうるので複数時刻に仕掛け、「当日すでに成功した実行があればスキップ」する preflight を置く。 ## 必ず踏む罠（実測） 1. **CIの未設定変数は「空文字」で渡る**: `SOME: ${{ vars.SOME }}` は変数未設定でも空文字で env に入る。`os.environ.get(name, default)` は default に落ちず空文字を返す→IDが空→404。**空もmissing扱い**にする: `v=os.environ.get(name,"").strip(); return v or default`。JS も `process.env.X?.trim() || default`（`??` は空文字を通すので不可）。 2. **本番ビルドの stale**: PWA を dev でなく本番ビルド(例 `next start`)で動かしている場合、新ルート/新widgetを足しても **再ビルド＋プロセス再起動しないと 404**（古いビルドが提供される）。`.env` 変更も要再起動。 3. **検証は必ず dry-run で実データを一度通す**: POST前に「生成JSONをログ出力するだけ」のモードを作り、各データ源が実際に読めているか（空/404でないか）を目視してから本番POSTに切り替える。罠1はこれで気づけた。 4. **ingest は共有シークレット必須**: トンネル公開エンドポイントは誰でも叩けるので、ヘッダの共有シークレットで認証。誤シークレットは 403。 5. **LLM出力は厳密JSON強制＋寛容パーサ**: スキーマをプロンプトで固定し、コードブロック混入・制御文字を剥がすフォールバックパーサを噛ませる。 ## 横展開 データ源が増えても「CIで読む源を1つ足す→スキーマに1フィールド足す」だけ。表示先も widget 追加で拡張可能。1つの ingest 方式を決めておけば、別ジョブ（別種の集計）も同じ経路で PWA に相乗りできる。 ---