ledra-hp-ops

Ledra

自動車整備 / ボディリペア / コーティング / PPF 店向けのマルチテナント SaaS。 施工証明書発行、請求・帳票、顧客ポータル、予約、保険会社 (損保) との案件連携、 部品装着インテグリティ (装着部品の真正性証明)、AI 業務自動化、 ブロックチェーン・アンカリング + RFC3161 タイムスタンプによる 証明書・装着記録の改ざん検知までを一本化して提供します。

Next.js 16.2 (App Router) + React 19.2 (React Compiler)
Supabase (Postgres + Storage + Auth) · Stripe · Upstash Redis + QStash
Sentry · Resend (+ SendGrid fallback) · Anthropic (Opus 4.8 / Sonnet 4.6 / Haiku 4.5)
@react-pdf/renderer · viem/ethers · RFC3161 TSA · Twilio · LINE · Healthchecks.io

ディレクトリ概観

src/
├── app/                       Next.js App Router
│   ├── (marketing)/           公開 LP (SSG / ISR)
│   ├── admin/                 店舗オーナー (tenant 管理者) 画面
│   ├── agent/                 代理店 (Agent) 画面
│   ├── insurer/               損保ユーザー画面
│   ├── manufacturer/          メーカー (Manufacturer) 画面
│   ├── market/                中古車マーケット
│   ├── passport/              車両パスポート (vehicle passport)
│   ├── parts/                 部品装着インテグリティ (納車時の顧客確認 UI)
│   ├── customer/, c/, my/     顧客ポータル
│   ├── sign/, agent-sign/     電子署名フロー
│   └── api/                   490+ Route Handlers (35 トップレベルグループ)
│       ├── cron/              Vercel Cron (billing, follow-up, monitor, news, etc.)
│       ├── qstash/            非同期ジョブ (batch-pdf, polygon-backfill, 等)
│       ├── parts/             装着インジェスト / 監査 findings / 確定 / LINE 連携コード
│       ├── stripe/            webhook + portal
│       ├── v1/                外部公開 API (tenant API key 認証)
│       └── webhooks/          受信 webhook (Square / LINE / etc.)
├── lib/
│   ├── supabase/              service-role / ssr / mobile 用クライアント
│   ├── api/                   API 共通 (auth, rateLimit, response, safeJson)
│   ├── http/                  withRetry — 外向き呼び出しの retry + circuit breaker
│   ├── email/                 sendEmail (Resend → SendGrid フォールバック)
│   ├── ai/                    Anthropic structured outputs + withRetry ラップ
│   │   └── automation/        AI 自動化 orchestrator (写真改ざん検知 / 不正スコア 等)
│   ├── parts/                 部品装着インテグリティ (TSA / アンカー / 確定署名 / 照合)
│   ├── billing/               プラン / Stripe subscription ガード
│   ├── signature/             電子署名 + PDF 署名
│   ├── anchoring/             Polygon アンカリング
│   ├── cron/                  follow-up / failureTracker (連続失敗 + cooldown 通知)
│   ├── observability/         Sentry context + Healthchecks.io heartbeat
│   ├── security/              CSP header builder (nonce-based)
│   ├── customerPortal*.ts     マイページ認証 (OTP ベース)
│   ├── insurer/               insurer 向け共有ロジック
│   ├── logger.ts              structured JSON logger + correlationId
│   └── ...
├── components/                UI (admin / customer / marketing / ui)
├── content/                   MDX ブログ (marketing)
├── hooks/                     共通 React hooks
├── types/                     共有型 (Supabase 生成型を含む)
└── proxy.ts                   Next 16 proxy (旧 middleware)
                               ・x-request-id 採番 / 伝播
                               ・Origin/host チェックによる CSRF 防御
                               ・CSP nonce 発行 + header 付与
                               ・Supabase session リフレッシュ + 認証リダイレクト
                               ・rate limit プリセット適用

主要機能の柱

• 施工証明書 × 改ざん検知: 証明書を Polygon にアンカリングし、改ざん不能な 真正性を担保。写真必須ガード (下記) と組み合わせ「証拠付きの証明書」を発行します。
• 部品装着インテグリティ: 装着部品の真正性を、装着インジェスト → AI 自動検査 → 納品書 OCR との三方照合 → 確定署名 (OTP 所持証明 + 事業者署名 + RFC3161 TSA) → ブロックチェーン・アンカー → 納車時の顧客 LINE 確認、という一連で証明します。 ロジックは src/lib/parts/ (installationService / reconcileService / confirmationService / partSigning / tsa / rfc3161 / anchorService / metaAnchor)、設計は docs/parts-installation-integrity-design.md、 本番投入は docs/parts-integrity-golive-checklist.md。
• AI 業務自動化: src/lib/ai/ に 40+ の structured-output タスク、 src/lib/ai/automation/ に信頼系 auto-action の orchestrator を実装。 写真改ざん検知 (photoTamperingAuto) / 保険不正スコア (fraudScoreAuto) / 膜厚異常 (thicknessAuto) などは policy.ts のガード下で自動実行されます。 概説は docs/ai-automation-guide.md。

セキュリティ上のお約束