knowledge(축C): 확장 코드 체계 확정 — AX·AR 난수 8자리, 층 글자 유지

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0154EMdwPYNPuKc9eZv8SLEX
2026-09-13 14:32:02 +09:00
parent 8edeb4888d
commit 4deffb9316
1 changed files with 53 additions and 9 deletions
@@ -67,19 +67,64 @@ FP-<절>-<절>-<절>        예) FP-04-02-02 (벌목, 5m 미만)
 - 부모·잎이 있음 — `FP-09-15` 는 부모이고 잎이 답구간·답외구간임.
  **부모 코드에 수량을 붙이지 말 것**

-### 자체 확장 코드 — 접두를 갈라 둘 것
+### ⭐ 코드 체계 — 브레인 확정 (2026-09-13, 사용자 지시)

-품셈에 없는 공종의 자리. **품셈 코드와 한 눈에 갈려야** 함.
+**새로 만들지 않았음. 이미 도는 규약에 한 칸을 더한 것임.**
+
+#### ① 층 글자 — 이미 코드에 살아 있음. 바꾸지 말 것

 ```
-AX-<갈래>-<번호>
-  AX-ST-*   구조물 일위대가 (라이브러리가 낳는 것)
-  AX-GS-*   관급자재
-  AX-ET-*   품셈에 없는 공종 (첫 사례: 지장목제거)
+S-<기계코드>              중기 취득가(천원)
+X-<기계코드>              시간당 중기사용료      · X-<코드>#조합 = 기계 조합
+B-<공종코드>[#<갈래>]      일위대가               예) B-FP-12-01-01#철근구조물
+D-<공종코드>              단가산출               B- 를 D- 로 갈아 끼움
+W-<…>                    일식·견적
 ```

-⚠ **접두를 정하는 것은 랩탑 메인 몫이나, 정하면 이 문서에 적고 브레인에게 알릴 것.**
-두 창이 다른 접두를 쓰면 나중에 통째로 뜯어야 함.
+#### ② 공종 축 코드 — 층 글자 **뒤**에 오는 자리
+
+```
+FP-<절>-<절>-…           품셈 절번호 (정본, 두 자리 zfill)   예) FP-04-02-02
+AX-<갈래>-<8자리 16진>    우리가 더한 공종
+
+   갈래 ST   구조물 일위대가 — 라이브러리가 낳는 것
+   갈래 WK   품셈에 없는 공종 — 첫 사례 지장목제거
+```
+
+예) `B-AX-ST-3f9a2b17` = 어느 구조물 양식이 낳은 일위대가 한 벌
+
+#### ③ 자원 축 코드
+
+```
+<숫자>                   카탈로그 코드 (정본)    예) 1037 보통인부
+AR-<종류>-<8자리 16진>    카탈로그에 없는 자원
+
+   종류 M 자재 · L 노임 · X 중기   ← PriceKind 글자 그대로. 새 낱말 안 만듦
+```
+
+지금 못 맞춘 497줄(`보통휘발유(주연료)` 등)이 여기로 들어감.
+⚠ **단가는 없어도 됨** — 이름·코드만 서면 축은 이어짐.
+
+#### ④ 지킬 것 다섯
+
+1. **관급은 코드가 아님** — 자재 줄의 **칸**임
+   (`material_supply` = `owner_supplied`·`contractor_supplied`·`unknown`, 관급 줄엔 `install_by` 가 더 붙음).
+   ⇒ 관급용 접두는 **만들지 않음**
+2. **번호는 난수 8자리 소문자 16진.** 발급자를 두지 않음 —
+   3단 라이브러리(프로그램·회사·개인)와 창끼리 공유에서도 안 부딪힘.
+   만들 때 자기 범위 안 중복만 볼 것
+3. **코드는 동등 비교만.** 사전순 정렬·계층 해석 **금지** —
+   `AX`·`AR` 에는 부모·잎이 없음(`FP` 만 있음). 표시 차례는 공종 계층에서 옴
+4. **층 글자는 맨 앞에만** — `B-AX-ST-3f9a2b17` ⭕ · `AX-B-ST-…` ❌
+5. **`#갈래` 는 기존 규약 그대로.** 새 구분자를 만들지 말 것
+
+#### ⑤ 왜 이 모양인가
+
+- `FP` 는 `CODE_PREFIX = "FP"` 로 이미 박혀 있고 `B-FP-12-01-01#철근구조물` 이 실제로 돎.
+  **거기에 `AX` 한 칸만 나란히 세우면 층 글자 로직을 한 줄도 안 고쳐도 됨**
+- 난수를 쓰는 까닭 — 회사·개인 라이브러리가 서로 모르는 채 항목을 만들고 **공유까지 함**.
+  일련번호를 쓰면 공유하는 순간 부딪힘
+- 읽기는 **이름 칸**이 맡음. 코드는 식별자일 뿐임

 ---

@@ -209,7 +254,6 @@ AX-<갈래>-<번호>

 ## 9. 아직 안 정한 것

- 자체 확장 코드 **접두** — 랩탑 메인이 정해 이 문서에 적을 것
 - 일위대가 **재귀 깊이 한도** — 사용자 답 대기
 - **옆도랑파기 갈래 수**(우리 둘 ↔ 실무 셋) · **노면고르기 ↔ 노면다짐** — 사용자 답 대기
 - **`undetermined` 75표** 판정 — 사람이 봐야 함. 값을 쓰면 뒤집힌 채 들어감