PropCloud - 機能仕様書

> **プロダクト名**: PropCloud（プロップクラウド）

> **バージョン**: 1.0.0

> **作成日**: 2026-03-19

> **ステータス**: Phase 2 設計

> **作成者**: CodeGenAgent（源）

目次

1. [概要](#1-概要)

2. [システムアーキテクチャ](#2-システムアーキテクチャ)

3. [データモデル設計](#3-データモデル設計)

4. [API設計](#4-api設計)

5. [画面設計](#5-画面設計)

6. [ホワイトラベル設計](#6-ホワイトラベル設計)

7. [認証・認可設計](#7-認証認可設計)

8. [外部連携設計](#8-外部連携設計)

9. [バッチ処理設計](#9-バッチ処理設計)

10. [非機能要件への対応方針](#10-非機能要件への対応方針)

1. 概要

1.1 プロダクト概要

1.2 プロダクトビジョン

PropCloudは、不動産管理会社の日常業務を包括的にデジタル化する賃貸管理クラウドシステムである。最大の特徴は**ホワイトラベル対応**であり、同業他社が自社ブランドとして販売・カスタマイズできるプラットフォームとして設計する。

ビジネスモデル概要

開発者（自社）
    ├── 直販: 自社ブランドとして販売・利用
    └── OEM/ホワイトラベル販売
         ├── 販売パートナーA社 → A社ブランドとして販売
         ├── 販売パートナーB社 → B社ブランドとして販売
         └── ...（最大1,000テナント）

1.3 対象ユーザー

1.4 開発フェーズ

1.5 前提条件・制約

1.6 対応法令・規制

2. システムアーキテクチャ

2.1 全体構成図

graph TB
    subgraph "クライアント層"
        Browser["ブラウザ<br/>(Chrome/Edge/Safari)"]
        Mobile["モバイル<br/>(ポータル利用)"]
    end

    subgraph "CDN/エッジ層"
        CF["CloudFront<br/>(CDN)"]
        R53["Route 53<br/>(DNS)"]
        ACM["ACM<br/>(SSL証明書)"]
    end

    subgraph "アプリケーション層"
        subgraph "ECS Fargate Cluster"
            NextJS_1["Next.js App<br/>Container #1"]
            NextJS_2["Next.js App<br/>Container #2"]
            NextJS_N["Next.js App<br/>Container #N"]
        end
        ALB["Application<br/>Load Balancer"]
    end

    subgraph "API層"
        TRPC["tRPC Router"]
        APIRoutes["Next.js API Routes"]
        Middleware["Middleware<br/>(Auth/Tenant/Rate Limit)"]
    end

    subgraph "ワーカー層"
        subgraph "ECS Fargate Workers"
            Worker1["バッチワーカー<br/>(請求生成/消込)"]
            Worker2["通知ワーカー<br/>(メール/SMS)"]
            Worker3["帳票ワーカー<br/>(PDF生成)"]
        end
        BullMQ["BullMQ<br/>(ジョブキュー)"]
    end

    subgraph "データ層"
        subgraph "Primary DB"
            RDS_Primary["PostgreSQL<br/>RDS Primary<br/>(Multi-AZ)"]
            RDS_Replica["PostgreSQL<br/>RDS Read Replica"]
        end
        Redis["Redis<br/>(ElastiCache)<br/>セッション/キャッシュ"]
        S3["S3<br/>ファイルストレージ"]
    end

    subgraph "外部サービス"
        SES["Amazon SES<br/>(メール送信)"]
        KMS["AWS KMS<br/>(暗号化)"]
        SM["Secrets Manager<br/>(シークレット)"]
        SSM["SSM Parameter Store<br/>(設定値)"]
    end

    subgraph "監視・ログ"
        CW["CloudWatch<br/>(メトリクス/ログ)"]
        Sentry["Sentry<br/>(エラー追跡)"]
    end

    Browser --> CF
    Mobile --> CF
    R53 --> CF
    ACM --> CF
    CF --> ALB
    ALB --> NextJS_1
    ALB --> NextJS_2
    ALB --> NextJS_N
    NextJS_1 --> TRPC
    NextJS_1 --> APIRoutes
    TRPC --> Middleware
    APIRoutes --> Middleware
    Middleware --> RDS_Primary
    Middleware --> RDS_Replica
    Middleware --> Redis
    Middleware --> S3
    BullMQ --> Redis
    Worker1 --> RDS_Primary
    Worker2 --> SES
    Worker3 --> S3
    BullMQ --> Worker1
    BullMQ --> Worker2
    BullMQ --> Worker3
    RDS_Primary --> KMS
    NextJS_1 --> SM
    NextJS_1 --> SSM
    NextJS_1 --> CW
    NextJS_1 --> Sentry

2.2 技術スタック詳細

2.2.1 フロントエンド

2.2.2 バックエンド

2.2.3 インフラストラクチャ

2.3 マルチテナント設計

2.3.1 テナント分離方式

PropCloudは**共有データベース + Row Level Security（RLS）**方式を採用する。

graph TB
    subgraph "アプリケーション層"
        App["Next.js App"]
        MW["テナント解決<br/>Middleware"]
    end

    subgraph "テナント解決"
        Domain["カスタムドメイン<br/>tenant-a.example.com"]
        Subdomain["サブドメイン<br/>tenant-a.propcloud.jp"]
        Header["ヘッダー<br/>X-Tenant-ID"]
    end

    subgraph "データベース層"
        subgraph "PostgreSQL（共有DB）"
            RLS["Row Level Security"]
            T1["tenant_id = 'tenant-a'<br/>のデータのみアクセス可能"]
            T2["tenant_id = 'tenant-b'<br/>のデータのみアクセス可能"]
        end
    end

    subgraph "ストレージ層"
        S3_A["S3<br/>tenants/tenant-a/*"]
        S3_B["S3<br/>tenants/tenant-b/*"]
    end

    Domain --> MW
    Subdomain --> MW
    Header --> MW
    App --> MW
    MW -->|"SET app.current_tenant_id"| RLS
    RLS --> T1
    RLS --> T2
    MW -->|"prefix: tenants/tenant-a/"| S3_A
    MW -->|"prefix: tenants/tenant-b/"| S3_B

2.3.2 テナント解決フロー

1. リクエスト受信
2. Middleware でテナント解決
   - カスタムドメイン → domains テーブルから tenant_id 特定
   - サブドメイン → サブドメインから tenant_id 特定
   - ヘッダー → X-Tenant-ID から tenant_id 特定（API用）
3. PostgreSQL セッション変数に tenant_id をセット
   - SET app.current_tenant_id = 'tenant-xxx'
4. RLS ポリシーが自動的にテナントデータをフィルタ
5. 以降の全クエリはテナント分離される

2.3.3 RLS ポリシー定義

-- テナント分離の基本ポリシー
ALTER TABLE buildings ENABLE ROW LEVEL SECURITY;

CREATE POLICY tenant_isolation ON buildings
    USING (organization_id = current_setting('app.current_tenant_id')::uuid);

-- 全テーブルに同様のポリシーを適用
-- organizations テーブルのみ、プラットフォーム管理者は全テナント参照可能

2.3.4 テナント別リソース分離

2.4 ディレクトリ構造

src/
├── app/                          # Next.js App Router
│   ├── (auth)/                   # 認証関連ページ
│   │   ├── login/
│   │   ├── register/
│   │   └── forgot-password/
│   ├── (dashboard)/              # 管理画面レイアウト
│   │   ├── layout.tsx
│   │   ├── page.tsx              # ダッシュボード
│   │   ├── buildings/            # 物件管理
│   │   ├── units/                # 区画管理
│   │   ├── contracts/            # 契約管理
│   │   ├── payments/             # 入出金管理
│   │   ├── owners/               # オーナー管理
│   │   ├── tenants/              # 入居者管理
│   │   ├── maintenance/          # 修繕管理
│   │   ├── documents/            # 帳票・ドキュメント
│   │   ├── reports/              # レポート・分析
│   │   └── settings/             # 設定
│   ├── (portal)/                 # ポータルレイアウト
│   │   ├── owner/                # オーナーポータル
│   │   └── resident/             # 入居者ポータル
│   ├── (platform)/               # プラットフォーム管理
│   │   ├── organizations/        # テナント管理
│   │   └── system/               # システム設定
│   └── api/                      # API Routes
│       ├── trpc/                 # tRPC ハンドラ
│       ├── webhooks/             # Webhook受信
│       └── files/                # ファイルアップロード
├── server/                       # サーバーサイドロジック
│   ├── trpc/                     # tRPC定義
│   │   ├── router.ts             # ルートルーター
│   │   ├── context.ts            # コンテキスト（テナント解決含む）
│   │   └── routers/              # 各ドメインルーター
│   │       ├── building.ts
│   │       ├── unit.ts
│   │       ├── contract.ts
│   │       ├── payment.ts
│   │       ├── owner.ts
│   │       ├── tenant.ts
│   │       ├── maintenance.ts
│   │       ├── document.ts
│   │       ├── report.ts
│   │       ├── user.ts
│   │       └── organization.ts
│   ├── services/                 # ビジネスロジック
│   │   ├── billing.service.ts
│   │   ├── reconciliation.service.ts
│   │   ├── remittance.service.ts
│   │   ├── dunning.service.ts
│   │   └── ...
│   ├── jobs/                     # バッチジョブ
│   │   ├── monthly-billing.job.ts
│   │   ├── reconciliation.job.ts
│   │   ├── owner-remittance.job.ts
│   │   └── ...
│   └── integrations/             # 外部連携
│       ├── zengin/               # 全銀フォーマット
│       ├── e-contract/           # 電子契約
│       ├── accounting/           # 会計ソフト
│       └── notification/         # 通知
├── components/                   # 共通コンポーネント
│   ├── ui/                       # shadcn/ui ベースコンポーネント
│   ├── layout/                   # レイアウトコンポーネント
│   ├── forms/                    # フォームコンポーネント
│   ├── tables/                   # テーブルコンポーネント
│   └── charts/                   # チャートコンポーネント
├── lib/                          # ユーティリティ
│   ├── prisma.ts                 # Prismaクライアント
│   ├── redis.ts                  # Redisクライアント
│   ├── s3.ts                     # S3クライアント
│   ├── auth.ts                   # 認証ヘルパー
│   ├── tenant.ts                 # テナント解決
│   ├── utils.ts                  # 汎用ユーティリティ
│   └── validators/               # Zodスキーマ
├── hooks/                        # カスタムフック
├── stores/                       # Zustandストア
├── types/                        # 型定義
└── styles/                       # グローバルスタイル
    ├── globals.css
    └── themes/                   # テナントテーマ

2.5 通信フロー

sequenceDiagram
    participant Browser as ブラウザ
    participant CF as CloudFront
    participant ALB as ALB
    participant Next as Next.js
    participant TRPC as tRPC
    participant MW as Middleware
    participant DB as PostgreSQL
    participant Cache as Redis

    Browser->>CF: HTTPS リクエスト
    CF->>ALB: リクエスト転送
    ALB->>Next: リクエスト転送

    Note over Next: テナント解決
    Next->>MW: テナントID解決
    MW->>DB: SET app.current_tenant_id

    alt SSR（ページ初期表示）
        Next->>TRPC: サーバーサイドデータ取得
        TRPC->>Cache: キャッシュ確認
        alt キャッシュヒット
            Cache-->>TRPC: キャッシュデータ
        else キャッシュミス
            TRPC->>DB: クエリ実行（RLS適用）
            DB-->>TRPC: データ返却
            TRPC->>Cache: キャッシュ保存
        end
        TRPC-->>Next: データ返却
        Next-->>Browser: HTML + ハイドレーション
    else クライアントサイドAPI呼び出し
        Browser->>Next: tRPC クエリ/ミューテーション
        Next->>TRPC: API処理
        TRPC->>DB: クエリ実行（RLS適用）
        DB-->>TRPC: データ返却
        TRPC-->>Browser: JSON レスポンス
    end

3. データモデル設計

3.1 ER図（全体）

erDiagram
    Organization ||--o{ Building : "所有"
    Organization ||--o{ User : "所属"
    Organization ||--o{ OrganizationSetting : "設定"
    Organization ||--o{ CustomDomain : "ドメイン"
    Organization ||--o{ DocumentTemplate : "帳票テンプレート"
    Organization ||--o{ Plan : "契約プラン"

    Building ||--o{ Unit : "含む"
    Building ||--o{ ParkingSpace : "含む"
    Building }o--|| Owner : "所有者"
    Building ||--o{ BuildingImage : "画像"

    Unit ||--o{ Contract : "契約"
    Unit ||--o{ MaintenanceTicket : "修繕"

    Owner ||--o{ Building : "所有"
    Owner ||--o{ OwnerBankAccount : "口座"
    Owner ||--o{ Remittance : "送金"
    Owner ||--o{ CommunicationLog : "連絡履歴"

    Contract ||--|| Unit : "対象区画"
    Contract }o--|| Tenant : "契約者"
    Contract ||--o{ ContractGuarantor : "保証人"
    Contract ||--o{ Payment : "入出金"
    Contract ||--o{ Invoice : "請求"

    Tenant ||--o{ Contract : "契約"
    Tenant ||--o{ Cohabitant : "同居人"
    Tenant ||--o{ Vehicle : "車両"
    Tenant ||--o{ MaintenanceTicket : "問合せ"

    Invoice ||--o{ InvoiceItem : "明細"
    Invoice ||--o{ Payment : "入金"

    Payment ||--o{ PaymentAllocation : "消込"

    MaintenanceTicket ||--o{ MaintenanceComment : "コメント"
    MaintenanceTicket ||--o{ MaintenanceEstimate : "見積"
    MaintenanceTicket }o--|| Vendor : "業者"

    Vendor ||--o{ MaintenanceTicket : "担当"

    User ||--o{ AuditLog : "操作ログ"
    User }o--|| Role : "ロール"

    Remittance ||--o{ RemittanceItem : "明細"

3.2 ER図（コアドメイン詳細）

erDiagram
    Organization {
        uuid id PK
        string name
        string slug
        string plan_id FK
        string logo_url
        string favicon_url
        json theme_config
        json feature_flags
        json terminology_overrides
        string email_from_address
        string email_from_name
        int storage_limit_mb
        int storage_used_mb
        enum status "active/suspended/trial"
        timestamp trial_ends_at
        timestamp created_at
        timestamp updated_at
    }

    Building {
        uuid id PK
        uuid organization_id FK
        uuid owner_id FK
        string name
        string postal_code
        string prefecture
        string city
        string address1
        string address2
        decimal latitude
        decimal longitude
        enum structure "RC/SRC/S/W/LGS/other"
        date construction_date
        int total_units
        int floors_above
        int floors_below
        json shared_facilities
        json nearest_stations
        enum management_type "self/collection_agency/sublease/exclusive"
        decimal management_fee_rate
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Unit {
        uuid id PK
        uuid building_id FK
        uuid organization_id FK
        string unit_number
        int floor
        string layout
        decimal area_sqm
        enum direction "N/NE/E/SE/S/SW/W/NW"
        decimal rent
        decimal management_fee
        decimal common_fee
        decimal deposit_months
        decimal key_money_months
        json facilities
        enum status "vacant/occupied/leaving/recruiting/suspended/renovating"
        date available_from
        json recruitment_conditions
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Contract {
        uuid id PK
        uuid unit_id FK
        uuid tenant_id FK
        uuid organization_id FK
        enum contract_type "new/renewal/sublease"
        enum contractor_type "individual/corporation"
        date start_date
        date end_date
        decimal rent
        decimal management_fee
        decimal common_fee
        decimal deposit
        decimal key_money
        decimal renewal_fee_months
        json special_terms
        enum status "draft/active/renewed/terminated/cancelled"
        uuid guarantee_company_id FK
        date renewal_notice_date
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Tenant {
        uuid id PK
        uuid organization_id FK
        string last_name
        string first_name
        string last_name_kana
        string first_name_kana
        string email
        string phone
        string mobile_phone
        string postal_code
        string address
        string workplace_name
        string workplace_phone
        string emergency_contact_name
        string emergency_contact_phone
        string emergency_contact_relation
        date date_of_birth
        enum gender "male/female/other/unspecified"
        uuid user_id FK
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Owner {
        uuid id PK
        uuid organization_id FK
        enum owner_type "individual/corporation"
        string name
        string name_kana
        string representative_name
        string email
        string phone
        string postal_code
        string address
        enum tax_category "individual/corporation/non_resident"
        string tax_id
        uuid user_id FK
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Payment {
        uuid id PK
        uuid organization_id FK
        uuid contract_id FK
        uuid invoice_id FK
        enum payment_type "income/expense"
        decimal amount
        date payment_date
        enum method "bank_transfer/direct_debit/cash/credit_card/other"
        string payer_name
        string bank_name
        string bank_branch
        string account_number
        enum status "pending/completed/partial/overpaid/refunded"
        enum reconciliation_status "unmatched/auto_matched/manual_matched/confirmed"
        uuid matched_by FK
        text notes
        timestamp created_at
        timestamp updated_at
    }

    Invoice {
        uuid id PK
        uuid organization_id FK
        uuid contract_id FK
        uuid tenant_id FK
        string invoice_number
        date billing_date
        date due_date
        decimal total_amount
        decimal tax_amount
        decimal paid_amount
        enum status "draft/issued/sent/partial_paid/paid/overdue/cancelled"
        date sent_at
        enum send_method "email/mail/portal"
        text notes
        timestamp created_at
        timestamp updated_at
    }

    MaintenanceTicket {
        uuid id PK
        uuid organization_id FK
        uuid unit_id FK
        uuid tenant_id FK
        uuid assigned_to FK
        uuid vendor_id FK
        string ticket_number
        string title
        text description
        enum category "equipment/noise/leak/pest/common_area/other"
        enum priority "low/medium/high/urgent"
        enum status "received/in_progress/waiting_estimate/waiting_approval/ordered/completed/closed"
        enum cost_bearer "owner/tenant/management_company"
        decimal estimated_cost
        decimal actual_cost
        date scheduled_date
        date completed_date
        text resolution
        timestamp created_at
        timestamp updated_at
    }

    User {
        uuid id PK
        uuid organization_id FK
        uuid role_id FK
        string email
        string password_hash
        string first_name
        string last_name
        string phone
        boolean is_active
        boolean totp_enabled
        string totp_secret
        int failed_login_count
        timestamp locked_until
        timestamp last_login_at
        timestamp password_changed_at
        timestamp created_at
        timestamp updated_at
    }

3.3 テーブル定義詳細

3.3.1 Organization（テナント/組織）

PropCloudのマルチテナント基盤の中核テーブル。各販売パートナーおよび管理会社を表す。

**インデックス**:

3.3.2 CustomDomain（カスタムドメイン）

**インデックス**:

3.3.3 Building（建物）

**インデックス**:

**JSONBスキーマ（shared_facilities）**:

[
  { "name": "オートロック", "available": true },
  { "name": "宅配ボックス", "available": true },
  { "name": "インターネット", "available": true, "type": "光回線" }
]

**JSONBスキーマ（nearest_stations）**:

[
  {
    "line": "JR山手線",
    "station": "渋谷",
    "walk_minutes": 5,
    "bus_minutes": null
  }
]

3.3.4 Unit（区画/部屋）

**インデックス**:

3.3.5 Contract（契約）

**インデックス**:

3.3.6 Owner（オーナー）

**インデックス**:

3.3.7 Tenant（入居者）

**インデックス**:

3.3.8 Invoice（請求）

**インデックス**:

3.3.9 InvoiceItem（請求明細）

**インデックス**:

3.3.10 Payment（入出金）

**インデックス**:

3.3.11 MaintenanceTicket（修繕チケット）

**インデックス**:

3.3.12 Remittance（オーナー送金）

**インデックス**:

3.3.13 User（ユーザー）

**インデックス**:

3.3.14 Role（ロール）

3.3.15 AuditLog（監査ログ）

**インデックス**:

**パーティショニング**: created_at による月次パーティション

3.3.16 その他テーブル一覧

3.4 データベース設計方針

3.4.1 命名規則

3.4.2 共通カラム

全テーブルに以下のカラムを含む:

3.4.3 ソフトデリート

削除操作はソフトデリートを基本とする。以下のカラムを追加:

RLSポリシーに `deleted_at IS NULL` 条件を追加し、論理削除されたレコードを自動的に除外する。

3.4.4 暗号化対象カラム

以下の個人情報カラムはアプリケーションレベルで暗号化して保存する（AES-256、AWS KMS）:

4. API設計

4.1 API設計方針

4.1.1 通信プロトコル

4.1.2 共通レスポンス構造

// 一覧レスポンス
interface ListResponse<T> {
  items: T[];
  nextCursor: string | null;
  totalCount: number;
}

// エラーレスポンス
interface ErrorResponse {
  code: string;
  message: string;
  details?: Record<string, string[]>;
}

4.2 物件管理API

4.2.1 建物API

**building.list パラメータ**:

**building.create リクエスト**:

4.2.2 区画API

**unit.list パラメータ**:

4.2.3 駐車場API

4.3 契約管理API

4.3.1 契約API

**contract.create リクエスト**:

**contract.terminate リクエスト**:

4.4 入出金管理API

4.4.1 請求API

4.4.2 入金API

4.4.3 督促API

4.4.4 オーナー送金API

4.5 オーナー管理API

4.6 入居者管理API

4.7 修繕管理API

4.8 帳票・ドキュメントAPI

**document.generate リクエスト**:

4.9 ユーザー管理API

4.10 テナント管理API（プラットフォーム管理者向け）

4.11 ダッシュボード・レポートAPI

4.12 ポータルAPI

4.12.1 オーナーポータルAPI

4.12.2 入居者ポータルAPI

4.13 認証API（REST）

4.14 Webhook API（REST）

4.15 外部連携用REST API

5. 画面設計

5.1 画面一覧

graph LR
    subgraph "認証"
        Login["ログイン"]
        ForgotPW["パスワードリセット"]
        TOTP["二段階認証"]
    end

    subgraph "管理画面"
        Dashboard["ダッシュボード"]
        subgraph "物件管理"
            BuildingList["建物一覧"]
            BuildingDetail["建物詳細"]
            UnitList["区画一覧"]
            UnitDetail["区画詳細"]
        end
        subgraph "契約管理"
            ContractList["契約一覧"]
            ContractDetail["契約詳細"]
            ContractCreate["新規契約"]
            ContractQuick["簡易契約登録"]
            RenewalList["更新対象一覧"]
            TerminationCreate["解約処理"]
        end
        subgraph "入出金管理"
            InvoiceList["請求一覧"]
            InvoiceDetail["請求詳細"]
            PaymentList["入金一覧"]
            Reconciliation["消込処理"]
            DunningList["督促管理"]
            RemittanceList["オーナー送金"]
            RemittanceDetail["送金詳細"]
        end
        subgraph "オーナー管理"
            OwnerList["オーナー一覧"]
            OwnerDetail["オーナー詳細"]
        end
        subgraph "入居者管理"
            TenantList["入居者一覧"]
            TenantDetail["入居者詳細"]
        end
        subgraph "修繕管理"
            TicketList["チケット一覧"]
            TicketDetail["チケット詳細"]
            TicketCreate["チケット作成"]
            VendorList["業者一覧"]
            KeyManagement["鍵管理"]
        end
        subgraph "帳票・ドキュメント"
            TemplateList["テンプレート一覧"]
            DocumentList["ドキュメント一覧"]
            FileManager["ファイル管理"]
        end
        subgraph "レポート"
            ManagementReport["経営レポート"]
            VacancyReport["空室分析"]
            DelinquencyReport["滞納分析"]
        end
        subgraph "設定"
            OrgSettings["組織設定"]
            BrandingSettings["ブランディング"]
            UserManagement["ユーザー管理"]
            RoleManagement["ロール管理"]
            AuditLogView["監査ログ"]
        end
    end

    subgraph "ポータル"
        OwnerPortalDash["オーナーダッシュボード"]
        OwnerPortalProperty["物件状況"]
        OwnerPortalReport["収支確認"]
        ResidentPortalDash["入居者ダッシュボード"]
        ResidentPortalContract["契約確認"]
        ResidentPortalMaintenance["修繕申請"]
    end

    subgraph "プラットフォーム管理"
        PlatformDash["PF ダッシュボード"]
        TenantManagement["テナント管理"]
        PlanManagement["プラン管理"]
        SystemSettings["システム設定"]
    end

5.2 ダッシュボード画面

概要

ログイン後の最初の画面。管理会社の業務状況を一目で把握できる。

画面要素

操作

ワイヤーフレーム

┌──────────────────────────────────────────────────────────────────┐
│ ダッシュボード                                     [期間: 今月 ▾] │
├──────────────┬──────────────┬──────────────┬──────────────────────┤
│ 📊 管理戸数    │ 💰 入金状況    │ ⚠️ 滞納      │ 🔧 未対応チケット    │
│ 450戸         │ 入金率 92%    │ 12件         │ 8件                │
│ 稼働率 96%    │ 未入金 ¥1.2M  │ ¥850K        │                    │
├──────────────┴──────────────┼──────────────┴──────────────────────┤
│                              │                                    │
│  月間収支推移チャート          │  更新期限アラート                     │
│  [折れ線グラフ]                │  ├ ○○マンション 201  2026/05/31      │
│                              │  ├ △△ハイツ 302    2026/06/15      │
│                              │  └ ...                             │
│                              │                                    │
├──────────────────────────────┼────────────────────────────────────┤
│                              │                                    │
│  稼働率推移チャート            │  解約予定・退去予定                    │
│  [棒グラフ]                   │  ├ □□マンション 102  2026/04/30      │
│                              │  └ ...                             │
└──────────────────────────────┴────────────────────────────────────┘

5.3 物件一覧画面

概要

管理している全建物の一覧。検索・フィルタ・ソートで効率的に物件を探せる。

画面要素

操作

5.4 建物詳細画面

概要

1つの建物に関する全情報をタブ切替で表示。

タブ構成

操作

5.5 契約一覧画面

概要

全契約の一覧表示。ステータスによる絞り込みが可能。

画面要素

ワイヤーフレーム

┌──────────────────────────────────────────────────────────────────┐
│ 契約管理                                   [+ 新規契約] [簡易登録] │
├──────────────────────────────────────────────────────────────────┤
│ [全て(245)] [契約中(220)] [更新予定(15)] [解約予定(5)] [下書き(5)] │
├──────────────────────────────────────────────────────────────────┤
│ 🔍 契約番号・入居者名・物件名で検索          [フィルタ ▾] [ソート ▾] │
├──────────────────────────────────────────────────────────────────┤
│ □ │ 契約番号    │ 物件名           │ 部屋  │ 入居者    │ 期間       │ 賃料    │ 状態   │
│ ──┼────────────┼─────────────────┼──────┼──────────┼──────────┼────────┼───────│
│ □ │ C-2026-001 │ ○○マンション      │ 101  │ 山田太郎  │ 26/04-28/03 │ ¥85,000│ ● 契約中│
│ □ │ C-2026-002 │ △△ハイツ         │ 202  │ 佐藤花子  │ 26/01-27/12 │ ¥72,000│ ● 契約中│
│ □ │ C-2025-150 │ □□レジデンス      │ 305  │ 鈴木一郎  │ 25/06-27/05 │ ¥95,000│ ○ 更新予定│
├──────────────────────────────────────────────────────────────────┤
│                                              ◀ 1 2 3 ... 10 ▶   │
└──────────────────────────────────────────────────────────────────┘

5.6 契約詳細画面

タブ構成

操作

5.7 新規契約登録画面

概要

ステップ形式の契約登録フォーム。

ステップ

5.8 消込処理画面

概要

入金データと請求データのマッチング画面。

画面要素

ワイヤーフレーム

┌──────────────────────────────────────────────────────────────────┐
│ 消込処理                               [自動消込実行] [全銀取込]   │
├──────────────────────────────┬───────────────────────────────────┤
│ 未消込入金 (35件)              │ 未入金請求 (42件)                  │
│ ─────────────────────────── │ ───────────────────────────────── │
│ 🔍 入金者名で検索              │ 🔍 入居者名で検索                   │
│                              │                                    │
│ ■ 2026/03/15 ¥85,000       │  ¥85,000  山田太郎 ○○マンション 101 │
│   ヤマダ タロウ               │  ¥72,000  佐藤花子 △△ハイツ 202   │
│   ○○銀行 △△支店             │  ¥95,000  鈴木一郎 □□レジ 305     │
│   → 候補: 山田太郎 ¥85,000   │                                    │
│                              │                                    │
│ □ 2026/03/15 ¥70,000       │  ¥72,000  田中次郎 ○○マンション 202 │
│   サトウ ハナコ               │                                    │
│   △△銀行 □□支店             │                                    │
│   → 候補: 佐藤花子 ¥72,000   │                                    │
│   ⚠️ 差額 ¥2,000             │                                    │
├──────────────────────────────┴───────────────────────────────────┤
│ 消込結果: 自動マッチ 28件 / 手動要 7件 / 過不足 3件               │
└──────────────────────────────────────────────────────────────────┘

5.9 オーナー送金画面

概要

月次のオーナー送金データの確認・確定・振込データ出力画面。

画面要素

5.10 修繕管理画面（チケット一覧）

概要

クレーム・修繕チケットのカンバン表示。

表示モード

カンバン表示

┌──────────────────────────────────────────────────────────────────┐
│ 修繕管理                       [+ 新規] [カンバン ● | テーブル ○] │
├───────────────┬───────────────┬───────────────┬──────────────────┤
│ 受付 (5)       │ 対応中 (8)     │ 見積待ち (3)   │ 完了 (12)        │
│ ┌───────────┐ │ ┌───────────┐ │ ┌───────────┐ │ ┌──────────────┐ │
│ │ #MT-0045  │ │ │ #MT-0042  │ │ │ #MT-0038  │ │ │ #MT-0035     │ │
│ │ エアコン故障│ │ │ 水漏れ修理  │ │ │ 外壁塗装   │ │ │ 給湯器交換    │ │
│ │ ○○201     │ │ │ △△302     │ │ │ □□全体    │ │ │ ◇◇105       │ │
│ │ 🔴 高       │ │ │ 🔴 緊急     │ │ │ 🟡 中      │ │ │ ✅ 2026/03/10│ │
│ └───────────┘ │ └───────────┘ │ └───────────┘ │ └──────────────┘ │
│ ┌───────────┐ │ ┌───────────┐ │               │                  │
│ │ #MT-0044  │ │ │ #MT-0041  │ │               │                  │
│ │ 騒音苦情   │ │ │ 鍵交換     │ │               │                  │
│ │ △△205     │ │ │ ○○302     │ │               │                  │
│ │ 🟡 中      │ │ │ 🟢 低      │ │               │                  │
│ └───────────┘ │ └───────────┘ │               │                  │
└───────────────┴───────────────┴───────────────┴──────────────────┘

5.11 帳票管理画面

概要

帳票テンプレートの管理と帳票生成。

画面要素

5.12 設定画面

5.12.1 組織設定

5.12.2 ブランディング設定

5.12.3 ユーザー管理

5.13 オーナーポータル画面

5.13.1 ダッシュボード

5.13.2 収支確認画面

5.14 入居者ポータル画面

5.14.1 ダッシュボード

5.14.2 修繕申請画面

6. ホワイトラベル設計

6.1 テーマシステム

6.1.1 CSS Variables構造

テナント別のカスタマイズはCSS Custom Properties（CSS Variables）で実現する。

/* デフォルトテーマ（globals.css） */
:root {
  /* Brand Colors - テナントカスタマイズ対象 */
  --color-primary: 222 47% 23%;        /* #1B2559 HSL */
  --color-primary-light: 229 54% 36%;  /* #2D3A8C HSL */
  --color-primary-foreground: 0 0% 100%;

  --color-accent: 217 91% 60%;         /* #3B82F6 HSL */
  --color-accent-foreground: 0 0% 100%;

  /* Semantic Colors - 固定 */
  --color-success: 160 84% 39%;        /* #10B981 */
  --color-warning: 38 92% 50%;         /* #F59E0B */
  --color-danger: 0 84% 60%;           /* #EF4444 */

  /* Surface Colors - 固定 */
  --color-background: 0 0% 100%;
  --color-surface: 210 40% 96%;
  --color-border: 214 32% 91%;

  /* Text Colors - 固定 */
  --color-text-primary: 215 25% 17%;
  --color-text-secondary: 215 16% 47%;

  /* Typography */
  --font-sans: 'Noto Sans JP', sans-serif;
  --font-mono: 'JetBrains Mono', monospace;

  /* Spacing */
  --spacing-unit: 8px;

  /* Border Radius */
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;

  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.07);
  --shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
}

/* ダークモード準備（Phase 2以降） */
.dark {
  --color-background: 222 47% 11%;
  --color-surface: 222 47% 15%;
  --color-border: 222 47% 25%;
  --color-text-primary: 0 0% 93%;
  --color-text-secondary: 0 0% 63%;
}

6.1.2 テナントテーマ適用フロー

sequenceDiagram
    participant Browser as ブラウザ
    participant MW as Middleware
    participant DB as DB
    participant Cache as Redis

    Browser->>MW: ページリクエスト
    MW->>Cache: テナントテーマ取得
    alt キャッシュヒット
        Cache-->>MW: テーマデータ
    else キャッシュミス
        MW->>DB: organization.theme_config 取得
        DB-->>MW: テーマデータ
        MW->>Cache: キャッシュ保存（TTL: 1h）
    end
    MW->>Browser: HTML + インラインCSS Variables
    Note over Browser: CSS Variables上書きでテーマ適用

6.1.3 テーマデータ構造

interface TenantTheme {
  colors: {
    primary: string;       // HSL値 "222 47% 23%"
    primaryLight: string;  // HSL値
    accent: string;        // HSL値
  };
  logo: {
    url: string;           // S3 URL
    width: number;         // ロゴ幅（px）
    height: number;        // ロゴ高さ（px）
  };
  favicon: {
    url: string;           // S3 URL
  };
  companyName: string;     // 社名表示
}

6.1.4 コントラスト自動計算

テナントがプライマリカラーを変更した際、前景色（テキスト色）のコントラスト比を自動計算し、WCAG AA基準（4.5:1以上）を満たすように白/黒を自動選択する。

function getContrastForeground(bgHsl: string): string {
  const luminance = calculateRelativeLuminance(hslToRgb(bgHsl));
  // WCAG AA基準: コントラスト比 4.5:1 以上
  return luminance > 0.179 ? '0 0% 0%' : '0 0% 100%';
}

6.2 カスタムドメイン設計

6.2.1 ドメイン解決フロー

graph TB
    subgraph "テナントA"
        DomainA["kanri.tenant-a.co.jp"]
    end

    subgraph "テナントB"
        DomainB["system.tenant-b.co.jp"]
    end

    subgraph "デフォルト"
        SubdomainC["tenant-c.propcloud.jp"]
    end

    subgraph "DNS"
        CNAME_A["CNAME → app.propcloud.jp"]
        CNAME_B["CNAME → app.propcloud.jp"]
        R53["Route 53<br/>*.propcloud.jp"]
    end

    subgraph "CloudFront"
        CF["CloudFront<br/>Distribution"]
        ACM_WC["ACM<br/>*.propcloud.jp"]
        ACM_A["ACM<br/>kanri.tenant-a.co.jp"]
        ACM_B["ACM<br/>system.tenant-b.co.jp"]
    end

    subgraph "ALB"
        ALBNode["ALB"]
    end

    subgraph "App"
        AppNode["Next.js<br/>テナント解決 Middleware"]
    end

    DomainA --> CNAME_A --> CF
    DomainB --> CNAME_B --> CF
    SubdomainC --> R53 --> CF
    CF --> ALBNode --> AppNode
    ACM_WC --> CF
    ACM_A --> CF
    ACM_B --> CF

6.2.2 カスタムドメイン設定手順

1. テナント管理者がカスタムドメインを管理画面で登録

2. システムがDNS検証用のCNAMEレコードを発行

3. テナントが自社DNSにCNAMEレコードを追加

4. システムがDNS検証を実行（polling、最大48時間）

5. 検証成功後、ACMで証明書を発行

6. CloudFrontのAlternate Domain Namesに追加

7. custom_domains テーブルの ssl_status を active に更新

6.2.3 テナント解決優先順位

1. カスタムドメイン → custom_domains.domain で organization_id 特定
2. サブドメイン → {slug}.propcloud.jp から organizations.slug で特定
3. X-Tenant-ID ヘッダー → API直接呼び出し時
4. デフォルト → 404 または ログインページ

6.3 帳票テンプレート管理

6.3.1 テンプレートカスタマイズ構造

interface DocumentTemplate {
  id: string;
  organizationId: string;
  name: string;                    // テンプレート名
  category: TemplateCategory;      // カテゴリ
  baseTemplateId: string | null;   // ベーステンプレートID（システム標準）
  version: number;                 // バージョン番号

  // カスタマイズ可能な項目
  customization: {
    header: {
      logoPosition: 'left' | 'center' | 'right';
      showCompanyName: boolean;
      showCompanyAddress: boolean;
      showCompanyPhone: boolean;
      customText: string | null;
    };
    footer: {
      showPageNumber: boolean;
      customText: string | null;
    };
    body: {
      fontSize: number;           // ポイント
      fontFamily: string;
      margins: {                  // mm
        top: number;
        right: number;
        bottom: number;
        left: number;
      };
    };
  };

  // テンプレート本体（React PDFコンポーネントのJSON定義）
  templateData: object;
}

type TemplateCategory =
  | 'contract'          // 契約書類
  | 'invoice'           // 請求書類
  | 'receipt'           // 領収書
  | 'dunning'           // 督促状
  | 'report'            // 報告書
  | 'settlement'        // 精算書
  | 'maintenance'       // 修繕書類
  | 'notification'      // 通知書
  | 'tax'               // 税務書類
  | 'other';            // その他

6.3.2 テンプレート継承モデル

システム標準テンプレート（180種）
    │
    ├── テナントA カスタムテンプレート
    │   └── ロゴ・社名・フッター差し替え
    │
    ├── テナントB カスタムテンプレート
    │   └── ロゴ・社名・追加条項差し替え
    │
    └── テナントC（カスタマイズなし）
        └── システム標準をそのまま使用

法改正等でシステム標準テンプレートが更新された場合:

6.4 機能ON/OFF設計

6.4.1 フィーチャーフラグ構造

interface FeatureFlags {
  // モジュール単位
  modules: {
    ownerPortal: boolean;        // オーナーポータル
    residentPortal: boolean;     // 入居者ポータル
    eContract: boolean;          // 電子契約連携
    aiReconciliation: boolean;   // AI消込アシスト
    maintenanceManagement: boolean; // 修繕管理
    dunningManagement: boolean;  // 督促管理
    accountingIntegration: boolean; // 会計ソフト連携
    reportAnalysis: boolean;     // 分析レポート
  };

  // 詳細機能単位
  features: {
    bulkInvoiceGeneration: boolean;  // 一括請求生成
    zenginImport: boolean;           // 全銀データ取込
    zenginExport: boolean;           // 全銀データ出力
    customDomain: boolean;           // カスタムドメイン
    smsNotification: boolean;        // SMS通知
    commandPalette: boolean;         // コマンドパレット
  };
}

6.4.2 フィーチャーフラグの適用

// サーバーサイド: tRPCルーターでの権限チェック
const maintenanceRouter = router({
  create: protectedProcedure
    .use(requireFeature('modules.maintenanceManagement'))
    .input(maintenanceCreateSchema)
    .mutation(async ({ ctx, input }) => {
      // ...
    }),
});

// クライアントサイド: コンポーネントの表示制御
function Sidebar() {
  const { features } = useTenantFeatures();

  return (
    <nav>
      <SidebarItem href="/buildings" icon={Building2} label="物件管理" />
      <SidebarItem href="/contracts" icon={FileText} label="契約管理" />
      {features.modules.maintenanceManagement && (
        <SidebarItem href="/maintenance" icon={Wrench} label="修繕管理" />
      )}
      {features.modules.ownerPortal && (
        <SidebarItem href="/owners" icon={Users} label="オーナー管理" />
      )}
    </nav>
  );
}

6.5 用語カスタマイズ設計

interface TerminologyOverrides {
  [key: string]: string;
}

// デフォルト用語 → カスタマイズ例
const defaultTerminology = {
  'building': '物件',
  'unit': '部屋',
  'tenant': '入居者',
  'owner': 'オーナー',
  'contract': '契約',
  'invoice': '請求',
  'maintenance': '修繕',
  'remittance': '送金',
};

// テナントA のカスタマイズ
const tenantAOverrides = {
  'building': '管理物件',
  'unit': '区画',
  'tenant': '借主',
};

用語変換はi18nフレームワーク（next-intl）の辞書をテナント別にオーバーライドして実現する。

7. 認証・認可設計

7.1 認証フロー

7.1.1 ログインフロー

sequenceDiagram
    participant User as ユーザー
    participant App as Next.js App
    participant Auth as Auth Service
    participant DB as PostgreSQL
    participant Redis as Redis

    User->>App: メール + パスワード入力
    App->>Auth: POST /api/auth/login

    Auth->>DB: ユーザー検索（email）
    DB-->>Auth: ユーザーデータ

    alt アカウントロック中
        Auth-->>App: 401 "アカウントがロックされています"
        App-->>User: エラー表示
    end

    Auth->>Auth: パスワード検証（bcrypt.compare）

    alt パスワード不一致
        Auth->>DB: failed_login_count + 1
        alt 10回連続失敗
            Auth->>DB: locked_until = now() + 30min
        end
        Auth-->>App: 401 "認証に失敗しました"
        App-->>User: エラー表示
    end

    alt TOTP有効
        Auth-->>App: 200 { requireTotp: true, tempToken }
        App-->>User: TOTP入力画面表示
        User->>App: TOTPコード入力
        App->>Auth: POST /api/auth/verify-totp
        Auth->>Auth: TOTPコード検証
        alt TOTP不一致
            Auth-->>App: 401 "認証コードが無効です"
        end
    end

    Auth->>DB: failed_login_count = 0, last_login_at = now()
    Auth->>Redis: セッション保存（TTL: 24h）
    Auth->>DB: AuditLog記録（login）
    Auth-->>App: 200 { accessToken, refreshToken }
    App->>App: Cookie にトークン保存（httpOnly, secure）
    App-->>User: ダッシュボードへリダイレクト

7.1.2 トークン設計

**Access Token（JWT）ペイロード**:

interface JwtPayload {
  sub: string;           // ユーザーID
  org: string;           // 組織ID（テナントID）
  role: string;          // ロールスラグ
  permissions: string[]; // 権限リスト
  iat: number;           // 発行日時
  exp: number;           // 有効期限
}

7.1.3 パスワードポリシー

7.2 RBAC設計

7.2.1 システムロール定義

graph TB
    PlatformAdmin["プラットフォーム管理者<br/>platform_admin"]
    TenantAdmin["テナント管理者<br/>tenant_admin"]
    CompanyAdmin["管理会社管理者<br/>company_admin"]
    CompanyStaff["管理会社スタッフ<br/>company_staff"]
    OwnerRole["オーナー<br/>owner"]
    ResidentRole["入居者<br/>resident"]

    PlatformAdmin -->|"全テナント管理"| TenantAdmin
    TenantAdmin -->|"テナント内管理"| CompanyAdmin
    CompanyAdmin -->|"業務管理"| CompanyStaff
    CompanyAdmin -.->|"ポータル招待"| OwnerRole
    CompanyAdmin -.->|"ポータル招待"| ResidentRole

7.2.2 権限マトリクス

**凡例**: R = Read、W = Write（Create/Update/Delete）、(own) = テナント内のみ

7.2.3 権限チェック実装

// 権限定義
const PERMISSIONS = {
  'building:read': 'building:read',
  'building:create': 'building:create',
  'building:update': 'building:update',
  'building:delete': 'building:delete',
  // ...
} as const;

// tRPC Middleware での権限チェック
const requirePermission = (permission: string) => {
  return middleware(async ({ ctx, next }) => {
    if (!ctx.user) {
      throw new TRPCError({ code: 'UNAUTHORIZED' });
    }

    const hasPermission = ctx.user.permissions.includes(permission);
    if (!hasPermission) {
      throw new TRPCError({
        code: 'FORBIDDEN',
        message: `Permission denied: ${permission}`,
      });
    }

    // 監査ログ記録
    await ctx.auditLog.record({
      action: permission,
      userId: ctx.user.id,
      organizationId: ctx.tenant.id,
    });

    return next();
  });
};

7.3 テナント分離における認証

7.3.1 セッションとテナントの紐付け

interface Session {
  userId: string;
  organizationId: string;  // テナントID
  roleSlug: string;
  permissions: string[];
  expiresAt: number;
}

// Middleware でのテナント検証
async function validateTenantAccess(
  session: Session,
  requestTenantId: string
): boolean {
  // プラットフォーム管理者は全テナントアクセス可
  if (session.roleSlug === 'platform_admin') {
    return true;
  }

  // 通常ユーザーは自テナントのみ
  return session.organizationId === requestTenantId;
}

7.3.2 クロステナントアクセス防止

1. **RLSポリシー**: DB層での物理的なデータ分離

2. **Middleware検証**: リクエストのテナントIDとセッションのテナントIDの一致確認

3. **API層バリデーション**: リソースの organization_id とセッションの organization_id の一致確認

4. **フロントエンドルーティング**: テナント固有URLの強制

7.4 監査ログ設計

7.4.1 記録対象アクション

7.4.2 ログ構造

interface AuditLogEntry {
  id: string;
  organizationId: string;
  userId: string;
  action: string;
  resourceType: string;
  resourceId: string | null;
  changes: {
    before: Record<string, unknown> | null;
    after: Record<string, unknown> | null;
  } | null;
  metadata: {
    ipAddress: string;
    userAgent: string;
    requestId: string;
  };
  createdAt: Date;
}

8. 外部連携設計

8.1 電子契約連携

8.1.1 連携対象サービス

8.1.2 連携フロー

sequenceDiagram
    participant Staff as 管理スタッフ
    participant App as PropCloud
    participant ESign as 電子契約サービス
    participant Signer as 契約者

    Staff->>App: 契約書PDF生成
    App->>App: 契約データから帳票生成
    Staff->>App: 電子契約送信リクエスト
    App->>ESign: API: 契約書PDF + 署名箇所設定
    ESign-->>App: 契約ID返却
    App->>App: 契約ステータス: 電子署名待ち

    ESign->>Signer: 署名依頼メール送信
    Signer->>ESign: 電子署名実行
    ESign->>App: Webhook: 署名完了通知
    App->>ESign: API: 署名済みPDF取得
    App->>App: S3に保存 + 契約ステータス更新
    App->>Staff: 署名完了通知

8.1.3 データマッピング

8.2 全銀フォーマット連携

8.2.1 対応フォーマット

8.2.2 口座振替データ出力仕様

[ヘッダレコード]
データ区分(1): 1
種別コード(2): 91
コード区分(1): 0
委託者コード(10): テナント設定値
委託者名(40): テナント設定値
引落日(4): MMDD
取引銀行番号(4): テナント設定値
取引銀行名(15): テナント設定値
取引支店番号(3): テナント設定値
取引支店名(15): テナント設定値
口座種別(1): テナント設定値
口座番号(7): テナント設定値

[データレコード] ※契約ごとに1レコード
データ区分(1): 2
引落銀行番号(4): 契約者の銀行番号
引落銀行名(15): 契約者の銀行名
引落支店番号(3): 契約者の支店番号
引落支店名(15): 契約者の支店名
口座種別(1): 契約者の口座種別
口座番号(7): 契約者の口座番号
口座名義(30): 契約者名（半角カナ）
引落金額(10): 請求金額
新規コード(1): 0=通常 1=新規 2=変更 4=削除
顧客番号(20): 契約番号
振替結果(1): スペース（結果取込時に使用）

[トレーラレコード]
データ区分(1): 8
合計件数(6): データレコード件数
合計金額(12): 引落金額合計

[エンドレコード]
データ区分(1): 9

8.2.3 入金データ取込処理

graph TB
    Upload["全銀ファイル<br/>アップロード"]
    Parse["ファイル<br/>パース処理"]
    Validate["データ<br/>バリデーション"]
    Import["入金データ<br/>一括登録"]
    AutoMatch["自動消込<br/>実行"]
    Review["消込結果<br/>レビュー"]
    Confirm["確定処理"]

    Upload --> Parse
    Parse --> Validate
    Validate -->|"OK"| Import
    Validate -->|"エラー"| ErrorReport["エラーレポート"]
    Import --> AutoMatch
    AutoMatch --> Review
    Review --> Confirm

    subgraph "自動マッチングロジック"
        M1["完全一致<br/>(口座番号 + 金額)"]
        M2["部分一致<br/>(名義揺れ補正 + 金額)"]
        M3["候補提示<br/>(金額のみ一致)"]
    end

    AutoMatch --> M1
    AutoMatch --> M2
    AutoMatch --> M3

8.3 会計ソフト連携

8.3.1 対応サービス

8.3.2 仕訳データマッピング

8.3.3 仕訳データ構造

interface JournalEntry {
  id: string;
  organizationId: string;
  transactionDate: Date;       // 取引日
  description: string;          // 摘要
  entries: JournalEntryLine[];  // 仕訳行
  sourceType: string;           // 元データ種別（invoice, payment, remittance等）
  sourceId: string;             // 元データID
  status: 'pending' | 'synced' | 'error';
  syncedAt: Date | null;
  errorMessage: string | null;
}

interface JournalEntryLine {
  accountCode: string;          // 勘定科目コード
  accountName: string;          // 勘定科目名
  subAccountCode: string | null; // 補助科目コード
  subAccountName: string | null; // 補助科目名
  debitAmount: number;          // 借方金額
  creditAmount: number;         // 貸方金額
  taxType: string;              // 税区分
  taxAmount: number;            // 消費税額
}

8.4 通知連携

8.4.1 メール送信

8.4.2 通知テンプレート一覧

8.4.3 SMS送信（オプション）

8.4.4 Slack/Teams連携

9. バッチ処理設計

9.1 バッチ処理一覧

graph LR
    subgraph "月初バッチ"
        B1["月次請求<br/>データ生成"]
        B2["口座振替<br/>データ作成"]
    end

    subgraph "日次バッチ"
        B3["入金データ<br/>取込・消込"]
        B4["滞納検出"]
        B5["更新期限<br/>アラート"]
        B6["鍵貸出<br/>期限アラート"]
    end

    subgraph "月末バッチ"
        B7["オーナー送金<br/>データ生成"]
        B8["送金明細書<br/>生成"]
        B9["仕訳データ<br/>生成"]
    end

    subgraph "年次バッチ"
        B10["支払調書<br/>データ生成"]
        B11["年間収支<br/>レポート生成"]
    end

    subgraph "随時バッチ"
        B12["督促データ<br/>一括生成"]
        B13["帳票一括<br/>PDF生成"]
        B14["CSV一括<br/>エクスポート"]
    end

    B1 --> B2
    B3 --> B4
    B7 --> B8
    B8 --> B9

9.2 月次請求データ生成

9.2.1 処理概要

9.2.2 処理フロー

graph TB
    Start["バッチ開始"]
    FetchContracts["対象契約取得<br/>(status=active)"]
    Loop["契約ごとにループ"]

    subgraph "契約ごとの処理"
        CalcRent["家賃・管理費・共益費計算"]
        CalcParking["駐車場料金計算"]
        CalcVariable["変動費按分計算<br/>(電気・水道等)"]
        CalcTax["消費税計算<br/>(課税/非課税判定)"]
        CreateInvoice["請求データ作成<br/>(Invoice + InvoiceItem)"]
        CheckDuplicate["重複チェック<br/>(同月の既存請求確認)"]
    end

    GenerateNumber["請求番号採番"]
    SaveDB["DB保存"]
    Notify["完了通知"]
    End["バッチ終了"]

    Start --> FetchContracts
    FetchContracts --> Loop
    Loop --> CheckDuplicate
    CheckDuplicate -->|"重複なし"| CalcRent
    CheckDuplicate -->|"重複あり"| Skip["スキップ"]
    CalcRent --> CalcParking
    CalcParking --> CalcVariable
    CalcVariable --> CalcTax
    CalcTax --> GenerateNumber
    GenerateNumber --> CreateInvoice
    CreateInvoice --> SaveDB
    SaveDB --> Loop
    Loop -->|"全契約処理完了"| Notify
    Notify --> End

9.2.3 請求金額計算ロジック

interface MonthlyBillingCalculation {
  contractId: string;
  billingMonth: Date;

  // 固定費
  rent: number;                    // 賃料
  managementFee: number;           // 管理費
  commonFee: number;               // 共益費
  parkingFee: number;              // 駐車場料金

  // 変動費
  variableFees: VariableFee[];     // 電気・水道等

  // 日割り計算（入居月・退去月）
  proRataAdjustment: number;       // 日割り調整額

  // 消費税
  taxableAmount: number;           // 課税対象額（駐車場等）
  taxExemptAmount: number;         // 非課税額（住居家賃）
  taxAmount: number;               // 消費税額

  // 合計
  totalAmount: number;
}

// 非課税判定: 住居用賃貸の家賃・管理費・共益費は非課税
// 課税対象: 駐車場料金、事業用賃貸、更新料等
function isTaxable(itemType: InvoiceItemType, contractType: string): boolean {
  if (contractType === 'residential') {
    return itemType === 'parking' || itemType === 'other';
  }
  return true; // 事業用は全て課税
}

9.3 消込処理

9.3.1 自動消込ロジック

graph TB
    ImportData["入金データ取込"]
    Phase1["Phase 1: 完全一致マッチング"]
    Phase2["Phase 2: 名義揺れ補正マッチング"]
    Phase3["Phase 3: 金額一致候補提示"]
    PhaseAI["Phase AI: AI消込アシスト<br/>(Phase 3オプション)"]
    Manual["手動消込画面"]

    ImportData --> Phase1

    Phase1 -->|"口座番号+金額<br/>完全一致"| AutoMatch1["自動消込<br/>(auto_matched)"]
    Phase1 -->|"不一致"| Phase2

    Phase2 -->|"名義揺れ補正<br/>+金額一致"| AutoMatch2["自動消込<br/>(auto_matched)"]
    Phase2 -->|"不一致"| Phase3

    Phase3 -->|"金額一致候補あり"| SuggestMatch["候補提示<br/>→手動確認"]
    Phase3 -->|"候補なし"| PhaseAI
    PhaseAI -->|"AI推論マッチ"| SuggestAI["AI候補提示<br/>→手動確認"]
    PhaseAI -->|"候補なし"| Manual

    SuggestMatch --> Manual
    SuggestAI --> Manual

9.3.2 名義揺れ補正ルール

9.3.3 過不足処理

9.4 オーナー送金データ生成

9.4.1 処理フロー

graph TB
    Start["バッチ開始"]
    FetchOwners["対象オーナー取得"]
    Loop["オーナーごとにループ"]

    subgraph "オーナーごとの処理"
        CalcIncome["賃料収入集計<br/>(当月入金確定分)"]
        CalcMgmtFee["管理手数料計算<br/>(収入 × 手数料率)"]
        CalcMaintenance["修繕費集計<br/>(オーナー負担分)"]
        CalcWithholding["源泉徴収計算<br/>(個人非居住者: 20.42%)"]
        CalcOther["その他控除計算"]
        CalcNet["送金額計算<br/>(収入 - 控除合計)"]
        CreateRemittance["送金データ作成"]
        CreateItems["送金明細作成"]
    end

    SaveDB["DB保存"]
    Notify["完了通知"]
    End["バッチ終了"]

    Start --> FetchOwners
    FetchOwners --> Loop
    Loop --> CalcIncome
    CalcIncome --> CalcMgmtFee
    CalcMgmtFee --> CalcMaintenance
    CalcMaintenance --> CalcWithholding
    CalcWithholding --> CalcOther
    CalcOther --> CalcNet
    CalcNet --> CreateRemittance
    CreateRemittance --> CreateItems
    CreateItems --> SaveDB
    SaveDB --> Loop
    Loop -->|"全オーナー完了"| Notify
    Notify --> End

9.4.2 送金額計算ロジック

送金額 = 総賃料収入
       - 管理手数料（収入 × 手数料率）
       - 修繕費（オーナー負担分）
       - 源泉徴収税（該当する場合）
       - その他控除（広告費等）

9.4.3 源泉徴収計算

9.5 督促データ生成

9.5.1 督促段階

9.5.2 自動督促フロー

日次バッチ（滞納検出）
    │
    ├── 未入金請求の検出（due_date < 今日）
    ├── 滞納日数の計算
    ├── 督促レベルの判定
    ├── 前回督促からの経過日数確認
    │    └── 最低7日間隔を空ける
    ├── 督促データ生成
    └── 通知（メール/SMS/ポータル）

9.6 バッチ基盤設計

9.6.1 ジョブキュー構成

// BullMQ ジョブキュー定義
const queues = {
  // 優先度高: 即時性が求められるジョブ
  'notification': new Queue('notification', { redis }),
  'document-generation': new Queue('document-generation', { redis }),

  // 優先度中: 定期バッチ
  'monthly-billing': new Queue('monthly-billing', { redis }),
  'reconciliation': new Queue('reconciliation', { redis }),
  'owner-remittance': new Queue('owner-remittance', { redis }),

  // 優先度低: レポート生成等
  'report-generation': new Queue('report-generation', { redis }),
  'data-export': new Queue('data-export', { redis }),
};

// ジョブオプション
const defaultJobOptions: JobOptions = {
  attempts: 3,                    // リトライ回数
  backoff: {
    type: 'exponential',         // 指数バックオフ
    delay: 5000,                 // 初回5秒
  },
  removeOnComplete: {
    count: 1000,                 // 完了ジョブ保持数
  },
  removeOnFail: {
    count: 5000,                 // 失敗ジョブ保持数
  },
};

9.6.2 スケジュール定義

9.6.3 テナント別バッチ実行

バッチ処理はテナント単位で実行し、テナント間の影響を分離する。

async function executeMonthlyBilling() {
  const organizations = await prisma.organization.findMany({
    where: { status: 'active' },
  });

  for (const org of organizations) {
    await monthlyBillingQueue.add(
      'generate',
      {
        organizationId: org.id,
        billingMonth: getNextBillingMonth(),
      },
      {
        ...defaultJobOptions,
        priority: getPriorityByPlan(org.planId),
      }
    );
  }
}

9.6.4 バッチ監視

10. 非機能要件への対応方針

10.1 パフォーマンス対応

10.1.1 フロントエンド最適化

10.1.2 バックエンド最適化

10.1.3 データベース最適化

10.2 セキュリティ対応

10.2.1 多層防御アーキテクチャ

graph TB
    subgraph "Layer 1: ネットワーク"
        WAF["AWS WAF<br/>(OWASP Top 10)"]
        SG["Security Groups"]
        VPC["VPC<br/>(Private Subnet)"]
    end

    subgraph "Layer 2: エッジ"
        CF_Shield["CloudFront + Shield<br/>(DDoS保護)"]
        RateLimit["レート制限<br/>(1,000 req/min/tenant)"]
    end

    subgraph "Layer 3: アプリケーション"
        CSP["Content-Security-Policy"]
        CSRF_Token["CSRFトークン"]
        InputSanitize["入力サニタイズ"]
        ParamBinding["パラメータバインディング"]
    end

    subgraph "Layer 4: データ"
        TLS["TLS 1.3"]
        KMS["AWS KMS<br/>(AES-256暗号化)"]
        RLS_Security["Row Level Security"]
        EncryptedCol["暗号化カラム<br/>(PII)"]
    end

    subgraph "Layer 5: 監査"
        AuditLog_Security["監査ログ<br/>(イミュータブル)"]
        AccessLog["アクセスログ"]
        SecurityAlert["セキュリティアラート"]
    end

    WAF --> CF_Shield
    CF_Shield --> RateLimit
    RateLimit --> CSP
    CSP --> TLS
    TLS --> AuditLog_Security

10.2.2 OWASP Top 10 対応

10.2.3 データ暗号化

10.3 スケーラビリティ対応

10.3.1 水平スケーリング設計

graph TB
    subgraph "Auto Scaling"
        ECS_ASG["ECS Service<br/>Auto Scaling<br/>Min: 2, Max: 20"]
        Worker_ASG["Worker Service<br/>Auto Scaling<br/>Min: 1, Max: 10"]
    end

    subgraph "スケーリングポリシー"
        CPU_Policy["CPU使用率 > 70%<br/>→ スケールアウト"]
        Memory_Policy["メモリ使用率 > 80%<br/>→ スケールアウト"]
        Request_Policy["リクエスト数 > 500/min<br/>→ スケールアウト"]
        Queue_Policy["キュー深度 > 100<br/>→ ワーカースケールアウト"]
    end

    CPU_Policy --> ECS_ASG
    Memory_Policy --> ECS_ASG
    Request_Policy --> ECS_ASG
    Queue_Policy --> Worker_ASG

10.3.2 スケーリング目標値

10.3.3 データベーススケーリング戦略

10.4 可用性対応

10.4.1 冗長化構成

10.4.2 バックアップ・リカバリ

10.4.3 障害対応フロー

graph TB
    Detect["障害検知<br/>(CloudWatch Alarm)"]
    Notify["通知<br/>(PagerDuty/Slack)"]
    AutoHeal["自動復旧<br/>(ECS/RDS フェイルオーバー)"]
    Manual["手動介入<br/>(オンコールエンジニア)"]
    RCA["根本原因分析"]
    Fix["恒久対策"]
    PostMortem["ポストモーテム"]

    Detect --> Notify
    Detect --> AutoHeal
    AutoHeal -->|"復旧OK"| RCA
    AutoHeal -->|"復旧NG"| Manual
    Manual --> RCA
    RCA --> Fix
    Fix --> PostMortem

10.5 運用監視対応

10.5.1 監視項目

10.5.2 ログ管理

10.5.3 デプロイ戦略

graph LR
    Dev["開発環境<br/>(feature branch)"]
    Staging["ステージング環境<br/>(main branch)"]
    Prod["本番環境<br/>(release tag)"]

    Dev -->|"PR マージ"| Staging
    Staging -->|"テスト通過<br/>+ 手動承認"| Prod

    subgraph "本番デプロイ"
        Blue["Blue (現行)"]
        Green["Green (新版)"]
        Switch["トラフィック<br/>切替"]
    end

    Prod --> Green
    Green -->|"ヘルスチェック OK"| Switch
    Switch -->|"100%"| Green
    Blue -->|"ロールバック可"| Switch

10.6 テスト戦略

付録

付録A: 料金体系

付録B: 用語集

付録C: 画面遷移図

graph TD
    Login["ログイン画面"]
    TOTP["二段階認証画面"]
    ForgotPW["パスワードリセット"]
    Dashboard["ダッシュボード"]

    Login --> TOTP
    Login --> ForgotPW
    TOTP --> Dashboard
    Login --> Dashboard

    subgraph "物件管理"
        BuildingList["建物一覧"]
        BuildingCreate["建物登録"]
        BuildingDetail["建物詳細"]
        BuildingEdit["建物編集"]
        UnitList["区画一覧"]
        UnitCreate["区画登録"]
        UnitDetail["区画詳細"]
        UnitEdit["区画編集"]
        ParkingList["駐車場一覧"]
    end

    Dashboard --> BuildingList
    BuildingList --> BuildingCreate
    BuildingList --> BuildingDetail
    BuildingDetail --> BuildingEdit
    BuildingDetail --> UnitList
    UnitList --> UnitCreate
    UnitList --> UnitDetail
    UnitDetail --> UnitEdit
    BuildingDetail --> ParkingList

    subgraph "契約管理"
        ContractList["契約一覧"]
        ContractCreate["新規契約"]
        ContractQuick["簡易契約登録"]
        ContractDetail["契約詳細"]
        ContractEdit["契約編集"]
        RenewalList["更新対象一覧"]
        RenewalCreate["更新契約作成"]
        TerminationCreate["解約処理"]
        SettlementPreview["精算書プレビュー"]
    end

    Dashboard --> ContractList
    ContractList --> ContractCreate
    ContractList --> ContractQuick
    ContractList --> ContractDetail
    ContractDetail --> ContractEdit
    ContractList --> RenewalList
    RenewalList --> RenewalCreate
    ContractDetail --> TerminationCreate
    TerminationCreate --> SettlementPreview

    subgraph "入出金管理"
        InvoiceList["請求一覧"]
        InvoiceDetail["請求詳細"]
        InvoiceCreate["請求手動作成"]
        PaymentList["入金一覧"]
        PaymentImport["全銀データ取込"]
        ReconciliationView["消込処理"]
        DunningList["督促管理"]
        DunningDetail["督促詳細"]
        RemittanceList["送金一覧"]
        RemittanceDetail["送金詳細"]
        RemittanceExport["全銀データ出力"]
    end

    Dashboard --> InvoiceList
    InvoiceList --> InvoiceDetail
    InvoiceList --> InvoiceCreate
    Dashboard --> PaymentList
    PaymentList --> PaymentImport
    PaymentList --> ReconciliationView
    Dashboard --> DunningList
    DunningList --> DunningDetail
    Dashboard --> RemittanceList
    RemittanceList --> RemittanceDetail
    RemittanceList --> RemittanceExport

    subgraph "オーナー管理"
        OwnerList["オーナー一覧"]
        OwnerCreate["オーナー登録"]
        OwnerDetail["オーナー詳細"]
        OwnerEdit["オーナー編集"]
        OwnerReport["オーナーレポート"]
    end

    Dashboard --> OwnerList
    OwnerList --> OwnerCreate
    OwnerList --> OwnerDetail
    OwnerDetail --> OwnerEdit
    OwnerDetail --> OwnerReport

    subgraph "入居者管理"
        TenantList["入居者一覧"]
        TenantCreate["入居者登録"]
        TenantDetail["入居者詳細"]
        TenantEdit["入居者編集"]
    end

    Dashboard --> TenantList
    TenantList --> TenantCreate
    TenantList --> TenantDetail
    TenantDetail --> TenantEdit

    subgraph "修繕管理"
        TicketKanban["チケットボード"]
        TicketTable["チケット一覧"]
        TicketCreate["チケット作成"]
        TicketDetail["チケット詳細"]
        EstimateCreate["見積登録"]
        VendorList["業者一覧"]
        VendorCreate["業者登録"]
        KeyMgmt["鍵管理"]
        InspectionList["定期点検一覧"]
    end

    Dashboard --> TicketKanban
    TicketKanban --> TicketTable
    TicketKanban --> TicketCreate
    TicketKanban --> TicketDetail
    TicketDetail --> EstimateCreate
    TicketKanban --> VendorList
    VendorList --> VendorCreate
    Dashboard --> KeyMgmt
    Dashboard --> InspectionList

    subgraph "帳票・ドキュメント"
        TemplateList["テンプレート一覧"]
        TemplateEdit["テンプレート編集"]
        DocList["生成済み帳票"]
        DocPreview["帳票プレビュー"]
        FileManager["ファイル管理"]
    end

    Dashboard --> TemplateList
    TemplateList --> TemplateEdit
    Dashboard --> DocList
    DocList --> DocPreview
    Dashboard --> FileManager

    subgraph "設定"
        OrgSettings["組織設定"]
        BrandSettings["ブランディング設定"]
        BrandPreview["テーマプレビュー"]
        UserMgmt["ユーザー管理"]
        UserInvite["ユーザー招待"]
        RoleMgmt["ロール管理"]
        RoleEdit["ロール編集"]
        AuditLog["監査ログ"]
        NotificationSettings["通知設定"]
        IntegrationSettings["外部連携設定"]
    end

    Dashboard --> OrgSettings
    OrgSettings --> BrandSettings
    BrandSettings --> BrandPreview
    OrgSettings --> UserMgmt
    UserMgmt --> UserInvite
    OrgSettings --> RoleMgmt
    RoleMgmt --> RoleEdit
    OrgSettings --> AuditLog
    OrgSettings --> NotificationSettings
    OrgSettings --> IntegrationSettings

付録D: 業務フロー詳細図

D.1 募集〜入居フロー

graph TD
    Start["開始"]
    RegisterBuilding["物件登録"]
    RegisterUnit["区画登録"]
    SetRecruitment["募集条件設定"]
    ChangeStatus["ステータス: 募集中"]
    ReceiveApplication["申込受付"]
    Screening["審査"]
    ScreeningResult{審査結果}
    Reject["不承認通知"]
    CreateContract["契約書作成"]
    CreateImportantDoc["重要事項説明書作成"]
    EContract{電子契約?}
    PaperSign["書面契約・署名"]
    ESign["電子契約送信"]
    ESignWait["署名待ち"]
    CalcInitialCost["初期費用計算"]
    CreateInvoice["初期費用請求"]
    ConfirmPayment["入金確認"]
    KeyHandover["鍵引渡"]
    MoveIn["入居処理"]
    StatusOccupied["ステータス: 入居中"]
    End["完了"]

    Start --> RegisterBuilding
    RegisterBuilding --> RegisterUnit
    RegisterUnit --> SetRecruitment
    SetRecruitment --> ChangeStatus
    ChangeStatus --> ReceiveApplication
    ReceiveApplication --> Screening
    Screening --> ScreeningResult
    ScreeningResult -->|"不承認"| Reject
    ScreeningResult -->|"承認"| CreateContract
    Reject --> End
    CreateContract --> CreateImportantDoc
    CreateImportantDoc --> EContract
    EContract -->|"Yes"| ESign
    EContract -->|"No"| PaperSign
    ESign --> ESignWait
    ESignWait --> CalcInitialCost
    PaperSign --> CalcInitialCost
    CalcInitialCost --> CreateInvoice
    CreateInvoice --> ConfirmPayment
    ConfirmPayment --> KeyHandover
    KeyHandover --> MoveIn
    MoveIn --> StatusOccupied
    StatusOccupied --> End

D.2 月次業務フロー

graph TD
    MonthStart["月初"]

    subgraph "請求処理（1日〜5日）"
        GenInvoice["月次請求データ<br/>自動生成"]
        ReviewInvoice["請求データ確認"]
        AdjustInvoice["変動費調整"]
        GenDirectDebit["口座振替データ<br/>生成"]
        SendDirectDebit["口座振替データ<br/>送信"]
        SendInvoice["請求書送付<br/>(メール/郵送)"]
    end

    subgraph "入金処理（15日〜20日）"
        ImportPayment["入金データ取込<br/>(全銀)"]
        AutoReconcile["自動消込実行"]
        ManualReconcile["手動消込<br/>(未マッチ分)"]
        ConfirmReconcile["消込確認"]
    end

    subgraph "滞納・督促（20日〜25日）"
        DetectDelinquency["滞納検出"]
        ClassifyDelinquency["滞納分類<br/>(日数別)"]
        GenDunning["督促データ生成"]
        SendDunning["督促状送付"]
        RecordDunning["督促履歴記録"]
    end

    subgraph "オーナー送金（25日〜月末）"
        CalcRemittance["送金額集計"]
        ReviewRemittance["送金データ確認"]
        ConfirmRemittance["送金データ確定"]
        GenZengin["全銀データ<br/>(総合振込)出力"]
        ExecuteTransfer["振込実行"]
        GenStatement["送金明細書生成"]
        SendStatement["明細書送付"]
    end

    subgraph "月次レポート（月末）"
        GenMonthlyReport["月次レポート生成"]
        GenOwnerReport["オーナー向け<br/>月次報告書生成"]
        GenJournalEntry["仕訳データ生成"]
        SyncAccounting["会計ソフト連携"]
    end

    MonthStart --> GenInvoice
    GenInvoice --> ReviewInvoice
    ReviewInvoice --> AdjustInvoice
    AdjustInvoice --> GenDirectDebit
    GenDirectDebit --> SendDirectDebit
    ReviewInvoice --> SendInvoice

    SendDirectDebit --> ImportPayment
    ImportPayment --> AutoReconcile
    AutoReconcile --> ManualReconcile
    ManualReconcile --> ConfirmReconcile

    ConfirmReconcile --> DetectDelinquency
    DetectDelinquency --> ClassifyDelinquency
    ClassifyDelinquency --> GenDunning
    GenDunning --> SendDunning
    SendDunning --> RecordDunning

    ConfirmReconcile --> CalcRemittance
    CalcRemittance --> ReviewRemittance
    ReviewRemittance --> ConfirmRemittance
    ConfirmRemittance --> GenZengin
    GenZengin --> ExecuteTransfer
    ConfirmRemittance --> GenStatement
    GenStatement --> SendStatement

    ExecuteTransfer --> GenMonthlyReport
    SendStatement --> GenOwnerReport
    GenMonthlyReport --> GenJournalEntry
    GenJournalEntry --> SyncAccounting

D.3 解約〜退去フロー

graph TD
    ReceiveTermination["解約申請受付"]
    RegisterTermination["解約情報登録<br/>(解約日・退去日)"]
    NotifyOwner["オーナーへ通知"]
    ScheduleInspection["退去立会い<br/>日程調整"]
    Inspection["退去立会い実施"]
    Checklist["チェックリスト<br/>記入"]
    EstimateRepair["原状回復<br/>見積取得"]
    OwnerApproval{オーナー<br/>承認}
    ReviseEstimate["見積修正"]
    CalcSettlement["精算計算"]
    SettlementItems["精算項目確定"]
    CreateSettlement["精算書作成"]
    DepositReturn{敷金返還<br/>あり?}
    ReturnDeposit["敷金返還<br/>振込処理"]
    AdditionalCharge["追加請求<br/>処理"]
    UpdateUnitStatus["区画ステータス<br/>更新: 空室"]
    UpdateContractStatus["契約ステータス<br/>更新: 解約済"]
    StartRenovation{リフォーム<br/>必要?}
    Renovation["リフォーム実施"]
    RestartRecruitment["募集再開"]
    End["完了"]

    ReceiveTermination --> RegisterTermination
    RegisterTermination --> NotifyOwner
    NotifyOwner --> ScheduleInspection
    ScheduleInspection --> Inspection
    Inspection --> Checklist
    Checklist --> EstimateRepair
    EstimateRepair --> OwnerApproval
    OwnerApproval -->|"承認"| CalcSettlement
    OwnerApproval -->|"差戻し"| ReviseEstimate
    ReviseEstimate --> OwnerApproval
    CalcSettlement --> SettlementItems
    SettlementItems --> CreateSettlement
    CreateSettlement --> DepositReturn
    DepositReturn -->|"Yes"| ReturnDeposit
    DepositReturn -->|"No"| AdditionalCharge
    ReturnDeposit --> UpdateUnitStatus
    AdditionalCharge --> UpdateUnitStatus
    UpdateUnitStatus --> UpdateContractStatus
    UpdateContractStatus --> StartRenovation
    StartRenovation -->|"Yes"| Renovation
    StartRenovation -->|"No"| RestartRecruitment
    Renovation --> RestartRecruitment
    RestartRecruitment --> End

D.4 修繕フロー

graph TD
    Receive["問い合わせ受付"]
    ClassifySource{受付経路}
    Phone["電話"]
    Email["メール"]
    Portal["ポータル"]
    Chat["チャット"]

    CreateTicket["チケット作成"]
    Classify["カテゴリ分類"]
    AssignPriority["優先度設定"]
    AssignStaff["担当者アサイン"]

    InitialResponse["初期対応<br/>(入居者への連絡)"]
    SiteVisit{現地確認<br/>必要?}
    Visit["現地確認実施"]
    Assessment["状況アセスメント"]

    GetEstimate["見積取得"]
    CompareEstimate["見積比較<br/>(複数業者)"]
    DetermineCostBearer{費用負担者<br/>判定}
    OwnerBear["オーナー負担"]
    TenantBear["入居者負担"]
    CompanyBear["管理会社負担"]

    RequestOwnerApproval["オーナー承認依頼"]
    OwnerDecision{承認?}
    Approved["承認済"]
    Denied["却下/再検討"]

    OrderVendor["業者発注"]
    ScheduleWork["工事日程調整"]
    ExecuteWork["工事実施"]
    ConfirmCompletion["完了確認"]
    RecordCost["費用計上"]
    NotifyStakeholders["関係者通知"]
    CloseTicket["チケットクローズ"]

    Receive --> ClassifySource
    ClassifySource --> Phone
    ClassifySource --> Email
    ClassifySource --> Portal
    ClassifySource --> Chat
    Phone --> CreateTicket
    Email --> CreateTicket
    Portal --> CreateTicket
    Chat --> CreateTicket

    CreateTicket --> Classify
    Classify --> AssignPriority
    AssignPriority --> AssignStaff
    AssignStaff --> InitialResponse

    InitialResponse --> SiteVisit
    SiteVisit -->|"Yes"| Visit
    SiteVisit -->|"No"| GetEstimate
    Visit --> Assessment
    Assessment --> GetEstimate

    GetEstimate --> CompareEstimate
    CompareEstimate --> DetermineCostBearer
    DetermineCostBearer --> OwnerBear
    DetermineCostBearer --> TenantBear
    DetermineCostBearer --> CompanyBear

    OwnerBear --> RequestOwnerApproval
    RequestOwnerApproval --> OwnerDecision
    OwnerDecision -->|"承認"| Approved
    OwnerDecision -->|"却下"| Denied
    Denied --> GetEstimate

    Approved --> OrderVendor
    TenantBear --> OrderVendor
    CompanyBear --> OrderVendor

    OrderVendor --> ScheduleWork
    ScheduleWork --> ExecuteWork
    ExecuteWork --> ConfirmCompletion
    ConfirmCompletion --> RecordCost
    RecordCost --> NotifyStakeholders
    NotifyStakeholders --> CloseTicket

付録E: エラーコード一覧

E.1 認証エラー

E.2 権限エラー

E.3 バリデーションエラー

E.4 ビジネスロジックエラー

E.5 外部連携エラー

E.6 システムエラー

付録F: データバリデーション規則

F.1 共通バリデーション

F.2 ドメイン固有バリデーション

F.3 ファイルアップロードバリデーション

付録G: 帳票テンプレート一覧（Phase 1: 20種）

付録H: 環境変数一覧

付録I: パフォーマンスSLA詳細

付録J: セキュリティチェックリスト

J.1 開発時チェック

J.2 デプロイ時チェック

J.3 定期チェック（月次）

付録K: Zodバリデーションスキーマ定義

K.1 建物関連スキーマ

import { z } from 'zod';

// 構造ENUM
const buildingStructureEnum = z.enum([
  'RC',    // 鉄筋コンクリート
  'SRC',   // 鉄骨鉄筋コンクリート
  'S',     // 鉄骨
  'W',     // 木造
  'LGS',   // 軽量鉄骨
  'other', // その他
]);

// 管理形態ENUM
const managementTypeEnum = z.enum([
  'self',              // 自主管理
  'collection_agency', // 集金代行
  'sublease',          // サブリース
  'exclusive',         // 専任管理
]);

// 最寄り駅スキーマ
const nearestStationSchema = z.object({
  line: z.string().min(1).max(100),
  station: z.string().min(1).max(100),
  walkMinutes: z.number().int().min(0).max(60).nullable(),
  busMinutes: z.number().int().min(0).max(60).nullable(),
});

// 共有設備スキーマ
const sharedFacilitySchema = z.object({
  name: z.string().min(1).max(100),
  available: z.boolean(),
  type: z.string().max(100).optional(),
});

// 建物作成スキーマ
export const buildingCreateSchema = z.object({
  name: z.string().min(1, '建物名は必須です').max(255),
  postalCode: z.string().regex(/^\d{3}-?\d{4}$/, '郵便番号の形式が不正です'),
  prefecture: z.string().min(1).max(10),
  city: z.string().min(1).max(100),
  address1: z.string().min(1).max(255),
  address2: z.string().max(255).optional(),
  structure: buildingStructureEnum,
  constructionDate: z.coerce.date().optional(),
  totalUnits: z.number().int().min(1, '総戸数は1以上').max(10000),
  floorsAbove: z.number().int().min(1).max(100).optional(),
  floorsBelow: z.number().int().min(0).max(10).optional(),
  ownerId: z.string().uuid().optional(),
  managementType: managementTypeEnum,
  managementFeeRate: z.number().min(0).max(100).optional(),
  sharedFacilities: z.array(sharedFacilitySchema).default([]),
  nearestStations: z.array(nearestStationSchema).default([]),
  notes: z.string().max(10000).optional(),
});

// 建物更新スキーマ
export const buildingUpdateSchema = buildingCreateSchema.partial();

// 建物一覧取得スキーマ
export const buildingListSchema = z.object({
  cursor: z.string().optional(),
  limit: z.number().int().min(1).max(100).default(25),
  search: z.string().max(255).optional(),
  prefecture: z.string().max(10).optional(),
  managementType: managementTypeEnum.optional(),
  ownerId: z.string().uuid().optional(),
  sortBy: z.enum(['name', 'createdAt', 'occupancyRate']).default('name'),
  sortOrder: z.enum(['asc', 'desc']).default('asc'),
});

K.2 区画関連スキーマ

// 区画ステータスENUM
const unitStatusEnum = z.enum([
  'vacant',      // 空室
  'occupied',    // 入居中
  'leaving',     // 退去予定
  'recruiting',  // 募集中
  'suspended',   // 募集停止
  'renovating',  // リフォーム中
]);

// 方位ENUM
const directionEnum = z.enum(['N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW']);

// 設備スキーマ
const facilitySchema = z.object({
  name: z.string().min(1).max(100),
  available: z.boolean(),
  memo: z.string().max(255).optional(),
});

// 募集条件スキーマ
const recruitmentConditionsSchema = z.object({
  petAllowed: z.boolean().default(false),
  instrumentAllowed: z.boolean().default(false),
  corporateContractAllowed: z.boolean().default(true),
  smokingAllowed: z.boolean().default(false),
  foreignerAllowed: z.boolean().default(true),
  elderlyAllowed: z.boolean().default(true),
  welfareAllowed: z.boolean().default(true),
  maxOccupants: z.number().int().min(1).max(10).optional(),
  notes: z.string().max(1000).optional(),
});

// 区画作成スキーマ
export const unitCreateSchema = z.object({
  buildingId: z.string().uuid(),
  unitNumber: z.string().min(1).max(20),
  floor: z.number().int().min(-10).max(100).optional(),
  layout: z.string().max(20).optional(), // 1K, 2LDK等
  areaSqm: z.number().min(0.01).max(9999.99).optional(),
  direction: directionEnum.optional(),
  rent: z.number().int().min(0).max(99999999),
  managementFee: z.number().int().min(0).max(9999999).default(0),
  commonFee: z.number().int().min(0).max(9999999).default(0),
  depositMonths: z.number().min(0).max(24).multipleOf(0.5).default(0),
  keyMoneyMonths: z.number().min(0).max(24).multipleOf(0.5).default(0),
  facilities: z.array(facilitySchema).default([]),
  status: unitStatusEnum.default('vacant'),
  availableFrom: z.coerce.date().optional(),
  recruitmentConditions: recruitmentConditionsSchema.default({}),
  notes: z.string().max(10000).optional(),
});

// 区画一覧取得スキーマ
export const unitListSchema = z.object({
  cursor: z.string().optional(),
  limit: z.number().int().min(1).max(100).default(25),
  buildingId: z.string().uuid().optional(),
  status: z.array(unitStatusEnum).optional(),
  layoutType: z.string().optional(),
  rentMin: z.number().int().min(0).optional(),
  rentMax: z.number().int().min(0).optional(),
  search: z.string().max(255).optional(),
  sortBy: z.enum(['unitNumber', 'rent', 'areaSqm', 'status']).default('unitNumber'),
  sortOrder: z.enum(['asc', 'desc']).default('asc'),
});

K.3 契約関連スキーマ

// 契約種別ENUM
const contractTypeEnum = z.enum(['new', 'renewal', 'sublease']);
const contractorTypeEnum = z.enum(['individual', 'corporation']);
const contractStatusEnum = z.enum([
  'draft',      // 下書き
  'active',     // 契約中
  'renewed',    // 更新済み
  'terminated', // 解約済み
  'cancelled',  // 取消
]);

// 連帯保証人スキーマ
const guarantorSchema = z.object({
  name: z.string().min(1).max(255),
  nameKana: z.string().max(255).optional(),
  phone: z.string().regex(/^[\d-]{10,15}$/).optional(),
  address: z.string().max(500).optional(),
  relation: z.string().max(50).optional(),
  maxGuaranteeAmount: z.number().int().min(0), // 極度額（民法改正対応）
});

// 特約事項スキーマ
const specialTermSchema = z.object({
  title: z.string().min(1).max(255),
  content: z.string().min(1).max(5000),
});

// 契約作成スキーマ
export const contractCreateSchema = z.object({
  unitId: z.string().uuid(),
  tenantId: z.string().uuid().optional(), // 新規入居者の場合は省略可
  newTenant: z.object({
    lastName: z.string().min(1).max(100),
    firstName: z.string().min(1).max(100),
    lastNameKana: z.string().max(100).optional(),
    firstNameKana: z.string().max(100).optional(),
    email: z.string().email().optional(),
    phone: z.string().regex(/^[\d-]{10,15}$/).optional(),
    mobilePhone: z.string().regex(/^[\d-]{10,15}$/).optional(),
    postalCode: z.string().regex(/^\d{3}-?\d{4}$/).optional(),
    address: z.string().max(500).optional(),
    workplaceName: z.string().max(255).optional(),
    workplacePhone: z.string().regex(/^[\d-]{10,15}$/).optional(),
    emergencyContactName: z.string().max(255).optional(),
    emergencyContactPhone: z.string().regex(/^[\d-]{10,15}$/).optional(),
    emergencyContactRelation: z.string().max(50).optional(),
    dateOfBirth: z.coerce.date().optional(),
    gender: z.enum(['male', 'female', 'other', 'unspecified']).optional(),
  }).optional(),
  contractType: contractTypeEnum,
  contractorType: contractorTypeEnum,
  startDate: z.coerce.date(),
  endDate: z.coerce.date(),
  rent: z.number().int().min(0).max(99999999),
  managementFee: z.number().int().min(0).max(9999999),
  commonFee: z.number().int().min(0).max(9999999).default(0),
  deposit: z.number().int().min(0).max(99999999),
  keyMoney: z.number().int().min(0).max(99999999),
  renewalFeeMonths: z.number().min(0).max(24).optional(),
  guaranteeCompanyId: z.string().uuid().optional(),
  guarantors: z.array(guarantorSchema).default([]),
  specialTerms: z.array(specialTermSchema).default([]),
  notes: z.string().max(10000).optional(),
}).refine(
  (data) => data.startDate < data.endDate,
  { message: '契約開始日は終了日より前である必要があります', path: ['endDate'] }
).refine(
  (data) => data.tenantId || data.newTenant,
  { message: '入居者IDまたは新規入居者情報のいずれかは必須です' }
);

// 解約スキーマ
export const contractTerminateSchema = z.object({
  contractId: z.string().uuid(),
  terminationDate: z.coerce.date(),
  moveOutDate: z.coerce.date(),
  terminationReason: z.string().max(1000).optional(),
}).refine(
  (data) => data.terminationDate <= data.moveOutDate,
  { message: '解約日は退去日以前である必要があります', path: ['moveOutDate'] }
);

K.4 入出金関連スキーマ

// 入金方法ENUM
const paymentMethodEnum = z.enum([
  'bank_transfer',  // 銀行振込
  'direct_debit',   // 口座振替
  'cash',           // 現金
  'credit_card',    // クレジットカード
  'other',          // その他
]);

// 消込ステータスENUM
const reconciliationStatusEnum = z.enum([
  'unmatched',      // 未消込
  'auto_matched',   // 自動消込
  'manual_matched', // 手動消込
  'confirmed',      // 確定済み
]);

// 手動入金登録スキーマ
export const paymentCreateSchema = z.object({
  contractId: z.string().uuid().optional(),
  invoiceId: z.string().uuid().optional(),
  paymentType: z.enum(['income', 'expense']),
  amount: z.number().int().min(1, '金額は1円以上'),
  paymentDate: z.coerce.date(),
  method: paymentMethodEnum,
  payerName: z.string().max(255).optional(),
  bankName: z.string().max(100).optional(),
  bankBranch: z.string().max(100).optional(),
  accountNumber: z.string().max(20).optional(),
  notes: z.string().max(10000).optional(),
});

// 手動消込スキーマ
export const manualReconcileSchema = z.object({
  paymentId: z.string().uuid(),
  invoiceId: z.string().uuid(),
  amount: z.number().int().min(1),
  notes: z.string().max(1000).optional(),
});

// 全銀データ取込スキーマ
export const zenginImportSchema = z.object({
  file: z.instanceof(File).refine(
    (f) => f.size <= 5 * 1024 * 1024,
    '全銀ファイルは5MB以内'
  ),
  encoding: z.enum(['shift_jis', 'utf8']).default('shift_jis'),
});

K.5 修繕関連スキーマ

// 修繕カテゴリENUM
const maintenanceCategoryEnum = z.enum([
  'equipment',    // 設備故障
  'noise',        // 騒音
  'leak',         // 漏水
  'pest',         // 害虫
  'common_area',  // 共用部
  'other',        // その他
]);

// 優先度ENUM
const priorityEnum = z.enum(['low', 'medium', 'high', 'urgent']);

// 修繕チケット作成スキーマ
export const maintenanceCreateSchema = z.object({
  unitId: z.string().uuid().optional(),
  buildingId: z.string().uuid().optional(),
  tenantId: z.string().uuid().optional(),
  title: z.string().min(1, 'タイトルは必須です').max(255),
  description: z.string().min(1, '詳細説明は必須です').max(10000),
  category: maintenanceCategoryEnum,
  priority: priorityEnum.default('medium'),
  source: z.enum(['phone', 'email', 'portal', 'chat', 'other']),
}).refine(
  (data) => data.unitId || data.buildingId,
  { message: '区画IDまたは建物IDのいずれかは必須です' }
);

// 見積登録スキーマ
export const maintenanceEstimateSchema = z.object({
  ticketId: z.string().uuid(),
  vendorId: z.string().uuid(),
  amount: z.number().int().min(0),
  description: z.string().min(1).max(5000),
  estimatedDays: z.number().int().min(1).max(365).optional(),
  attachmentUrls: z.array(z.string().url()).default([]),
});

付録L: tRPCルーター定義

L.1 ルートルーター構成

// server/trpc/router.ts
import { router } from './trpc';
import { buildingRouter } from './routers/building';
import { unitRouter } from './routers/unit';
import { contractRouter } from './routers/contract';
import { invoiceRouter } from './routers/invoice';
import { paymentRouter } from './routers/payment';
import { ownerRouter } from './routers/owner';
import { tenantRouter } from './routers/tenant';
import { maintenanceRouter } from './routers/maintenance';
import { remittanceRouter } from './routers/remittance';
import { dunningRouter } from './routers/dunning';
import { documentRouter } from './routers/document';
import { reportRouter } from './routers/report';
import { dashboardRouter } from './routers/dashboard';
import { userRouter } from './routers/user';
import { organizationRouter } from './routers/organization';
import { parkingRouter } from './routers/parking';
import { portalRouter } from './routers/portal';

export const appRouter = router({
  building: buildingRouter,
  unit: unitRouter,
  contract: contractRouter,
  invoice: invoiceRouter,
  payment: paymentRouter,
  owner: ownerRouter,
  tenant: tenantRouter,
  maintenance: maintenanceRouter,
  remittance: remittanceRouter,
  dunning: dunningRouter,
  document: documentRouter,
  report: reportRouter,
  dashboard: dashboardRouter,
  user: userRouter,
  organization: organizationRouter,
  parking: parkingRouter,
  portal: portalRouter,
});

export type AppRouter = typeof appRouter;

L.2 tRPCコンテキスト定義

// server/trpc/context.ts
import { inferAsyncReturnType } from '@trpc/server';
import { CreateNextContextOptions } from '@trpc/server/adapters/next';
import { prisma } from '@/lib/prisma';
import { redis } from '@/lib/redis';
import { getSession } from '@/lib/auth';
import { resolveTenant } from '@/lib/tenant';

export async function createContext({ req, res }: CreateNextContextOptions) {
  const session = await getSession(req);
  const tenant = await resolveTenant(req);

  // PostgreSQLセッション変数にテナントIDをセット
  if (tenant) {
    await prisma.$executeRawUnsafe(
      `SET app.current_tenant_id = '${tenant.id}'`
    );
  }

  return {
    req,
    res,
    prisma,
    redis,
    session,
    user: session?.user ?? null,
    tenant,
    auditLog: {
      record: async (entry: AuditLogInput) => {
        await prisma.auditLog.create({
          data: {
            organizationId: tenant?.id ?? '',
            userId: session?.user?.id ?? '',
            action: entry.action,
            resourceType: entry.resourceType ?? '',
            resourceId: entry.resourceId,
            changes: entry.changes,
            ipAddress: req.headers['x-forwarded-for']?.toString() ?? req.socket.remoteAddress,
            userAgent: req.headers['user-agent'],
          },
        });
      },
    },
  };
}

export type Context = inferAsyncReturnType<typeof createContext>;

L.3 共通ミドルウェア

// server/trpc/middleware.ts
import { TRPCError } from '@trpc/server';
import { middleware } from './trpc';

// 認証ミドルウェア
export const isAuthenticated = middleware(async ({ ctx, next }) => {
  if (!ctx.user) {
    throw new TRPCError({
      code: 'UNAUTHORIZED',
      message: 'ログインが必要です',
    });
  }

  if (!ctx.tenant) {
    throw new TRPCError({
      code: 'UNAUTHORIZED',
      message: 'テナント情報が特定できません',
    });
  }

  return next({
    ctx: {
      user: ctx.user,
      tenant: ctx.tenant,
    },
  });
});

// テナントアクティブチェック
export const isTenantActive = middleware(async ({ ctx, next }) => {
  if (ctx.tenant?.status !== 'active') {
    throw new TRPCError({
      code: 'FORBIDDEN',
      message: 'テナントが停止中またはトライアル期限切れです',
    });
  }
  return next();
});

// 権限チェックミドルウェア
export const requirePermission = (permission: string) => {
  return middleware(async ({ ctx, next }) => {
    const hasPermission = ctx.user?.permissions?.includes(permission);
    if (!hasPermission) {
      throw new TRPCError({
        code: 'FORBIDDEN',
        message: `権限が不足しています: ${permission}`,
      });
    }
    return next();
  });
};

// フィーチャーフラグチェックミドルウェア
export const requireFeature = (featurePath: string) => {
  return middleware(async ({ ctx, next }) => {
    const flags = ctx.tenant?.featureFlags ?? {};
    const parts = featurePath.split('.');
    let current: any = flags;

    for (const part of parts) {
      current = current?.[part];
    }

    if (current !== true) {
      throw new TRPCError({
        code: 'FORBIDDEN',
        message: 'この機能は現在のプランでは利用できません',
      });
    }

    return next();
  });
};

// レート制限ミドルウェア
export const rateLimit = (maxRequests: number, windowMs: number) => {
  return middleware(async ({ ctx, next }) => {
    const key = `ratelimit:${ctx.tenant?.id}:${ctx.user?.id}`;
    const current = await ctx.redis.incr(key);

    if (current === 1) {
      await ctx.redis.expire(key, Math.ceil(windowMs / 1000));
    }

    if (current > maxRequests) {
      throw new TRPCError({
        code: 'TOO_MANY_REQUESTS',
        message: 'リクエスト数の上限に達しました。しばらく後に再試行してください。',
      });
    }

    return next();
  });
};

付録M: Prismaスキーマ（抜粋）

// prisma/schema.prisma

generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["multiSchema", "postgresqlExtensions"]
}

datasource db {
  provider   = "postgresql"
  url        = env("DATABASE_URL")
  extensions = [pgTrgm, uuid_ossp]
}

enum BuildingStructure {
  RC
  SRC
  S
  W
  LGS
  other
}

enum ManagementType {
  self
  collection_agency
  sublease
  exclusive
}

enum UnitStatus {
  vacant
  occupied
  leaving
  recruiting
  suspended
  renovating
}

enum ContractType {
  new_contract
  renewal
  sublease
}

enum ContractorType {
  individual
  corporation
}

enum ContractStatus {
  draft
  active
  renewed
  terminated
  cancelled
}

enum OwnerType {
  individual
  corporation
}

enum TaxCategory {
  individual
  corporation
  non_resident
}

enum InvoiceStatus {
  draft
  issued
  sent
  partial_paid
  paid
  overdue
  cancelled
}

enum PaymentType {
  income
  expense
}

enum PaymentMethod {
  bank_transfer
  direct_debit
  cash
  credit_card
  other
}

enum PaymentStatus {
  pending
  completed
  partial
  overpaid
  refunded
}

enum ReconciliationStatus {
  unmatched
  auto_matched
  manual_matched
  confirmed
}

enum MaintenanceCategory {
  equipment
  noise
  leak
  pest
  common_area
  other
}

enum Priority {
  low
  medium
  high
  urgent
}

enum MaintenanceStatus {
  received
  in_progress
  waiting_estimate
  waiting_approval
  ordered
  completed
  closed
}

enum OrganizationStatus {
  active
  suspended
  trial
}

model Organization {
  id                    String             @id @default(uuid()) @db.Uuid
  name                  String             @db.VarChar(255)
  slug                  String             @unique @db.VarChar(100)
  planId                String?            @map("plan_id") @db.Uuid
  logoUrl               String?            @map("logo_url") @db.VarChar(512)
  faviconUrl            String?            @map("favicon_url") @db.VarChar(512)
  themeConfig           Json               @default("{}") @map("theme_config")
  featureFlags          Json               @default("{}") @map("feature_flags")
  terminologyOverrides  Json               @default("{}") @map("terminology_overrides")
  emailFromAddress      String?            @map("email_from_address") @db.VarChar(255)
  emailFromName         String?            @map("email_from_name") @db.VarChar(255)
  storageLimitMb        Int                @default(5120) @map("storage_limit_mb")
  storageUsedMb         Int                @default(0) @map("storage_used_mb")
  status                OrganizationStatus @default(trial)
  trialEndsAt           DateTime?          @map("trial_ends_at")
  createdAt             DateTime           @default(now()) @map("created_at")
  updatedAt             DateTime           @updatedAt @map("updated_at")

  buildings       Building[]
  units           Unit[]
  contracts       Contract[]
  owners          Owner[]
  tenants         Tenant[]
  invoices        Invoice[]
  payments        Payment[]
  users           User[]
  maintenanceTickets MaintenanceTicket[]
  remittances     Remittance[]
  customDomains   CustomDomain[]
  documentTemplates DocumentTemplate[]
  plan            Plan?              @relation(fields: [planId], references: [id])

  @@map("organization")
}

model Building {
  id                String            @id @default(uuid()) @db.Uuid
  organizationId    String            @map("organization_id") @db.Uuid
  ownerId           String?           @map("owner_id") @db.Uuid
  name              String            @db.VarChar(255)
  postalCode        String            @map("postal_code") @db.VarChar(10)
  prefecture        String            @db.VarChar(10)
  city              String            @db.VarChar(100)
  address1          String            @db.VarChar(255)
  address2          String?           @db.VarChar(255)
  latitude          Decimal?          @db.Decimal(10, 7)
  longitude         Decimal?          @db.Decimal(10, 7)
  structure         BuildingStructure
  constructionDate  DateTime?         @map("construction_date") @db.Date
  totalUnits        Int               @map("total_units")
  floorsAbove       Int?              @map("floors_above")
  floorsBelow       Int?              @map("floors_below")
  sharedFacilities  Json              @default("[]") @map("shared_facilities")
  nearestStations   Json              @default("[]") @map("nearest_stations")
  managementType    ManagementType    @map("management_type")
  managementFeeRate Decimal?          @map("management_fee_rate") @db.Decimal(5, 2)
  notes             String?           @db.Text
  deletedAt         DateTime?         @map("deleted_at")
  createdAt         DateTime          @default(now()) @map("created_at")
  updatedAt         DateTime          @updatedAt @map("updated_at")

  organization      Organization      @relation(fields: [organizationId], references: [id])
  owner             Owner?            @relation(fields: [ownerId], references: [id])
  units             Unit[]
  images            BuildingImage[]
  parkingSpaces     ParkingSpace[]
  maintenanceTickets MaintenanceTicket[]

  @@index([organizationId], name: "idx_building_org_id")
  @@index([ownerId], name: "idx_building_owner_id")
  @@index([prefecture, city], name: "idx_building_prefecture_city")
  @@map("building")
}

model Unit {
  id                    String     @id @default(uuid()) @db.Uuid
  buildingId            String     @map("building_id") @db.Uuid
  organizationId        String     @map("organization_id") @db.Uuid
  unitNumber            String     @map("unit_number") @db.VarChar(20)
  floor                 Int?
  layout                String?    @db.VarChar(20)
  areaSqm               Decimal?   @map("area_sqm") @db.Decimal(8, 2)
  direction             String?    @db.VarChar(2)
  rent                  Decimal    @db.Decimal(12, 0)
  managementFee         Decimal    @default(0) @map("management_fee") @db.Decimal(12, 0)
  commonFee             Decimal    @default(0) @map("common_fee") @db.Decimal(12, 0)
  depositMonths         Decimal    @default(0) @map("deposit_months") @db.Decimal(4, 1)
  keyMoneyMonths        Decimal    @default(0) @map("key_money_months") @db.Decimal(4, 1)
  facilities            Json       @default("[]")
  status                UnitStatus @default(vacant)
  availableFrom         DateTime?  @map("available_from") @db.Date
  recruitmentConditions Json       @default("{}") @map("recruitment_conditions")
  notes                 String?    @db.Text
  deletedAt             DateTime?  @map("deleted_at")
  createdAt             DateTime   @default(now()) @map("created_at")
  updatedAt             DateTime   @updatedAt @map("updated_at")

  building              Building   @relation(fields: [buildingId], references: [id])
  organization          Organization @relation(fields: [organizationId], references: [id])
  contracts             Contract[]
  maintenanceTickets    MaintenanceTicket[]

  @@unique([buildingId, unitNumber], name: "idx_unit_building_number")
  @@index([organizationId], name: "idx_unit_org_id")
  @@index([status], name: "idx_unit_status")
  @@map("unit")
}

model Contract {
  id                   String         @id @default(uuid()) @db.Uuid
  unitId               String         @map("unit_id") @db.Uuid
  tenantId             String         @map("tenant_id") @db.Uuid
  organizationId       String         @map("organization_id") @db.Uuid
  contractNumber       String         @map("contract_number") @db.VarChar(50)
  contractType         ContractType   @map("contract_type")
  contractorType       ContractorType @map("contractor_type")
  startDate            DateTime       @map("start_date") @db.Date
  endDate              DateTime       @map("end_date") @db.Date
  rent                 Decimal        @db.Decimal(12, 0)
  managementFee        Decimal        @map("management_fee") @db.Decimal(12, 0)
  commonFee            Decimal        @default(0) @map("common_fee") @db.Decimal(12, 0)
  deposit              Decimal        @db.Decimal(12, 0)
  keyMoney             Decimal        @map("key_money") @db.Decimal(12, 0)
  renewalFeeMonths     Decimal?       @map("renewal_fee_months") @db.Decimal(4, 1)
  guaranteeCompanyId   String?        @map("guarantee_company_id") @db.Uuid
  specialTerms         Json           @default("[]") @map("special_terms")
  status               ContractStatus @default(draft)
  renewalNoticeDate    DateTime?      @map("renewal_notice_date") @db.Date
  terminationDate      DateTime?      @map("termination_date") @db.Date
  terminationReason    String?        @map("termination_reason") @db.Text
  moveOutDate          DateTime?      @map("move_out_date") @db.Date
  notes                String?        @db.Text
  deletedAt            DateTime?      @map("deleted_at")
  createdAt            DateTime       @default(now()) @map("created_at")
  updatedAt            DateTime       @updatedAt @map("updated_at")

  unit                 Unit           @relation(fields: [unitId], references: [id])
  tenant               Tenant         @relation(fields: [tenantId], references: [id])
  organization         Organization   @relation(fields: [organizationId], references: [id])
  invoices             Invoice[]
  payments             Payment[]
  guarantors           ContractGuarantor[]

  @@unique([organizationId, contractNumber], name: "idx_contract_number_org")
  @@index([unitId], name: "idx_contract_unit_id")
  @@index([tenantId], name: "idx_contract_tenant_id")
  @@index([organizationId], name: "idx_contract_org_id")
  @@index([status], name: "idx_contract_status")
  @@index([endDate], name: "idx_contract_end_date")
  @@map("contract")
}

付録N: 変更履歴

*PropCloud - 機能仕様書 v1.0.0*

*Generated by CodeGenAgent (源) - CCAGI SDK Phase 2*