巻物を探す
10件の巻物
請求書PDF→会計CSV 自動変換パイプラインMD
メール添付やフォルダ投込みの請求書PDFから金額・日付・取引先を抽出し、会計ソフト取込用CSVに変換するパイプラインを AI に作らせる指示書。Claude API の構造化抽出プロンプト込み。
freee会計API 取引先自動連携ガイド(OAuth/トークンローテーション/DRY-RUN)
Next.js+SupabaseアプリからfreeeのOAuth接続・refresh_tokenローテーション対応・取引先の自動紐付け/新規作成をDRY-RUN安全に実装する手順
freee会計API: 税区分一覧が403でも税区分コードを実測で確定する（控80→控50切替・取引先削除の落とし穴つき）
税区分APIが403のアプリで、テスト事業所に取引を作り仕訳帳CSVで名前を読んで固定表にする手順。非適格の経過措置を発生日で切り替える注意と、取引先は使用停止してから削除する点も。
ローテーションするOAuth2リフレッシュトークンをDB永続化して壊れないようにする型
freee/Google等でリフレッシュトークンがローテーションし env固定だと初回更新後に必ず壊れる問題を、トークンをDBに持ち更新のたび書き戻す型で解決。マスタID取得・冪等ガード・段階導入まで含む会計API連携の定石。
払った額（カード明細）と使った額（実行ログ）を突合してAI費用の計上漏れを洗い出す
会計カード明細とCLI実行ログの2データ源を月次で機械突合し、計上漏れを経理が『登録待ちリスト』だけ確認すれば済む形にする手順。4状態判定・dry-run→read-back→本実行・人の記入列を書かない安全則つき
既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする
現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
Square の決済データを月次集計して Next.js のトップに売上ダッシュボードを出す
Square Payments API をページングして JST で月次集計（COMPLETED・返金控除）、30分キャッシュ＋stale フォールバックの API、スマホ向け進捗カードと月別表。生成AIが実際に出したバグ2件のレビュー観点と本番検証手順つき
Apps Script ゲートウェイ経由の無人ジョブが稀に Unauthorized で落ちる — 本文落ちの判定と有界リトライ
GAS Web App を API ゲートウェイにした Node の夜間ジョブが、トークンも正しいのに稀に Unauthorized / 非JSON で落ちる。受信ログの (no action) で「POST 本文が落ちた一時障害」と 30 秒で判定し、一時障害の署名だけを 2s→4s→8s で有界リトライする分類関数・テスト・本番入口での検証手順まで。
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。