🕊️ KAIA SITE PDF
REFILL EXPANSION — CONSTRUCTION PROCEDURE
PURPOSE
Kaia Site PDF の既存Refill構造を使って、
REAL Refill と対応する DUMMY Refill を増設するための
施工手順書。
この文書は、将来KaiaがCURRENT PDF SOURCEを受領して
増設工事へ着工するときに使用する。
==================================================
0. CORE RULE
==================================================
新しいRefill方式を設計しない。
CURRENT SOURCEに存在する、
Product Refill possession
↓
REAL Refill issuance
↓
DUMMY twin issuance
という既存構造をそのまま延長する。
REALとDUMMYを個別に手作業で増設しない。
==================================================
1. BEFORE CONSTRUCTION
==================================================
必ず、施工対象として渡された
CURRENT PDF ZIPそのものを確認する。
過去版の数値をそのまま信用しない。
確認するもの：
– plugin identity / version
– DEVELOPMENT-HISTORY.md
– CURRENT Refill possession authority
– REFILL_NAMESPACE_SPAN
– sheets() 相当のRefill生成処理
– default_sheet()
– issue_dummy_sheet()
– issue_dummy_design()
既存のREAL / DUMMY対応規則が
CURRENTでも維持されていることを確認する。
==================================================
2. CURRENT KNOWN-GOOD REFERENCE
==================================================
確認済み基準：
Kaia-Site-PDF
v0.3.24-JPG-CARGO-STORAGE-KEY-SHELF
この版では：
INITIAL_PRODUCT_REFILL_POSSESSION = 10
REFILL_NAMESPACE_SPAN = 30
したがって現在の初期構造は：
REAL
01–10
DUMMY
31–40
対応：
DUMMY ID
=
REAL ID + REFILL_NAMESPACE_SPAN
例：
REAL 01 → DUMMY 31
REAL 02 → DUMMY 32
…
REAL 10 → DUMMY 40
==================================================
3. REAL REFILL ISSUANCE
==================================================
CURRENT SOURCEでは sheets() が
Product Refill possession 数を基準に
必要なREAL Refillを揃える。
存在しないREAL Refillについて：
default_sheet(id)
を使用して既存形式のSheetを発行する。
したがって増設時は、
REALを一枚ずつ別方式で追加
してはならない。
既存のProduct possession authorityを延長し、
既存 sheets() が不足分を発行する構造を維持する。
==================================================
4. DUMMY TWIN ISSUANCE
==================================================
各REALには既存規則によるDUMMY twinがある。
CURRENT SOURCEでは：
issue_dummy_sheet(real_id, real_design)
↓
issue_dummy_design(real_design)
を使用してDUMMYを生成する。
DUMMYはREALの単純コピーではない。
既存DUMMY生成家具が、
– orientation
– background
– frame state
– creator credit
– reposting
– image state
– Token
– Text
等についてDUMMY用の状態を生成する。
したがって：
REALを作る
↓
REALをコピーしてDUMMY化
は禁止。
必ず既存：
issue_dummy_sheet()
issue_dummy_design()
の系統を維持する。
==================================================
5. EXPANSION CALCULATION
==================================================
例：
CURRENT REAL possession:
10
Human order:
+10 REAL Refills
施工後のREAL範囲：
01–20
REFILL_NAMESPACE_SPAN が
CURRENTでも30であることを確認できた場合、
対応DUMMY：
31–50
となる。
IMPORTANT:
これは施工前の計算例。
CURRENT SOURCEで
REFILL_NAMESPACE_SPAN = 30
が確認できない場合は、この番号を使用しない。
==================================================
6. COLLISION CHECK BEFORE BUILD
==================================================
増設予定REALとDUMMYについて、
既存namespaceとの衝突を確認する。
特に：
REAL maximum
<
first DUMMY ID
が維持されること。
例：
REAL 01–20
DUMMY 31–50
ならREAL/DUMMY namespaceは分離している。
しかし将来REAL possessionが30以上へ到達する場合、
REAL 31
↔
DUMMY 31
の衝突が発生し得る。
その場合：
🔴 STOP
REFILL_NAMESPACE_SPANを勝手に変更しない。
DUMMY番号体系を勝手に変更しない。
Humanへnamespace boundaryを返す。
==================================================
7. NARROW CONSTRUCTION
==================================================
安全確認後、
CURRENT known-good ZIP
↓
new numbered child
↓
Product Refill possession authorityのみ
必要な数量へ延長
既存の：
– sheets()
– default_sheet()
– issue_dummy_sheet()
– issue_dummy_design()
– REAL/DUMMY relationship
– Public runtime
– JPG path
– Board
– Common Routing
– Mini Printer
– cargo transport
は、増設に必要でない限り変更しない。
==================================================
8. DEVELOPMENT HISTORY
==================================================
新しいdevelopment childには
rootに exactly one:
DEVELOPMENT-HISTORY.md
を維持する。
記録する：
– parent identity
– parent SHA256
– child identity
– expansion purpose
– REAL possession before
– REAL possession after
– DUMMY range before
– DUMMY range after
– preserved REFILL_NAMESPACE_SPAN
– modified SOURCE location
– untouched boundaries
– static check result
– runtime status
Historyは証拠。
Runtime authority / Product authorityにはしない。
==================================================
9. STATIC INSPECTION
==================================================
施工後、最低限確認：
1.
PHP syntax PASS
2.
Product possession が注文数になっている
3.
REAL expected range が生成対象になる
4.
対応DUMMY expected range が
既存式：
real_id + REFILL_NAMESPACE_SPAN
で生成対象になる
5.
REAL generation still uses:
default_sheet()
6.
DUMMY generation still uses:
issue_dummy_sheet()
↓
issue_dummy_design()
7.
既存Refillデータを不用意に上書きする変更がない
8.
JPG / Board / Routing等に
無関係な変更がない
==================================================
10. RUNTIME QA
==================================================
STATIC PASSだけで完成扱いしない。
WordPressへdevelopment childを導入後、
Human runtime確認。
確認：
– REAL dropdown / selector に増設分が存在する
– 既存REALも残っている
– 新規REALを選択できる
– 新規REALが既存Sheetとして正常に扱える
– 対応DUMMYが存在する
– REALとDUMMYが取り違えられていない
– 既存Refillが壊れていない
JPG issuanceを使用するProduct runtimeなら、
代表的な新規Refillについて
既存JPG経路が継続することも確認する。
==================================================
11. STOP CONDITIONS
==================================================
以下を発見した瞬間STOP：
– CURRENT SOURCEがこの手順書と異なる
– possession authorityが別家具へ移っている
– REAL/DUMMY対応式が変わっている
– DUMMYが既存issue_dummy_*経路で作れない
– namespace collision
– 増設にBoard変更が必要に見える
– Common Routing変更が必要に見える
– Mini Printer変更が必要に見える
– JPG変更が必要に見える
– 既存Refill migrationが必要に見える
– working skeletonの変更が必要に見える
– 「あれ？」
– 「うわぁ……」
STOP時：
原因調査・修理・再設計まで進まない。
観測事実と停止位置だけHumanへ返す。
==================================================
12. DO NOT
==================================================
DO NOT:
– 古い版を施工親にする
– REALを手作業で大量追加する
– DUMMYをREALコピーで作る
– DUMMY namespaceを勝手に移動する
– REFILL_NAMESPACE_SPANを勝手に変更する
– unrelated furnitureを整理する
– legacy furnitureをついでに削除する
– Board / Routing / JPGをついでに改修する
– failed childをrepair baseにする
– runtime未確認を完成扱いする
==================================================
13. CONSTRUCTION SUMMARY
==================================================
CURRENT PDFを受領
↓
Refill authority確認
↓
REAL/DUMMY既存生成家具確認
↓
Human注文数を確認
↓
namespace collision確認
↓
known-good parentからchild作成
↓
Product possessionを必要数へ延長
↓
既存 sheets() にREALを発行させる
↓
既存 issue_dummy_* にDUMMY twinを発行させる
↓
STATIC QA
↓
Human Runtime QA
↓
PASSなら完成
==================================================
KNOWN REFERENCE ONLY
==================================================
v0.3.24 observed:
REAL possession = 10
REAL = 01–10
REFILL_NAMESPACE_SPAN = 30
DUMMY = 31–40
This is reference evidence,
NOT permission to assume future CURRENT SOURCE is identical.
No comments yet.