> ## Documentation Index
> Fetch the complete documentation index at: https://docs.core.sprocket.bz/llms.txt
> Use this file to discover all available pages before exploring further.

# ヘルプ（データ設計の型）

> 管理画面のヘルプメニューから開ける「データ設計の型」の解説ページの構成と要点を説明します。

> この記事は Spumote のソースコードから生成した試験出力です。内容は確認中のため、正式な仕様は担当者に確認してください。

## この機能でできること

管理画面の中に、Spumote の使い方の「型」（おすすめの設計の進め方）をまとめた解説ページが用意されています。

* **データ設計の型**: お客様のデータを、データ基盤（BigQuery）の中にどう積み上げるか。データの段階（レイヤ）、分類の仕方、個人情報の分け方、名前の付け方。

このページでは、図のノード（四角）をクリックすると、そのテーブルの定義とサンプルが表示されます。各章の内容は「コピー」ボタンでテキストとしてコピーでき、「全体をコピー」でページ全体をコピーできます。社内の資料作りや、AI アシスタントに前提を伝えるときに便利です。

## 画面の場所

トップバーの「ヘルプ」メニュー › データ設計の型

ヘルプは β（ベータ）版の機能として提供されています。

## データ設計の型

### ページの構成

| 章 | 内容 |
| - | - |
| 1. 全体図 — お客様のデータはこう流れる | 元データから出力までの流れを 1 枚の図で示します。 |
| 2. レイヤーの議論（L0 / L1 / L2 / L3） | データの 4 つの段階 |
| 3. L1 の中身（PERM 分類） | データを 4 種類に分ける考え方 |
| 4. どう分類するか（判定フロー） | 4 種類のどれに当たるかを決める質問の順番。「4-1. 迷いやすいテーブルの判定」付き |
| 5. L2 の中身（標準中間テーブル ①〜⑤） | 中核となる 5 つの集計テーブル |
| 6. 機密分離（gnrl / scrt） | 個人情報を閉じ込める仕組み |
| 7. 具体例 — 顧客テーブルの一生 | 1 つの顧客テーブルが各段階でどう姿を変えるか |
| 8. 命名規約 | データセットとテーブルの名前の付け方 |

### 要点

**データの 4 つの段階（レイヤ）**

| レイヤ | 呼び名 | 意味 |
| - | - | - |
| L0 | 未加工 | 元データの写し。加工しません。 |
| L1 | PERM 分類 | 元データの言葉を、共通の言葉に翻訳した段階。集計はしません。 |
| L2 | 標準中間テーブル | 中核。L1 を集計・統合したテーブル（①〜⑤）。 |
| L3 | 出力テーブル群 | 外に出す段階。連携先ごとの出力テーブル。 |

**PERM 分類（L1 の 4 種類）**

| 記号 | 種類 | 例 |
| - | - | - |
| P | Profile（顧客プロフィール）＝「どういう人か」 | EC 会員マスタ |
| E | Event（行動イベント）＝「何をしたか」 | 注文、ページ閲覧、メール配信ログ |
| R | Relation（ID 対応）＝ID と ID の対応表 | 会員 ID と LINE の紐付け |
| M | Master（業務マスタ） | 商品マスタ、店舗マスタ |

判定は上から順に「Q1. いつ起きた？と聞けるか（→ E）」「Q2. 統合・追跡する主語か（→ P）」「Q3. ID と ID だけの構造か（→ R）」「Q4. 残り全部（→ M）」と質問します。

**L2 の標準中間テーブル**

① 顧客イベントテーブル（全イベントを時系列に並べたもの）、② 顧客静的ステータステーブル（1 人 1 行の「今の姿」。日次更新）、③ 顧客動的ステータステーブル（カートやメール開封など 1 日未満で変わる状態）、④ 顧客静的ステータス変更テーブル（ランク変更などの「変化」）、⑤ マスターテーブル（商品・店舗などを連携日ごとに版管理）。

**機密分離**

| 区分 | 意味 |
| - | - |
| gnrl（一般領域） | 分析はここで完結します。生の個人情報は置きません。 |
| 非武装地帯 | 機密領域の中にある、個人情報を取り除いたテーブル。一般領域から参照できます。 |
| scrt（機密領域） | 生の個人情報を閉じ込める領域。機密レベル「機密」のロールだけが見られます。 |

メールアドレスを決まった方法でハッシュ化（元に戻せない値に変換）して両方の領域で共有することで、個人情報を機密領域に閉じ込めたまま、一般領域のデータと結び付けられます。

## 活用例

* **新任担当者の研修資料に使う**: 「全体をコピー」でページ全体をテキストにして、社内の研修資料のたたき台にします。
* **データ担当者との打ち合わせの共通言語にする**: 「このテーブルは PERM のどれか」「L2 の②に入れる属性はどれか」と、ページの用語で会話すると認識がずれにくくなります。

## 注意点・制限

* 解説ページは読み物で、ここから設定を変更することはできません。
* 内容は Spumote で推奨している設計の「型」です。お客様ごとの実際の構成は、担当者と相談して決めてください。
* 表に出てくるテーブル名・列名は例です。お使いの組織のデータとは異なる場合があります。
* ヘルプメニューの表示も、組織ごとの機能の表示設定に従います。

## 関連ページ

* [00 はじめに：Spumoteの全体像と画面構成](/getting-started/overview)
* [01-2 組織と利用者・権限](/common/organization-and-roles)
* 自動処理（ワークフロー）の各記事


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.