複数データ源→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/<name>.ts:

import fs from 'fs'; import os from 'os'; import path from 'path';
const CACHE = path.join(os.homedir(), '.<app>-state', '<name>.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/<name>/ingest/route.ts:

export const runtime='nodejs'; export const dynamic='force-dynamic';
export async function POST(req){
  const secret=process.env.<NAME>_INGEST_SECRET?.trim();
  const given=(req.headers.get('x-<name>-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/<name>/route.ts: readCache() を返し、generatedAt から N 時間超なら stale:true。

widget: /…/api/<name> を fetch して表示。重要度で色分け（red/orange/yellow）+ 各データ源の現在地行。

実装（CI 側 / Python 例）

対象データ源を読む → LLM に「今日やることTOP3＋各源の現在地」を厳密JSONスキーマで出力させる → ingest へ POST。

res = requests.post(os.environ["<NAME>_INGEST_URL"], json=payload,
        headers={"x-<name>-secret": os.environ["<NAME>_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 に相乗りできる。