保管場所一覧 (Storage Locations List)作成ルール
業務で管理する物理的・論理的な保管場所を一覧で定義します。各保管場所の主な保管対象・目的・関連プロセス・管理頻度などを明記し、在庫や現金などの流れ・管理単位を明確にします。
1. メタデータ
| 項目 | 説明 | 必須 |
|---|---|---|
| id | 保管場所一覧ID (sll-xxx-xxxx) | ○ |
| type | domain 固定 | ○ |
| title | 保管場所一覧名 | ○ |
| status | draft/ready/deprecated | ○ |
| supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
1.1 ID規約
- 保管場所一覧IDは正規表現
^sll-[a-z0-9-]+$に合致する一意IDを用いる。 type: domainは業務ドメイン仕様であることを示す。
2. 記述ルール
- 保管場所の一覧を 表形式 で整理する。
- 保管場所名は 日本語単数形 を使用する(例:レジ、金庫、売り場棚)。
- 内容を曖昧な記述にせず、簡潔かつ明確に記載する。
- 仕様間(BDD/CDSL/CCD/glossary)で名称の整合性を保つ。
2.1 標準列の定義
| 列名 | 説明 |
|---|---|
| 保管場所 | 場所の論理名(日本語単数形) |
| 主な保管対象 | 主に保管する対象(商品在庫、現金など) |
| 主な内容・目的 | 管理目的や作業内容(名詞句中心で簡潔に) |
| 関連プロセス | 関連する業務領域(例:調達、販売、会計)※複数の場合は「、」区切り |
| 管理頻度 | 更新・確認の頻度(例:日次、随時、納品時・補充時) |
※ 列順は 保管場所 → 主な保管対象 → 主な内容・目的 → 関連プロセス → 管理頻度 に統一する。
3. サンプル
3.1 メタデータ(front-matter YAML)
yaml
---
id: sll-main
type: domain
title: 保管場所一覧(main)
status: draft
supersedes: []
---3.2 保管場所一覧(表)
| 保管場所 | 主な保管対象 | 主な内容・目的 | 関連プロセス | 管理頻度 |
|---|---|---|---|---|
| バックヤード | 商品在庫(未陳列)、段ボール、予備棚 | 納品された商品を保管し、数量と賞味期限を管理。補充元として機能。 | 調達、販売 | 納品時・補充時 |
| 売り場棚 | 販売中の商品 | お客様が手に取る商品を配置、価格表示、補充、前出しを行う。 | 販売 | 開店前・営業中 |
| レジ | 現金、レジ記録 | 日次の売上金を管理し、入出金記録を保持。 | 会計 | 日次 |
| 金庫 | 日次売上金 | 売上金を安全に保管し、必要に応じて出金。 | 会計 | 日次 |
| 銀行口座 | 事業用銀行口座 | 仕入先や経費の支払い、売上金の入金を管理。 | 会計 | 随時 |
4. 生成 AI への指示テンプレート
生成 AI に保管場所一覧(SLL)を作らせるときは、以下のような指示を与えます。
以下のルールに従って、保管場所一覧(Storage Locations List: SLL) を 1 ファイル作成してください。出力は Markdown とします。
対象は「一覧(表)」です。物理設計(倉庫レイアウト、棚番号体系、DB設計など)や実装設計は書かず、業務としての保管場所の整理に集中してください。
禁止: 物理テーブル名・物理カラム名・SQL全文、実装クラス/関数名、APIの内部実装詳細、クリック手順など UI 操作の逐語列挙
先頭に YAML Frontmatter を付与し、以下の形式で記述してください(不要な項目は省略可だが、
id/type/title/statusは必須):yaml--- id: sll-<英小文字とハイフンで構成したID> # 例: sll-main type: domain title: <保管場所一覧名> # 例: 保管場所一覧(main) status: draft # draft / ready / deprecated のいずれか supersedes: [] ---一覧表は次の列を この順序 で必ず含めてください:
保管場所 / 主な保管対象 / 主な内容・目的 / 関連プロセス / 管理頻度
「保管場所」は 日本語の単数形 とし、略語や実装名のような名称は避けてください。
「関連プロセス」は、調達/販売/会計などの業務領域を必要に応じて複数指定してください(複数の場合は「、」区切り)。
「管理頻度」は、更新・確認の頻度が分かるように記述してください(例: 日次、随時、納品時・補充時)。
仕様間(BDD/CDSL/CCD/用語集)と用語の整合性を保ってください。