読み込み中
豆知識
本番環境でバックエンドがどう動いているか — クーロン、キュー、レート制限、セキュリティヘッダの方針です。シークレット・本番のホスト名・実 URL は載せていません。
毎日のバッチや定期同期は node-cron でローカル開発時にスケジュールされ、本番では Amazon EventBridge Scheduler から Lambda 経由で /api/cron/* が呼ばれます（UTC スケジュール。詳細はバックエンド api/cron/README.md / scripts/aws/bootstrap-backend.sh）。
| ジョブ | 本番の目安 (JST) | 役割 |
|---|---|---|
exchange-rate |
毎日 09:00 | 為替レートの取得・保存 |
bank-sync |
6 時間ごと | 連携済み銀行口座の明細同期 |
depreciation |
毎日 02:00 | 固定資産の減価償却 |
trial-balance / integrity-check / ledger-sync |
毎日 03:00 前後 | 試算表・整合性・台帳同期 |
cleanup / cleanup-lp-demos |
毎日 / 土曜 | 保持期間クリーンアップ・LP デモ掃除 |
insights / insights-weekly |
毎日 / 日曜 | インサイト生成 |
deadline-recompute / compliance-rule-engine / family-hiring-monitor |
深夜〜早朝 | 期日再計算・ルールエンジン・家族雇用モニタ |
keep-warm (/api/health) |
5 分ごと | Lambda ウォーム維持 |
各ジョブは API としても叩けます (GET|POST /api/cron/<job>)。本番では x-cron-secret（または Bearer）で認証され、誰でも呼べるわけではありません。
非同期ジョブは BullMQ 互換のインターフェイスで管理しています。重い AI 推論・大量エクスポート・PDF 生成などはキュー越しに走ります。
| キュー | 用途 |
|---|---|
ai-classification |
AI 仕訳分類・銀行取引分類のバッチ |
pdf-generation |
請求書・給与明細・申告書の PDF 生成 |
xtx-export |
e-Tax XTX ファイル生成 (有料機能) |
bulk-upload-process |
一括アップロード後の OCR・抽出 |
email-dispatch |
リマインダー・通知メールの送信 |
GET /api/queue でキューの状態 (待機・実行中・失敗の件数) を返します。
express-rate-limit ベースで、IP + ユーザー ID + ロールのバケットを組み合わせて制限します。AI / 公開デモ系は別バジェットです。
| 領域 | バジェット (おおよそ) |
|---|---|
| 一般 API | 認証ユーザー 600 req / 分 |
| 公開ヘルスチェック | 1 IP 60 req / 分 |
| 公開デモ (LP) | 1 IP 30 req / 分 (AI は 10 req) |
AI 推論 (/api/ai/*) |
会社単位の月次予算 (プラン依存) |
ドキュメント (/api-docs) |
1 IP 30 req / 分 |
認証 (/api/auth/*) |
1 IP 20 req / 分 |
超過時は 429 ERR_8001 Rate Limit Exceeded を返し、Retry-After ヘッダに復帰までの秒数を入れます。
会社ごとの 月次 AI バジェット で守られています。プランによって上限が違い、超過時は次のような挙動になります。
X-AI-Budget-Remaining ヘッダで通知403 PAID_FEATURE_REQUIRED でゲーティング詳細は サブスクリプション / 収益モデル を見てください。
helmet で全リクエストに付与: Content-Security-Policy, X-Content-Type-Options: nosniff, Strict-Transport-Security, Referrer-Policy, Permissions-Policyhpp + compression + toobusy-js (CPU 過負荷時の優雅な失敗) を組み合わせfile-type でマジックバイト検証 + サイズ上限audit_logs に記録 (誰が・いつ・何を・前後の差分)fiscal_periods.is_locked と書類のロック状態の両方で守られます読み込み中
豆知識