fab-forward-sales 実装設定 / Implementation Configuration

目的: fab-forward-sales (Sales CRM) の実装仕様書。 DDD モデル (docs/ddd/sales/) の「インスタンス」として、実装済みのコレクション・フィールド・業務ルール・ アクセス制御を正規のソースコードから導出し記録する。

ベンチマーク元: TransLead CRM (fab-forward-sales/benchmark_translead/) テクノロジースタック: Next.js + Payload CMS + Drizzle ORM + PostgreSQL リポジトリ: ~/repos/fab-forward-sales

→ DDD モデル: docs/ddd/sales/ (ドメインモデル仕様) → 知識ベース: docs/knowledge/06-crm-fundamentals/, 07-sales-management/, 09-japanese-sales-culture/

---

1. コレクション一覧 (Collections)

出典: src/collections/index.ts

計画中のコレクション / エンドポイント

---

2. 区分マスタ (Enumerations — SSOT)

出典: src/lib/constants/labels.ts, src/lib/types/roles.ts

2.1 案件タイプ — DEAL_TYPE_VALUES

// src/lib/constants/labels.ts:65
export const DEAL_TYPE_VALUES = ["negotiation", "inquiry", "lead"] as const;

TransLead は inquiry と lead を「引合・リード」として統合 (2値)。実装では 3値に分離。

2.2 案件ステータス — DEAL_STATUS_VALUES

// src/lib/constants/labels.ts:84
export const DEAL_STATUS_VALUES = ["open", "won", "lost"] as const;

2.3 活動タイプ — ACTIVITY_TYPE_VALUES

// src/lib/constants/labels.ts:26
export const ACTIVITY_TYPE_VALUES = ["call", "meeting", "inquiry", "email", "email_received", "other"] as const;

2.4 ファイルタイプ — FILE_TYPE_VALUES

// src/lib/constants/labels.ts:103
export const FILE_TYPE_VALUES = ["proposal", "quote", "contract", "business_card", "other"] as const;

2.5 ユーザーロール — USER_ROLE_VALUES

// src/lib/types/roles.ts:13
export const USER_ROLE_VALUES = ["admin", "manager", "sales_rep", "executive"] as const;

出典: src/lib/types/roles.ts — ROLES 定数に permission 定義あり。

2.6 カスタムフィールドタイプ

// src/types/customField.ts
export type FieldType = "text" | "number" | "date" | "dropdown" | "checkbox";
export type EntityType = "account" | "contact" | "deal";

---

3. フィールド定義 (全コレクション)

3.1 accounts — 取引先

出典: src/collections/Accounts.ts:77-231

Hooks: beforeChange → 楽観ロック検証 + version++ + AuditService Access: RBAC 実装済み (§4 参照)

3.2 contacts — 担当者

出典: src/collections/Contacts.ts:62-178

Hooks: beforeChange → AuditService + 楽観ロック検証 + version++ Access: RBAC 実装済み (§4 参照)

3.3 deals — 案件

出典: src/collections/Deals.ts:68-222

Hooks: beforeChange → 楽観ロック検証 + version++ + AuditService Access: RBAC 実装済み (§4 参照)

3.4 activities — 活動

出典: src/collections/Activities.ts:124-261

Hooks: beforeValidate → account 必須 + activityType 検証 + subject 空文字 + duration > 0 Hooks: beforeChange → 楽観ロック + AuditService Access: RBAC 実装済み (§4 参照)

3.5 daily-reports — 日報

出典: src/collections/DailyReports.ts:91-236

Hooks: beforeValidate → user + reportDate ユニーク制約 Hooks: beforeChange → AuditService + user 自動設定 Access: RBAC 実装済み (§4 参照)

3.6 files — ファイル

出典: src/collections/Files.ts:62-226

URL バリデーション: javascript: 禁止、http: / https: のみ許可 Access: RBAC 実装済み (§4 参照)

3.7 users — ユーザー

出典: src/collections/Users.ts:93-223

Auth 設定: tokenExpiration=7200s, maxLoginAttempts=3, lockTime=900000ms Access: RBAC 実装済み (§4 参照)

3.8 staff_groups — 部署グループ

出典: src/collections/StaffGroups.ts:32-62

Access: read=全員, create/update/delete=admin のみ

3.9 company_settings — 企業設定

出典: src/collections/CompanySettings.ts:132-265

シングルトンパターン: beforeChange で既存レコード存在チェック → 2件目作成禁止 Access: read=全員, create/update/delete=admin のみ

3.10 custom_field_configs — カスタムフィールド

出典: src/collections/CustomFieldConfigs.ts:131-269

予約語: src/types/customField.ts:120 — id, created_at, updated_at, created_by, updated_by, version, deleted_at, deleted_by ユニーク制約: entity_type + field_name (beforeChange で検証) dropdown 検証: options 配列に最低 1 要素必須 number 検証: min_value ≤ max_value Access: 全操作 admin のみ

---

4. アクセス制御 (RBAC) 実装状況

出典: 各コレクションの access プロパティ → 完全な RBAC 仕様: iam.md §RBAC データアクセスマトリクス

RBAC 詳細 (実装済みコレクション)

accounts, contacts, deals, activities, files (共通パターン — src/lib/access/salesRepScoped.ts):

• read: admin/manager/executive → 全件、sales_rep → { salesRep: { equals: user.id } }
• create: admin/manager/sales_rep → 許可、executive → 不可
• update: admin/manager → 全件、sales_rep → { salesRep: { equals: user.id } }、executive → 不可
• delete: admin のみ

daily-reports:

• read: admin/manager/executive → 全件、sales_rep → { user: { equals: user.id } }
• update: admin/manager → 全件、sales_rep → { user: { equals: user.id } }
• delete: admin のみ

users:

• read: admin/manager/executive → 全件、sales_rep → { id: { equals: user.id } }
• update: admin → 全件、その他 → { id: { equals: user.id } }

→ see iam.md §RBAC データアクセスマトリクス (per-collection × per-role 完全定義) → see 05-business-rules.md §10 RBAC データスコーピング (ルール RBAC-001 〜 RBAC-005)

---

5. 共通パターン (Cross-cutting)

5.1 楽観ロック

実装済みコレクション: accounts, contacts, deals, activities, daily-reports, files, company_settings, custom_field_configs

beforeChange:
  if update && incomingVersion !== currentVersion:
    → 409 Conflict + { latestData, modifiedBy, modifiedAt }
  else:
    version = currentVersion + 1
  if create:
    version = 0

全コレクション楽観ロック実装完了 ✅

5.2 監査フィールド

出典: src/lib/services/AuditService.ts

全コレクションの beforeChange で applyAuditFields() を呼び出し:

• create: createdBy = req.user.id, updatedBy = req.user.id
• update: updatedBy = req.user.id

5.3 タイムスタンプ

全コレクション: timestamps: true → Payload が createdAt, updatedAt を自動管理

---

6. PMS 連携 (Integration Layer)

出典: src/integrations/pms/

---

7. ERD (Entity Relationship Diagram)

出典: src/lib/erd/deriveSchema.ts — Payload コレクション定義から自動導出 API: GET /api/erd (admin 認証必須)

                 ┌──────────────────┐
                 │  staff_groups    │
                 │  (部署グループ)  │
                 │  name, slug, sort│
                 └───────┬──────────┘
                         │ slug → group (text 参照)
         ┌───────────────┼───────────────┐
         │               │               │
┌────────┴────────┐ ┌────┴──────┐ ┌──────┴──────┐
│    users        │ │ company_  │ │ custom_     │
│  (ユーザー)     │ │ settings  │ │ field_      │
│  username (UQ)  │ │ (企業設定) │ │ configs     │
│  role (RBAC)    │ │ singleton │ │ entity_type │
│  status         │ └───────────┘ │ + field_name│
│  auth (Payload) │               │ = UQ        │
└────────┬────────┘               └─────────────┘
         │ FK: salesRep, createdBy, updatedBy
         │
┌────────┴──────────────────────────────────────┐
│  ┌──────────┐  1:N  ┌──────────┐              │
│  │ accounts │───────│ contacts │              │
│  │ (取引先) │       │ (担当者) │              │
│  │ name (IX)│       │ name (IX)│              │
│  │ coords   │       │ account  │              │
│  │ (point)  │       │ (FK, IX) │              │
│  └────┬─────┘       └────┬─────┘              │
│       │ 1:N              │ N:1                │
│  ┌────┴─────┐            │      ┌──────────┐  │
│  │  deals   │──N:1───────┘      │  files   │  │
│  │  (案件)  │                   │ (ファイル) │  │
│  │ dealType │                   │ fileType  │  │
│  │ status   │                   │ fileSource│  │
│  │ (IX)     │                   │ → account │  │
│  │ amount   │                   │ → contact │  │
│  │ probab.  │                   │ → deal    │  │
│  └────┬─────┘                   └──────────┘  │
│       │ 1:N                                   │
│  ┌────┴──────────┐    ┌───────────────┐       │
│  │  activities   │    │ daily_reports  │       │
│  │  (活動)       │    │ (日報)         │       │
│  │ activityType  │    │ user (FK,IX)   │       │
│  │ subject (IX)  │    │ reportDate(IX) │       │
│  │ actDate (IX)  │    │ user+date = UQ │       │
│  │ account(FK,IX)│    │ dealSummaries[]│       │
│  │ contact (FK)  │    │ → deals        │       │
│  │ deal (FK)     │    │ actSummaries[] │       │
│  └───────────────┘    │ → activities   │       │
│                       └───────────────┘       │
└───────────────────────────────────────────────┘

---

8. TransLead ベンチマーク差分

TransLead CRM にあって本実装にない機能。DDD 仕様化済みの機能と未着手の拡張候補を区分する。

DDD 仕様化済み (Phase 2 で DDD に昇格)

DDD 仕様化済み (Phase 5 で DDD に昇格)

未着手の拡張候補