フルスタック・エンタープライズ設計白書電帳法 × インボイス制度 技術・DB監査準拠ゼロトラスト設計 & 7年間(84ヶ月)法定保存対応

レピット (Repit) システム技術アーキテクチャ&実装詳解

iOS(Swift 6 / SwiftUI)と Android(Kotlin 2.1 / Jetpack Compose)の純ネイティブ両OSアプリ、静的エッジ配信の Next.js Webワークベンチ、東京リージョンの Python / FastAPI 非同期エンジン、そして PostgreSQL カーネルレベルの改ざん防止監査機構まで。「AIの文脈理解力」と「決定論的コードの厳密性」を融合し、高い信頼性とセキュリティ基準で日本の電帳法・インボイス制度を完全実装したシステム設計を解説します。

< 0.1 ms端末内 Modulus 9 検査不正13桁番号を通信前に99%遮断
< 3.0 ms高速2次キャッシュ照合公的機関APIの遅延 300〜800ms を解消
±¥0 誤差確定性算術ガード (Math Guard)10%・8%・不課税の合計整合を全件検証
≥ 200 dpiスキャナ保存 自動解像度判定長辺1600px圧縮 & RGB 24bit 階調検査
100% 不変改ざん防止・不変監査設計訂正・削除の変更前後履歴を自動保全
2,555 日 (7年)7年間(84ヶ月)暗号化保全AES-256 遠隔バックアップ&長期アーカイブ
🏗️ システム全体構造(5層アーキテクチャ)各レイヤーをクリックして技術仕様・防御境界を確認

クライアントから電帳法監査DB・7年遠隔保全までを結ぶ、5層ゼロトラスト構成。

各層は明確な責務境界と障害フォールバックを備えています。左のレイヤー一覧から任意の層を選択すると、採用技術スタック・安全性保証・主要アーキテクチャ領域を確認できます。

Layer 1 · Multi-Platform Clients

iOS / Android 純ネイティブ & 静的エッジ Web クライアント層

OS標準のドキュメントスキャン・視覚フレームワークと静的エッジ配信を組み合わせ、端末内での高速前処理と高いアクセシビリティを両立

セキュリティ・稼働特性端末内エッジ処理 / オフライン耐性

iOS ネイティブアプリ

Swift 6.0 (Strict Concurrency) / SwiftUI / VisionKit / SwiftData / StoreKit 2

OS標準スキャナによる自動台形補正・背景除去、長辺1600px・200dpi相当の解像度判定、VoiceOver・Dynamic Type へ完全対応。

Android ネイティブアプリ

Kotlin 2.1 (K2) / Jetpack Compose M3 / ML Kit Document Scanner / Room / Play Billing

iOS と対称なクリーンアーキテクチャ設計。TalkBack・Font Scaling 設定に応じてレイアウトが動的に折り返されるアクセシビリティ設計。

PC金庫ワークベンチ & 公式公開ツール

Next.js 15 (Static Export) / React 19 / TypeScript 5.7 / Tailwind CSS 4 / Radix UI

PC金庫 2画面AI照合 (/vault)・T番号一括確認 (/verifier)・7大税務標本デモ・閲覧専用監査ビューア (/proof) を静的エッジで高速配信。

このレイヤーで担保される技術・コンプライアンス要件

  • 端末内 0.1ms モジュラス9 チェックデジット検証により、不正な13桁番号をサーバー通信前に遮断
  • 送信前の解像度・RGB 24bit 階調チェックおよび適正リサイズにより、高品質スキャンと高速応答を両立
  • ネットワーク不通時やAI障害時は、端末内ローカルOCR基盤へ自動フォールバックし記録業務を継続可能
主要アーキテクチャ領域:
VisionKit スキャン前処理ML Kit ネイティブ検査Modulus 9 ローカル検証
⚡ 0.5秒 エンドツーエンド処理パイプラインSTEP 01 〜 06 データ変換・検証フロー

「ピッと撮る」から「電帳法準拠の確定台帳」まで、6段階の精密なデータ・パイプライン。

1枚の領収書が端末でスキャンされてから不変ストレージと監査DBへ永続化されるまでの各工程と、入出力データの標本・障害時フォールバック方針をステップごとに確認できます。

STEP 01応答目標: 約 35 ms(ネットワーク送信前)

端末内エッジ前処理・200dpi解像度検証・SHA-256算出

担当レイヤー:iOS (VisionKit) / Android (ML Kit) / Web (Canvas)
コンポーネント役割:Edge Document Scanner & DPI Validator

OS標準ドキュメントスキャナで背景除去・台形歪み補正を実行。送信前に最適解像度(長辺1600px)へ整えつつ、電帳法スキャナ保存要件(≥200dpi相当・RGB 24bit階調)と SHA-256 デジタル指紋を端末内で確定します。

設計上の不変条件(Invariants)

  • ✓ 最適解像度圧縮により、画像認識精度を損なわずにアップロード待機時間を大幅に短縮
  • ✓ 解像度不足(<200dpi相当)やグレースケール時は保存前に警告を提示し、原本破棄可否を明示
  • ✓ 同一原本の SHA-256 ハッシュ重複を事前検知し、無用な再解析と二重計上を防止
障害時フォールバック / エッジケース方針:PDF電子取引データの場合は再エンコードを行わず原本バイナリから直接 SHA-256 を算出し、保存区分を電子取引データとして保護。
STEP 01 端末検証メタデータ例(抜粋)
{
  "preservation_type": "SCANNER",
  "resolution_width": 1200,
  "resolution_height": 1600,
  "color_mode": "RGB_24BIT",
  "estimated_dpi": 312,
  "is_200dpi_compliant": true,
  "sha256_digest": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
💻 コア実装アルゴリズム & 技術仕様詳解公的規格準拠・全6モジュール仕様

日本の財税・電帳法要件をシステムへ落とし込んだ、6大コアエンジンの設計詳細。

公開標準アルゴリズムである Modulus 9 チェックデジット検証、AI算術ガード、2026年10月改正の経過措置ロジックに加え、カーネル監査設計、両OS対称MVI連携、3言語APIガバナンスと事務処理規程PDF合成の設計思想を解説します。

0.1ms 前置遮断 + <3ms キャッシュ照合Modulus 9 アルゴリズム仕様 · 国税庁4層キャッシュ設計

13桁 T番号チェックデジット計算(国税庁公開仕様準拠)& 時点有効性判定

日本国税庁が公開する法人番号・T番号の Modulus 9 アルゴリズム仕様を端末・サーバー双方に実装。1桁の打ち間違いやOCR誤読をネットワーク通信なしで即座に検出し、有効形式のみを取引日時点の登録・取消日と照合します。

アーキテクチャ設計ポイント

  • C1 = 9 - (Σ Pn × Wn mod 9)(右端を1桁目とし奇数桁×1・偶数桁×2、剰余0のとき検査数字は9)
  • 取引日 < 登録年月日 → NOT_YET_REGISTERED / 取引日 >= 取消年月日 → CANCELLED_BEFORE_TX
  • 公表事業者は適応型TTLで2次キャッシュへ保持し、未登録番号も短期間の負のキャッシュで保護
TypeScript / Python 参照実装
// 1. 端末内 0.1ms Modulus 9 チェックデジット検証(公開仕様アルゴリズム)
export function validateTNumberModulus9(rawInput: string): TNumberValidationResult {
  const normalized = normalizeTNumber(rawInput); // 全角・ハイフン・小文字を除去し T+13桁へ正規化
  const digits = normalized.slice(1);
  const actualCheckDigit = Number(digits[0]);

  let weightedSum = 0;
  for (let i = 1; i < 13; i++) {
    const posFromRight = 13 - i;
    const weight = posFromRight % 2 === 1 ? 1 : 2;
    weightedSum += Number(digits[i]) * weight;
  }
  const expectedCheckDigit = 9 - (weightedSum % 9);
  return {
    normalized,
    isValidCheckDigit: actualCheckDigit === expectedCheckDigit,
    expectedCheckDigit,
    actualCheckDigit,
  };
}

# 2. 取引日時点ステータス判定ロジック
def evaluate_point_in_time_status(record: IssuerTimeline, tx_date: date) -> str:
    if record.registration_date and tx_date < record.registration_date:
        return "NOT_YET_REGISTERED"  # 取引日時点では未登録
    if record.cancellation_date and tx_date >= record.cancellation_date:
        return "CANCELLED_BEFORE_TX" # 取引日以前に登録取消済 → 経過措置へ自動降格
    if record.expire_date and tx_date >= record.expire_date:
        return "EXPIRED_BEFORE_TX"
    return "VALID_ACTIVE"            # 取引日時点で有効(100%仕入税額控除可)
🗄️ データモデル設計 & 電帳法コンプライアンス仕様PostgreSQL 16+ 論理データ設計

真実性・可視性・2026年税制をデータ構造で強制する、5つのコンプライアンス・モデル。

電帳法が求める「スキャナ保存 vs 電子取引の区分」「訂正・削除履歴の不変保存」「取引年月日・金額・取引先の3条件検索」を、データモデルの整合性制約とカーネルレベル監査機構によってシステム的に担保しています。

MODEL 01 · 中核トランザクション・データモデル

証憑・適格請求書台帳モデル

UUID v4 主キー / 事業者・アカウント境界分離

スキャナ保存(紙領収書)および電子取引(PDF)の原本参照・3税率明細・特例判定・家事按分を一元管理する論理モデル。

保持する主な論理属性

  • 保存区分(スキャナ保存 / 電子取引データ保存)
  • 解像度証跡(≥200dpi判定フラグ・幅/高さpx・RGB階調情報)
  • 原本 SHA-256 デジタル指紋・暗号化ストレージ参照キー
  • 取引年月日・税込合計金額・法定法人名・レシート記載屋号
  • インボイス登録番号・取引日時点の検証ステータス履歴
  • 10% / 8%軽減 / 不課税の内訳・算術ガード整合結果
  • 適用税制特例区分・仕入税額控除率・家事按分率・事業経費額

データ整合性・検索高速化機構

  • 同一ユーザー内でのファイル SHA-256 指紋の一意性保証(重複登録防止)
  • 電帳法「取引年月日 × 取引金額 × 取引先名」3条件複合検索インデックス
  • 日本語トライグラム(pg_trgm)による屋号・商号の部分一致高速検索
電帳法「可視性の確保」・スキャナ保存解像度証跡・インボイス区分台帳
MODEL 02 · 追記専用(Append-Only)監査台帳

改ざん防止・訂正削除履歴モデル

時系列シリアル識別子 / 証憑ID関連付け

データベースカーネルレベルのイベントフックによってのみ書き込まれる、訂正・削除の完全証跡モデル。

保持する主な論理属性

  • 対象証憑モデルへの不変外部参照
  • 操作種別(新規登録 / 訂正更新 / 論理削除 / 復元)
  • 改ざん不能なデータベースサーバー確定時刻(UTC/JST)
  • セッション境界から確定された実行操作者識別子
  • 変更前レコード全体のスナップショット(構造化JSON)
  • 変更後レコード全体のスナップショット(構造化JSON)
  • 利用者が入力した訂正・削除の正当理由テキスト

データ整合性・検索高速化機構

  • 証憑と監査時刻の複合時系列インデックスによる瞬時の監査タイムライン描画
  • アプリケーションからの監査行 UPDATE / DELETE を許容しない追記専用権限分離
電帳法第4条第3項「訂正及び削除の事実・内容の確認」要件をタイムスタンプ費 ¥0 で担保
MODEL 03 · 公的機関 Web-API 2次永続キャッシュ

適格請求書発行事業者キャッシュモデル

正規化T番号 (T + 13桁法人番号)

国税庁 Web-API から取得した登録番号・法人名・登録日・取消日・失効日・店舗屋号を永続化し、3ms未満の照合を実現。

保持する主な論理属性

  • 13桁法人番号 & 正規化T番号キー
  • 国税庁公表の法定商号・フリガナ & レシート屋号マッピング
  • 登録ステータス(有効 / 登録取消 / 失効 / 未登録)
  • 登録年月日・取消年月日・失効年月日(時点判定の基準日群)
  • 適応型キャッシュ有効期限(有効事業者:長期 / 未登録番号:短期保護)

データ整合性・検索高速化機構

  • B-Tree 主キー探索による <3ms の高速事業者ステータス解決
  • 負のキャッシュ保護により存在しない不正番号の連続問い合わせを遮断
国税庁サーバー負荷軽減・取引日時点の失効判定・API障害時レジリエンス
MODEL 04 · 事業者メタデータ & 利用権利台帳

事業者プロファイル・家事按分モデル

認証プロバイダ独立ID / べき等サブスクリプション識別子

屋号・代表者氏名・科目別デフォルト家事按分率と、iOS / Android アプリ内課金および利用配額を安全に管理。

保持する主な論理属性

  • 認証プロバイダ区分(Sign in with Apple / Google / Email 等)
  • 屋号・法人名・代表者氏名(事務処理規程PDF自動差し込み用)
  • 勘定科目別デフォルト家事按分率プリセット
  • 現在プラン区分(Free / Pro 月額・年額 / 確定申告パス)
  • ストア購読権利・AI利用配額および7年間データ閲覧維持フラグ

データ整合性・検索高速化機構

  • 認証プロバイダ識別子の一意制約とWebhook処理の冪等性保証
  • 解約・プラン終了後も法定7年間のデータ閲覧・出力権限を保護
事務処理規程PDF生成の事業者メタデータ源・解約後7年データ閲覧権限維持
MODEL 05 · ゼロトラスト短命セッション委譲

マルチデバイス一時連携モデル

暗号論的ワンタイム識別子 / 単回利用ロック

スマホアプリで発行したワンタイムコードのみを検証し、PCブラウザ版ワークベンチへ安全にセッションを連携。

保持する主な論理属性

  • 暗号論的乱数による短命ワンタイムコード
  • 発行元モバイル利用者の検証済みセッション参照
  • 厳格な短時間有効期限(タイムアウト自動失効)
  • 利用完了タイムスタンプ(1回の交換後に即座に消費・無効化)

データ整合性・検索高速化機構

  • ワンタイムコード一意制約と原子的消費(Atomic Consume)によるリプレイ攻撃防止
  • 有効期限超過レコードの自動クリーンアップ設計
パスワードや長寿命認証トークンをPC画面に入力・露出させないゼロトラスト認証連携
🛡️ 環境物理分離 & 7年間暗号化保全ゼロトラスト・プライバシー保護運用

検証・本番環境の完全物理分離 & 7年間(84ヶ月)AES-256 暗号化バックアップ体制。

リリース検証用サンドボックスとお客様の本番データ基盤をコンピュート・データベース・認証資格情報のすべてで物理的に分離。検証作業やテストデータが本番台帳へ混入するリスクを構造的に排除しています。

分離レイヤー検証環境(サンドボックス)本番環境(プロダクション)
コンピュート基盤独立サンドボックス・コンテナ環境日本国内リージョン(東京)専用本番環境
データベース層検証専用データセット(実顧客データ非混入)独立本番PostgreSQL(7年AES-256暗号化対象)
秘密鍵・API資格情報検証専用プロジェクト境界で隔離管理GCP Secret Manager による厳格アクセス統制
国税庁 Web-API 接続モード高精度ローカル検証サンドボックスへ自動切替正式事業者資格によるTLS 1.3 暗号化プロキシ接続
多端末連携トークン境界環境識別タグ付き短命セッション(本番と非互換)本番限定・単回消費型ワンタイムセッショントークン

AES-256 暗号化遠隔バックアップ & 7年長期保全

本番データベースのスナップショットを自動パイプラインで圧縮・強固な共通鍵暗号化(AES-256-CBC / PBKDF2鍵導出)を施したうえで、WORM保護された遠隔オブジェクト金庫へ継続退避します。

Snapshot Export → Stream Compression → AES-256-CBC Encryption → WORM Off-Site Archive
  • ✓ 日次リカバリポイント:直近30日分の暗号化復旧点を自動ローテーション保持
  • ✓ 長期アーカイブ(2,555日):月次スナップショットを電帳法法定期間7年間保管
  • ✓ 解約後の閲覧保護:契約終了後も法定保存期間中の原本ZIP・会計CSV出力を維持

ゼロトラスト・プライバシー & AI学習完全オプトアウト設計

領収書や取引明細は機微な財務情報そのものです。レピットは外部へのデータ販売や広告利用を一切行わない収益構造と、AI・ストレージ両面のゼロトラスト保護を前提に設計されています。

  • ✓ AIモデル学習への完全不利用:Gemini 2.5 Flash 商用有償枠 (Zero Data Retention) を採用
  • ✓ 原本削除権限のIAM遮断:WORM構成により第三者やプログラム不具合での原本喪失を防止
  • ✓ 論理削除+変更前後履歴保全:誤削除時も不変監査台帳から経緯とデータの追跡が可能
  • ✓ 効率的サーバーレス基盤:無駄な中間仲介を排し、透明性の高い安心価格で長期運用を実現
📚 フルスタック採用技術一覧

全プラットフォーム採用技術スタック & 関連ワークベンチ案内

領域・レイヤー採用技術・フレームワーク選定理由・設計上の優位性
モバイル (iOS)Swift 6.0 (Strict Concurrency) / SwiftUI / VisionKit / CoreImage / SwiftData / StoreKit 2ネイティブ高精度書類補正・長辺1600px圧縮 & ≥200dpi自己検証・VoiceOver & Dynamic Type完全対応・iOS 17+
モバイル (Android)Kotlin 2.1 (K2) / Jetpack Compose M3 / Google ML Kit Document Scanner / Room / Play BillingiOS と対称の MVI アーキテクチャ・TalkBack & Font Scaling 動的折返し・Android 14+ (API 34+)
Web (LP / ワークベンチ)Next.js 15 (Static Export) / React 19 / TypeScript 5.7 / Tailwind CSS 4 / Radix UI / Cloudflare Pages静的エッジ配信で高速表示・WAI-ARIA準拠・和紙ライト×藍墨ダーク・130%文字拡大対応
バックエンド APIPython 3.12 / FastAPI / Pydantic v2 / SQLAlchemy 2.0 (Async / asyncpg) / ReportLab確定性算術ガード・2026年50%経過措置エンジン・CP932/UTF-8 BOM会計出力・事務処理規程PDF・3言語 OpenAPI 統制
AI・外部公的APIGemini 2.5 Flash (Paid Commercial Tier) + 日本国税庁 適格請求書公表システム Web-API商用有償枠によるAIモデル学習完全オプトアウト・4層防衛プロキシ・オフラインOCRフォールバック
クラウド・DB・長期保全GCP Cloud Run (東京) / PostgreSQL 16+ (東京) / WORMオブジェクト金庫 / AES-256 遠隔アーカイブDBカーネル監査設計・IAM削除禁止WORM原本保存・AES-256暗号化遠隔バックアップ (7年保持)