kakeibo-memo: LINE Flex 月次サマリ調査

調査のみ。kakeibo-memo への実装 PR なし。本番 LINE 送信なし。金額は合成例。個人の支出実額・家族の実名・チャネル鍵・.env は載せない。

1. スクショ契約と既存コードの対応

2. 既存の送り方（呼び出し経路）

ユーザーが LINE で「サマリ」と送ると、Webhook が Flex を Reply API で返す。Push / 定期配信の専用関数は src/ にも docs/ にも無い。

1. amplify/function/line-webhook/handler.ts が X-Line-Signature を検証し、text / postback を処理する。
2. 本文 サマリ → MessageBuilder.createSummarySelectionMessage()（カルーセル。月別 / 年別 × 支払い方法別 / タイプ別）。
3. postback summary_month_payment → 状態 WAITING_SUMMARY_MONTH_SELECTION + 月選択 Flex。
4. 本文 YYYY年M月 → TransactionService.getMonthlySummary(ownerID, year, month, "payment")。
5. MessageBuilder.createMonthlySummaryMessage(...) がスクショ形の Flex を組み立てる。
6. replyMessage(client, replyToken, [flex]) が LINE Messaging API の Reply に載せる。

集計

getMonthlySummary は LKM-Transaction を年月で取り、支払い方法 ID または費目 ID で合算する。ラベルは LKM-PaymentMethod / LKM-Type の name。金額降順。月はゼロ埋めする。

amplify/function/line-webhook/service/transactionService.ts :: getMonthlySummary

3. src/ と docs/ の証拠

4. 差し込み点（実装しない。触るならここ）

スクショ形は既にある。後続 Job でレイアウトや集計を変える場合の最小地点:

createSummaryMessage（タイトル「サマリレポート」）も同ファイルにあるが、handler からの呼び出しは見当たらない。現行のスクショ形は createMonthlySummaryMessage。

年次は createYearlySummaryMessage（積み上げ縦棒 + 凡例）。契約の「月次 + 支払い方法別横棒」とは別。

5. Flex JSON 骨格（ダミー金額）

createMonthlySummaryMessage("2026", "9", "payment", 48000, ...) 相当。色配列の先頭 3 色を使用。

{
  "type": "flex",
  "altText": "2026年9月サマリ",
  "contents": {
    "type": "bubble",
    "header": {
      "type": "box",
      "layout": "vertical",
      "contents": [
        {
          "type": "text",
          "text": "2026年9月サマリ",
          "weight": "bold",
          "size": "xl",
          "color": "#1DB446"
        },
        {
          "type": "text",
          "text": "支払い方法別",
          "size": "xs",
          "color": "#aaaaaa"
        },
        {
          "type": "text",
          "text": "総支出: ¥48,000",
          "size": "lg",
          "weight": "bold",
          "margin": "md"
        }
      ]
    },
    "body": {
      "type": "box",
      "layout": "vertical",
      "contents": [
        {
          "type": "box",
          "layout": "horizontal",
          "margin": "md",
          "contents": [
            { "type": "text", "text": "現金 (40%)", "size": "sm", "color": "#555555", "flex": 1 },
            { "type": "text", "text": "¥19,200", "size": "sm", "color": "#111111", "align": "end", "flex": 1 }
          ]
        },
        {
          "type": "box",
          "layout": "vertical",
          "margin": "xs",
          "contents": [
            {
              "type": "box",
              "layout": "horizontal",
              "backgroundColor": "#f0f0f0",
              "cornerRadius": "2px",
              "height": "6px",
              "width": "100%",
              "contents": [
                {
                  "type": "box",
                  "layout": "vertical",
                  "width": "40%",
                  "height": "6px",
                  "backgroundColor": "#FF6384",
                  "cornerRadius": "2px",
                  "contents": []
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

6. 未実装（根拠つき。捏造しない）

• src/ 配下に flex / replyMessage / Messaging API クライアントは無い。LINE リッチ送信のフロント実装は未実装。
• docs/仕様書.md は Echo Bot 仕様のまま。Flex 月次サマリは未記載。
• ユーザー操作なしの定期 Push（月末自動配信など）は、読んだ src/ docs/ line-webhook/handler.ts には無い。
• 本 Job では kakeibo-memo にコードを足していない。本番送信もしていない。

7. 調査範囲と除外

• 読んだ正本: hayashiroto/kakeibo-memo src/ docs/。LINE 送信の有無を確かめるため amplify/function/line-webhook も読んだ（README が Flex サマリを謳っているため）。
• コミット: 3e36f0c728d9ccafdc795bea120030db47285462。
• 載せていないもの: 個人の支出実額、家族の実名が付いた支払い方法、チャネルシークレット、アクセストークン、.env。
• この HTML は調査メモ。ge_issues_status.html ではない。