# GMOサイン 機能仕様書（詳細設計レベル）— Monaka 対応表

**正本**: ユーザー提供の MANUS 整理稿（本ファイル §1〜3）。Monaka の実装状態は `docs/contract-spec.md` と同期する。

---

## 1. 契約書一覧（文書管理）

契約書一覧は、送受信した文書の管理・検索・追跡の中心機能。

### 1.1 データ項目

| 項目 | Monaka カラム / 画面 |
|------|----------------------|
| 文書管理番号 | `contract_documents.document_number`（自動採番） |
| 文書名 | `title` |
| 文書ファイル名 | `file_name` |
| 署名ステータス | `status`（§1.2） |
| 相手方 | `counterparty` |
| 契約／取引日 | `contract_date` |
| 契約満了日 | `contract_expires_at` |
| 契約／取引金額 | `amount` + `amount_currency` |
| 保管場所 | `storage_location` |
| 備考1〜3 | `note1`〜`note3` |
| カスタムフィールド（最大5） | `custom_field_1`〜`custom_field_5` |
| 自動更新 | `auto_renewal` |
| 更新期間 | `renewal_period_months` |
| 解約通知期限 | `cancellation_notice_at` |
| 文書登録日時 | `created_at` |
| 署名完了日時 | `completed_at` |

### 1.2 ステータス

| GMO | Monaka `status` | 備考 |
|-----|-----------------|------|
| 承認待ち | `pending_approval` | ワークフロー未接続・手動遷移可 |
| 自社署名待ち | `pending_self_sign` | |
| 送信先署名待ち | `pending_counterparty_sign` | |
| 署名完了 | `completed` | |
| 期限切れ | `expired` | 期限バッチは後続 |
| 辞退 | `declined` | |
| 取消 | `cancelled` | |
| （下書き） | `draft` | 送付前。Monaka 拡張 |

### 1.3 検索

- フリーワード: 文書管理番号（完全一致）、文書名・相手方・保管場所・備考（部分一致）
- 絞り込み: ステータス、契約日・満了日・登録日の範囲、金額範囲、AND/OR 切替（キーワード系）

### 1.4 CSV

- UTF-8（BOM付き）、1回最大 500 件（`config/putage.php` の `contract_document_csv_max_rows`）

---

## 2. テンプレート

### 2.1 構造（3レイヤー）

| レイヤー | Monaka |
|----------|--------|
| 文書（PDF） | `contract_template_documents` + PDF アップロード |
| 役割（ロール） | `contract_template_signers` / `recipients` |
| コンポーネント | `contract_template_components`（座標配置 UI は未実装・メタデータのみ） |

### 2.2 パーツ

`contract_template_components`: `part_type`（seal|text|checkbox|date）、必須・入力ガイド・data_id・日付書式等を JSON `settings` に保持。

### 2.3 差込み項目

`contract_template_merge_fields`: `field_type`、`input_guide`、`data_id`、`default_value`。

### 2.4 管理

| 機能 | Monaka |
|------|--------|
| 設定固定 | `allow_content_change_on_send`（既存） |
| 複製 | `POST contract.templates.duplicate` |
| 利用範囲（グループ） | 未実装（オペレーター権限で代替） |

---

## 3. API 連携

未実装。`contract_user_settings` 等の拡張で API キー保管は後続。

---

## References

仕様書末尾の GMOサイン ヘルプセンター等の URL を参照（外部一次情報）。