PNCAD 3D 부속(EP·휠라·걸레받이 등) 배치 — 1차·2차 설계·계약 (design-ep3d)

🆕 [코디] 26.10.16(금) KST 2차 설계·계약 = §13(질문 → 결정 표) · §14~§27(§14 = 한 장 요약 · §24 = 런 분할). 1차 절(§0~§12)은 운영 반영된 계약 그대로다.

[코디] 26.10.16(목) KST · R1 설계·계약 런(코드 수정·배포 0). 입력 = R0 C:\dev\_work\pncad-ep3d\R0_facts.md · 그릴링 확정([페페] 「1차 질문 모두 추천대로」 Q1~Q7 + 기본값) · 코덱스 1회(§12). [페페] 목표 원문: 「도어·EP를 pncad에 포함하는 건 3D 화면으로 작업내용을 확인하려는 것. 도어는 보이는데 EP류가 안 보인다. 보이게 + 시스템 개편 구축. 큰 목표 = pncad 에서 도어·EP류·마감재·오픈장 모두 작업. 운영배포」

0. 결론 (계약 한 장)

1. 사실 근거 · R0 보정

• R0 확정표 그대로 쓴다(H1 · doors 최상위 키 · door_rows 16키 · 장 uid 없음 · scene 56 매칭 · door.html 부작용 · L161 몸통/도어 경계).
• 보정 ① R0 「door_rows 밖 키 = PATCH 400」 → 실제는 HTTP 200 + 본문 code 9999. RestResponse.fail() 은 status 를 안 바꾼다(C:\dev\pfs\common\response\rest_response.py BUG[PFS-D002] 주석). door.html api()(L155-163)·app.html apiCall()(L4713-4737)은 code !== '0000' 로 판정한다. 새 검증도 같은 관례로 낸다 — HTTP 400 으로 바꾸면 app.html 은 메시지 대신 「서버 400」만 보인다.
• 보정 ② 몸통 PUT 은 dao.update() 에서 예외가 나면 컨트롤러가 안 잡아 500 이 된다(Scene.put L160-168). 새 모양 검사 실패는 컨트롤러에서 ValueError 를 잡아 9999 로 낸다(R2).
• 엔진 부재 상자 규약(실측 C:\Users\delix\AppData\Local\Temp\claude\c--dev\daf387c8-f84c-42f5-881e-fcb5cdcffdda\scratchpad\r1_doorpos.mjs): box = {x,y,z,w,d,h} · x = 장 왼쪽 0 → 오른쪽 · y = 몸통 앞면 0 → 뒤(벽 쪽) +D · z = 장 바닥 0 → 위. 도어 = y −18~0(몸통 앞). app.html mesh(b, mat, dim)(L1753)이 이걸 three 로 옮긴다(앞 = +Z, 벽 = world Z 0 · BACK_PLANE L3391).
• 운영판 차이(origin/deploy-live vs pncad HEAD fa5d7f2): app.html 6066 vs 6728줄(rebuild·storeScene·loadScene 본문 다름 · delInsts/udUndo 없음 · 복제 = structuredClone 후 selInst+1 삽입 L4249) · schema.js 3702 vs 3876(도어 블록은 동일) · door.html·dao·controller·door_sheet 는 동일. 비교 스크립트 …\scratchpad\r1_cmp_live.py.
• 두 저장 경로는 이미 행 잠금(SELECT … FOR UPDATE) + 한 트랜잭션이다(dao.update · dao.update_doors). 새 처리도 그 안에서만 한다(코덱스 구멍 1).

2. 데이터 계약

2-1. items[].uid (장 고유 ID)

• 형식 i + 8자 [0-9a-z]. 만들기 = crypto.getRandomValues. ⛔crypto.randomUUID 금지 — 테스트·운영 주소(http)는 보안 컨텍스트가 아닐 수 있다(tooling L50 함정).
• 부여 지점(master app.html): 카탈로그 배치 L2232 · 복제 L4656(클론마다 새 uid) · 열기 loadScene L5096 · 복구(localStorage) · 안전망 = rebuild() 첫 줄 ensureItemUids(SCENE.items) — 없는 것 부여 + 같은 uid 의 두 번째부터 재발급(앞 것 유지). 복제는 언제나 원본 뒤에 끼우므로(master at = 마지막+1 · live selInst+1) 원본 uid 가 살아남는다. live 판은 안전망 훅만으로 충분하다.
• 삭제 되돌리기(L3773)는 같은 객체를 다시 끼우므로 uid 그대로 → 부속이 제자리로 돌아온다.
• 부여만으로 dirty 를 켜지 않는다(열자마자 「● 변경됨」 금지) — 다음 💾 때 같이 올라간다. 확정한 배치가 가리키는 uid 는 그 배치와 같은 PUT 으로 저장되므로 끊어질 틈이 없다.
• 장 객체를 새로 만들어 갈아 끼우는 경로는 master 에 없다(grep SCENE.items[…] = 0건 · 편집은 제자리) → 옛 판도 uid 를 그대로 돌려보낸다. R3b·R6b 가 live 판에서도 같은 grep 으로 확인한다.
• 서버는 items 를 안 본다. nestRows()(키 = 부재 속성) · spec.html digest(명시 칸) · 규격표 OV 키(배치 번호)는 uid 를 안 읽는다 → 산출 불변.

2-2. data.placements

"placements": {
  "DWU-PO-G05": {
    "ck": "20|상부휠라|2100*590*60|iv00149gm",
    "kd": "fil_top",
    "pl": [ { "u": "i3k9x2ab", "f": "T", "o": [0, 0, 0], "st": "ok" } ]
  },
  "DWU-PO-G30": {
    "ck": "20|걸레받이|152*2440|iv00149gm", "kd": "kick",
    "pl": [ { "u": "i0aa11bb", "f": "B", "len": 2250, "st": "ok" },
            { "u": "i9zz88yy", "f": "B", "len": 610, "st": "ok" },
            { "u": "i5cc33dd", "f": "B", "len": 895, "st": "ok" } ]
  }
}

2-3. 내용 키 ck (재연결 키 · JS·Python 같은 규칙)

ck(g) = div | name | dim | color - div = trim. name = 묶음 name(비면 첫 부품 name) → 공백·/·-·_·(·)·. 제거 + 소문자(「좌 E/P」→좌ep). - dim = 숫자만 뽑아 정수면 정수, 아니면 소수 그대로 → * 로 이음("2100 * 590*60.0" → 2100*590*60). - color = 그룹 color 의 / 앞 → 공백 제거 + 소문자(IV00149 GM → iv00149gm · colKey 관례와 같은 대소문자 무시). - 공용 사례표 = 아래 §2-6 JSON — R2(pytest)·R3a(node) 가 같은 내용을 각 리포에 둔다. R5 가 두 사본 해시 일치를 확인.

2-4. 품목 사전 kd (scene 56 의 12종 이름 + 다른 현장 이름 · 그룹 이름 기준, 비면 첫 부품 이름)

2-5. 상태

2-6. 공용 사례표 (R2·R3a 가 각 리포에 그대로 저장)

• pncad C:\dev\pncad\tools\fixtures\acc_cases.json · pfs C:\dev\pfs\tests_cody\fixtures\pncad_acc_cases.json

{ "ck": [
    { "g": {"div":"20","name":"좌 E/P","dim":"720*2330","color":"IV00149 GM/전면유사PP"}, "ck": "20|좌ep|720*2330|iv00149gm" },
    { "g": {"div":" 20","name":"","dim":"2100 * 590*60.0","color":"iv00149 gm","parts":[{"name":"상부휠라"}]}, "ck": "20|상부휠라|2100*590*60|iv00149gm" } ],
  "relink": [
    { "id": "same", "old": [["G05","K1"],["G06","K2"]], "new": [["G05","K1"],["G06","K2"]], "pl": ["G05"], "want": {"G05":"G05"}, "dropped": [] },
    { "id": "inplace-edit", "old": [["G05","K1"]], "new": [["G05","K1b"]], "pl": ["G05"], "want": {"G05":"G05"}, "dropped": [] },
    { "id": "shift-insert", "old": [["G05","K1"],["G06","K2"]], "new": [["G05","K0"],["G06","K1"],["G07","K2"]], "pl": ["G05","G06"], "want": {"G05":"G06","G06":"G07"}, "dropped": [] },
    { "id": "shift-delete", "old": [["G05","K5"],["G06","K6"]], "new": [["G05","K6"]], "pl": ["G05","G06"], "want": {"G06":"G05"}, "dropped": ["G05"] },
    { "id": "twin-edit", "old": [["G16","K"],["G18","K"]], "new": [["G16","Kb"],["G18","K"]], "pl": ["G16"], "want": {"G16":"G16"}, "dropped": [] },
    { "id": "twin-ambiguous", "old": [["G16","K"],["G18","K"]], "new": [["G20","K"],["G21","K"]], "pl": ["G16","G18"], "want": {}, "dropped": ["G16","G18"] },
    { "id": "deleted", "old": [["G30","K"]], "new": [], "pl": ["G30"], "want": {}, "dropped": ["G30"] },
    { "id": "orphan-rescue", "old": [], "new": [["G09","K"]], "pl": ["G01"], "plck": {"G01":"K"}, "want": {"G01":"G09"}, "dropped": [] },
    { "id": "new-prefix", "old": [["A-G01","K1"],["A-G02","K2"]], "new": [["B-G01","K1"],["B-G02","K2"]], "pl": ["A-G01","A-G02"], "want": {"A-G01":"B-G01","A-G02":"B-G02"}, "dropped": [] } ] }

(old·new = [gid, 내용키] · pl = 배치 있던 gid · want = 옛 gid → 새 gid · plck = 저장본에 없는 gid 의 배치 ck)

3. 저장 경로 · 소유

3-1. 소유표 (화면 간 덮어쓰기를 «소유 분리»로 0 으로)

3-2. PUT (dao.update) — 추가분만

# 행 잠금으로 읽은 old(저장본 data dict) 기준 · 기존 doors 보존 분기는 그대로
d = _obj(data)
if old is not None and d is not None and "placements" not in d and "placements" in old:
    d["placements"] = old["placements"]          # 모르면 유지(구버전 캐시 app.html · 배치 전 열린 탭)
if d is not None and "placements" in d:
    door_place.validate_placements(d["placements"])   # 모양만 · 실패 = ValueError → 컨트롤러 9999
data = json.dumps(d, ensure_ascii=False)          # d 를 바꿨을 때만 다시 눕힌다

• 컨트롤러 Scene.put: try: … except ValueError as e: response.fail(e) (보정 ②).

3-3. PATCH /doors 재연결 (door_place.relink) — 행 잠금 안

def relink(old_doors, new_doors, placements):
    """옛 doors → 새 doors 로 바뀔 때 배치 맵 키(gid)를 옮긴다. 반환 (새 맵, 보고)."""
    oldk = {gid: ck(g)}  # 첫 등장만 · newk 동일
    cnt_old = Counter(oldk.values()); holders_new = {K: [gid…]}   # 새 목록에서 K 를 가진 gid 들
    out, taken, rep = {}, set(), {"kept": 0, "moved": [], "edited": 0, "dropped": []}
    # 1) 그대로: 같은 gid · 같은 내용
    for gid, P in placements.items():
        if gid in oldk and gid in newk and oldk[gid] == newk[gid]: out[gid] = P; taken.add(gid); rep.kept += 1
    # 2) 내용 따라 이동: 옛 내용 K 가 옛 목록에서 유일(옛 목록에 없던 gid 는 P.ck) + 새 목록에서도 유일 + 대상이 비어 있음
    for gid in sorted(rest):
        K = oldk.get(gid) or P.get("ck")
        if (gid in oldk and cnt_old[K] != 1) or len(holders_new.get(K, [])) != 1: continue
        h = holders_new[K][0]
        if h in taken: continue
        out[h] = P; taken.add(h); rep.moved.append([gid, h])
    # 3) 제자리: gid 가 새 목록에 남아 있고 비어 있음 = 그 자리 사양 고침(ck 는 옛 값 → 화면 «사양 바뀜»)
    for gid in sorted(rest2):
        if gid in newk and gid not in taken: out[gid] = P; taken.add(gid); rep.edited += 1
    # 4) 나머지 = 버림(묶음 삭제 · 쌍둥이 모호) → 보고에 gid
    return out, rep

• 2단계가 3단계보다 먼저다: PO 를 다시 가져와 gid 가 밀려도(앞에 1줄 끼움·삭제) 내용이 1:1 이면 따라간다. 쌍둥이(같은 내용 둘)는 내용으로 못 가르므로 gid 로만(코덱스 구멍 2 「양방향 유일 1:1 만 자동」).
• 남는 위험 = «같은 gid 자리에 전혀 다른 품목이 새로 들어온» 경우 → 3단계가 붙인다 → 화면이 ck·kd 다름으로 «사양/품목 바뀜» 빨강(조용히 틀리지 않음). door.html 은 newGid 재사용 금지(§7)로 이 경우를 만들지 않는다.
• 🆕26.10.16 R5 I9e 보정 — 3단계에서 확정 때 ck 의 구분(div 첫 칸)과 그 gid 를 차지한 새 묶음 구분이 다르면 붙이지 않고 버림 + relink.why[gid] = '구분 바뀜(20→10)'(도어 div 10 이 차지하면 화면·door.html 이 부속 아닌 묶음을 걸러 조용히 사라지던 것 · '|' 없는 추상 키는 비교 안 함). 화면 방어: 도어 묶음 gid 에 붙은 배치는 orphanGids 고아 줄(«부속 아닌 묶음(도어)에 붙어 있다»). 사례표 i9e-* 3건 · pfs cd9933be · pncad f578683.
• PATCH 응답 = {scene_no, n, placements: out, relink: rep}.

3-4. GET /doors 추가

• placements = data.placements or {} · item_uids = [it.uid for it in data.items if it.uid] — door.html 배지(기준 장 존재) 용. 몸통 items 는 여전히 안 싣는다.

3-5. 동시성 · 구버전 시나리오

3-6. 응답·방송(BroadcastChannel pncad-doors)

3-7. 왜 doors 안(doors[g].uid·pl)이 아니라 placements 인가

4. 자동 제안 (acc.js suggest)

4-1. 장 기하

• 장마다 {uid, wall, x0=x, x1=x+W, z0=z, z1=z+H, D, Wd=D+(y??0) 벽면 y, F=도어 앞면 y(엔진 부재 상자 최소 y · 도어 없으면 0), rot} — F 는 expandInst 결과(앱이 이미 계산)에서 받는다.
• 회전 장(rot ≠ 0)은 run 에서 뺀다(제안 없음 · 수동 배치는 가능).
• 층: 상부 = z0 ≥ 1200 · 하부(기저) = 그 밖.
• 기둥 = 같은 벽·같은 층에서 x 범위가 50% 넘게 겹치는 장들(쌓은 장 L4 + L4-2) → x0=최소 · x1=최대 · 위 = 최대 z1 · 바닥 = 최소 z0 · 대표 = 위 장(T·F 기준) / 아래 장(B 기준).
• run = x 순으로 이웃 기둥 간격이 ±2mm 안인 최대 연속열. 부분 run = run 의 모든 연속 조각(i..j) · 폭 = x1(j) − x0(i).

4-2. 점수

4-3. 품목별 후보 생성

4-4. scene 56 기대값 (R3a 검사의 정답표 · div 20 15묶음)

5. 렌더 규약

5-1. 좌표계

• 장 기준 = 그 장의 엔진 부재 상자 규약(§1) — 템플릿이 {x,y,z,w,d,h} 를 내면 app.html 의 기존 mesh(b, mat, r.dim) + rebuild() 의 tf() 와 같은 변환(위치·회전) 그룹에 붙인다 → 장을 옮기고 돌리면 같이 간다.
• 벽 기준(w) = 가상 장 {wall, x:0, z:0, W:0, D:0} → 그룹 위치 (wallX(w), 0, 0) · y 음수 = 벽에서 방 쪽. 같은 mesh() 로 그린다.
• 기호: W·D·H = 기준 장 치수 · z0 = 기준 장 바닥 높이(바닥 = −z0) · F = 도어 앞면 y(보통 −18) · Wd = 벽면 y · t = 부품 두께 · C = 현장 Ceiling_H(없으면 벽 h) · 주 = role main · 리 = return · 플 = flange · 모든 상자에 o 를 더한다.

5-2. 품목 × 면 → 상자 (x · y · z 범위)

5-3. 색 · 층 · 표시

• 색 = (부품 color 또는 그룹 color) 의 / 앞 코드 → cmHex()·colorMat()(도어 재질 쪽). 자동색 풀은 비몸통 풀(kc) 맨 뒤에 붙인다 — 기존 도어·등판 코드의 자동 배정색이 밀리지 않게(규칙 26.10.13 「풀 판정 = 부재 역할」). 재질 교체는 cmPaint 규약(발광 중 base 교체).
• 층: 새 그룹 gAccEp(div 20 → EP 칩) · gAccDoor(div 30·40 → 도어 칩). 칩 이름 「EP·휠라·목찬넬」 유지(기본값 「부속」 칩 = 이 칩). 실사 모드는 보이는 층을 그대로 쓰되 재질 교체를 실기 확인(R3b).
• 제안 = 같은 색 35% 투명 + 점선 모서리(LineDashedMaterial · computeLineDistances) · 확정 = 불투명 + 모서리선 · 불일치 = 빨강(#d93025) 모서리 + 패널 사유 · 보관대 = 마지막 벽 오른쪽(wallX(끝)+len+WALL_GAP) 바닥에 줄 세움 + 이름표. 도어 기호(gMark)는 안 그린다.
• 피킹 = pointerdown(L3451) 앞단에서 부속 메시 먼저(userData.acc = {gid, k, sug}) → 부속 선택(장 선택과 별도 상태) · Esc 해제.

6. 화면 동작

6-1. app.html — 부속 패널(#doorList 자리 재사용)

• 머리: 「부속 15 · 확정 n · 제안 n · 모호 n · 미배치 n · 불일치 n」 + [제안 모두 확정] [확정분 저장] [표 열기].
• 줄: 품목 칩 · 제목(doorTitle) · 상태 칩 · 동작 = 확정 / 해제 / 보관 / 후보 ▸(모호) / 위치(Δx·Δy·Δz 숫자 칸 13px) / 표에서 보기(door.html#gid=).
• 보관대 부속 클릭 → 「놓을 면 클릭」 모드 → 장 면(또는 벽) 클릭 → 그 품목 템플릿·면으로 놓음(m:1).
• 규칙: 글자 ≥ 13px · 네이티브 <select>·<datalist> 금지(목록이 필요하면 droplist.js) · 오른쪽 위 64×60px 에 단추 금지(QA 헬퍼) · 모달 안 알림 = toast(text, host). web-designer 상담 권장(R3c).
• 미저장 알림: 확정·해제 = dirty → 기존 「● 변경됨」 + 패널에 「확정 n건 — 💾 저장 전」.

6-2. door.html

• 행 배지(13px): 확정 n/qty · 미배치 · 보관 · 불일치(사유 title). 계산 = acc.js groupStatus(g, entry, {itemUids})(장 바뀜 제외).
• 행 번호 클릭 → BC focus → app.html 강조. app.html 에서 「표에서 보기」 = 기존 openDoorSheet(gid).

7. door.html 부작용 수정 범위 (R4)

8. 불변식 · 검증 계획 (R5)

• 데이터: 테스트 8001 에 scene 56 덤프(C:\dev\_work\daewoo-ulsan-munjuro\after_1016c\scene_56.json)를 POST 로 사본 1개(테스트 DB 쓰기만 · 운영 쓰기 0). 기준선 = 사본을 앱으로 열어 배치 없이 💾 1회(같은 엔진 기준 맞춤). | # | 검사 | 합격 | |---|---|---| | I1 | 기준선 vs 배치 12건 확정·💾 뒤 GET /scene/<n>/doors/xlsx 전 시트 전 셀 값 | 동일 | | I2 | 두 엑셀을 orderpaper-sync/door_order_parse.py parse_poin · api/pfs/estimate/service/door_order_parse.py parse_pages 로 읽은 결과 | 동일 | | I3 | nest_rows(테스트 DB SELECT · _pncad_nest18_probe_LIVE.py 방식) | 동일 | | I4 | door_rows 컬럼(PUT 전후) | 동일 | | I5 | data 에서 items[].uid·placements 를 뺀 JSON | 동일 | | I6 | door.html 에서 치수 1칸 고쳐 저장 → placements 그대로 · 엑셀엔 고친 값만 | 통과 | | I7 | door.html 복제 → 새 gid 미배치 · 원본 배치 유지 | 통과 | | I8 | 교차 탭: door.html 수정 ↔ app.html 확정·💾 ↔ door.html 다시 저장 | 둘 다 남음 | | I9 | 외부 도구 흉내 PATCH(앞에 1묶음 끼우고 gid 재번호 · 1묶음 칼라 변경) | 내용 같은 것 이동 · 칼라 바뀐 것 미배치 · 응답 보고 일치 | | I10 | 장 삭제 → 불일치 «기준 장 없음» · 되돌리기 → 제자리 | 통과 | | I11 | 장 복제 → 새 uid · 부속은 원본에 남음 · 장 이동 → 부속 따라감 | 통과 | | I12 | 구버전 흉내: placements 없는 PUT → 저장본 유지 · {} PUT → 비움 · 모양 오류 PUT → 9999 메시지 · 몸통 미저장 | 통과 | | I13 | 회귀 | _e2e_3dui local 147/147 · _e2e_doors · _e2e_enterbest · _e2e_droplist · photo 145/145 · node schema.js 전 PASS |
• 명령: node C:\dev\pncad\tools\_test_acc.mjs · cd C:\dev\pfs && python -m pytest tests_cody/test_pncad_placements.py tests_cody/test_pncad_door_sheet.py -q · python C:\dev\pncad\tools\_e2e_acc.py [local|test|prod] [scene] · python C:\dev\_work\pncad-ep3d\inv_check.py test <사본번호> · 헤드리스 렌더는 --use-angle=d3d11 --enable-gpu --ignore-gpu-blocklist(rules 26.10.14) · 실제 주소 http://pfs-test.poin.co.kr:8001 로 검사(localhost 금지) · Playwright 끝에 닫기.
• 반박: 코덱스 1회(diff 기준 «조용한 소실·오연결» 질문).

9. 런 분할

10. 배포 절차 (R6)

1. pncad 커밋들 → diff --strip-trailing-cr 로 pfs web/pncad 쪽에만 있는 줄 확인(규칙 26.10.15) → app.html 은 git apply --directory=web/pncad --ignore-whitespace · acc.js·acc3d.js 신규 복사 · door.html·schema.js 는 pfs 판과 pncad 직전 판이 같은지 확인 후 복사. 협력사 droplist 사본은 droplist.js 를 안 건드리면 재빌드 불필요(건드리면 tools/partner_nesting/build.py).
2. pfs master 커밋(서버 + web/pncad) → push → gh run watch <id> --exit-status → _deploy_hash.py test → 사이트맵 cd C:\dev\pfs && python tools/sitemap/build_sitemap.py --dump.
3. R5 통과 + 페페 테스트 확인 → 운영은 페페 원문 「운영배포」가 있는 세션에서(채팅 승인 = broker 텔레그램 재승인 면제 · 지시문에 옮겨 적은 승인은 무효).
4. C:\dev\pfs_deploy_wt: fetch · merge --ff-only origin/deploy-live · 서버 4파일 = git checkout origin/master -- …(먼저 git log origin/deploy-live..origin/master -- <파일> 로 딸려갈 커밋 0 확인) · web: acc.js·acc3d.js·door.html(동일 기반) = master 판 · schema.js = flattenDoors 덩어리만(live 도어 블록 동일 → git apply) · app.html = mk_live_acc.py(앵커 치환 · 앵커마다 정확히 1회 assert · master 전용 참조 photoOn·phRef·hideErr·udShift·delInsts 증가 0 assert · 선례 C:\dev\_work\enex-gyeryong-1015\doors_deploy\mk_live_doors.py).
5. 로컬 E2E on 후보: PNCAD_ROOT=C:\dev\pfs_deploy_wt\web\pncad python tools/_e2e_acc.py local · _e2e_3dui.py local(기준선 141/148) → 커밋 → push 1회 → Actions → PNCAD_HASH_LOCAL=C:\dev\pfs_deploy_wt\web\pncad python tools/_deploy_hash.py prod → prod 읽기 E2E(scene 56 열어 제안 12·미배치 3·pageerror 0 · PUT 0) → _e2e_cache_reval prod → 사이트맵 재빌드(주황 걷힘 확인) → C:\dev\devplan\pfs.html PENDING/DONE → 페페 안내 Ctrl+Shift+R.
6. 되돌림 = 포워드 복원(이전 판 파일 checkout → 일반 커밋). 데이터는 덧붙은 키뿐(옛 코드는 무시·보존)이라 되돌려도 안전.

11. 위험 · 대책

12. 코덱스 검토 반영 (26.10.16 · C:\Users\delix\AppData\Local\Temp\claude\c--dev\daf387c8-f84c-42f5-881e-fcb5cdcffdda\scratchpad\r1_codex.out.txt)

코덱스 로컬 실행기가 파일을 못 읽어 «계약 문구 기준» 검토였다. | 지적 | 반영 | |---|---| | 1 서버 병합도 동시성 충돌 → 같은 행 잠근 뒤 읽기→병합→저장 | 두 경로 모두 이미 FOR UPDATE 트랜잭션 — 새 처리도 그 안에서만(§1) | | 2 fallback 오연결 → uid 있으면 uid 만 · 양방향 유일 1:1 만 자동 · 모호는 보존 · 복제 새 uid | 그룹 uid 대신 «내용 키 양방향 유일 1:1 이동 + 쌍둥이 gid» (§3-3) · 모호·삭제는 버리고 응답 보고(보존함은 2차 후보) · 장 복제 = 새 uid | | 3 구버전 PUT 이 장 uid 지움 → 계약 버전 검사·거절 | 옛 판은 모르는 키를 돌려보내므로 uid 가 안 지워짐을 코드로 확인 · 「누락=유지·{}=삭제」 채택 · 버전 거절은 안 함(옛 탭의 미저장 작업을 막는다) | | 4 응답·방송의 옛 상태 재유입 → 요청별 임시 ID·revision | 계약 B 로 그룹 uid 수신 자체를 없앰 · 배치는 작성자 하나라 역순은 표시만 · revision 은 2차 후보 | | 대안: 배치를 doors 밖 placements 로 | 채택(§3-7) |

13. 2차 질문 → ✅ 26.10.16 [페페] 결정 (아래 «1차 때 추천» 표는 기록 · 결정 표 = 바로 아래 · 본문 = §14~§27)

(기록) 1차 때 질문 표: | # | 질문 | 선택지 | 추천 · 이유 | |---|---|---|---| | Q8 | 오픈장을 어떻게 모델링할까 | ① 장 종류(몸통재 · nest_rows) ② 도어재 묶음(door_rows) ③ 장으로 모델링 + 부재별 재질(도어재 부재만 door_rows) | ③ — 칸·선반 형상은 장 엔진 재사용, 생산 경로는 재질이 정한다 | | Q9 | 장 치수가 바뀌면 붙은 부속은 | ① 자동 갱신 ② 불일치 경고만 ③ 고정 | 3D 에서 만든 것 ① · 엑셀·수동 행 ② — 사람이 정한 발주 치수를 몰래 바꾸지 않는다(1차는 전부 ②) | | Q10 | 3D 에서 새로 추가할 때 기본 치수 | ① R0 §10 역산 초안 승인(vars 연동) ② 직접 지정 | ① — 확신 낮은 항목(EP 깊이·들임)만 입력 칸 | | Q11 | 걸레받이 들임(앞면에서 얼마나 들어가나) | ① 몸통 앞면과 같음(0) ② 도어 앞면에서 N mm ③ 현장 변수 걸레받이들임 | ③(기본값은 페페가 한 번 정함) — scene 56 데이터에 근거 없음 | | Q12 | 측면 EP 깊이 기본 | ① 밑장깊이 + 60 ② run 최대 깊이 + 60 ③ 현장 변수 EP깊이 | ③(기본 = 밑장깊이+60 · 2현장 확인 후 확정) — 570+150 도 맞아 1현장으론 못 가른다 | | Q13 | scene 56 상천판 깊이 590 의 뜻 | ① 벽 쪽으로 590(지금 그림 = 벽 관통) ② 앞으로 돌출 ③ 다른 부재 | 페페 도면 확인 — 1차는 치수 그대로 그리고 «벽 관통» 표시 | | Q14 | 3D 에서 만든 부속(src=3d)을 door.html 에서 고치면 | ① 읽기 전용 ② 고칠 수 있고 고치면 src=manual | ② — 현장 수정이 막히면 안 된다 | | Q15 | 도어(div 10) 행 ↔ 3D 도어 대조 표시 | ① 불일치만 ② 전부 | ① — 확인 화면이 시끄러워지지 않게 | | Q16 | 재연결 실패 배치 보존함 · doors revision | ① 버림 + 보고(1차) ② 보존함에 두고 다시 붙이기 | ① 유지 → 운영 실측에서 버림이 잦으면 ② | | Q17 | 확정 단위 저장 | ① 💾(몸통 저장)과 같이(1차) ② 배치 전용 PATCH(nest_rows·수정시각 안 건드림) | ① — 엔진 바뀐 옛 작업본에서 nest_rows 변화가 문제되면 ②(guarded uid 스탬프 필요) |

2차 설계·계약 (26.10.16(금) KST · [코디] 설계 런 · 코드 수정·배포 0)

입력 = 1차 운영 반영(deploy-live 7e7e1dc8 · 실사 deffdb7d) · [페페] 2차 결정(§13 결정 표) · 코덱스 1회(§26-1) · furniture-expert 1회(§26-2). 코드 기준 pncad 7c95bba · pfs master cd9933be.

14. 2차 결론 (계약 한 장)

15. 2차 데이터 계약

15-1. 3D 생성 묶음 (doors 원소 · 기존 그룹 형식 그대로 + src)

{ "gid": "DWU-PO-3D01", "sec": "D", "div": "20", "join": "S", "shape": "", "name": "우E/P", "dim": "720*852", "qty": 1,
  "pos": "하부", "type": "", "color": "IV00149 GM", "back": "전면유사PP",
  "src": { "gen": "3d", "id": "g7k2m9x0a", "rv": 3, "kd": "ep" },
  "parts": [ { "pid": "1", "role": "main", "name": "우E/P", "thk": 18, "w": 720, "h": 852, "left": "", "right": "", "edge": "", "qty": 1, "remark": "", "kind": "MDF", "side": "단면", "grain": "" } ] }

15-2. 생성 기록 placements[gid].gen (앱 소유 · 💾 PUT · 서버 모양검사는 «모르는 칸 통과»라 변경 0)

"DWU-PO-3D01": { "ck": "20|우ep|720*852|iv00149gm", "kd": "ep",
  "pl": [ { "u": "i3k9x2ab", "f": "R", "st": "ok" } ],
  "gen": { "id": "g7k2m9x0a", "rule": "ep", "at": { "u": ["i3k9x2ab"], "f": "R", "lev": "low", "wall": "A" },
           "ov": { "w": null, "h": null, "color": null, "pos": null }, "sig": "우E/P|720*852|1|우E/P:18:720:852:1" } }

• rule = §16-2 규칙 이름 · at = 대상(연속 기둥의 장 uid 목록 · 면 · 높이 모드 low|up|full · 벽 · 나눔 조각이면 set·i) · ov = 입력 칸 값(null = 규칙값) · sig = 마지막으로 묶음에 반영한 «계산 결과» 요약(이름·dim·qty·부품 name:thk:w:h:qty).
• 유효 연결 = doors 에 그 gid 묶음이 있고 src.id === gen.id. 아니면 «3D 기록 끊김»(도어규격표에서 지웠을 수 있다 · 자동 갱신 안 함 · 패널 [다시 만들기]=새 gid·새 id 로 생성 / [기록 지우기]). 예외 = 오픈장(§19-4: 장이 route='door' 인 동안 묶음이 없으면 화면이 다시 만든다).
• 3D 추가는 «미리보기 → 확정» 한 번에 묶음 + 배치(st ok) + 기록을 같이 만든다 — 제안 상태로 저장되는 3D 묶음은 없다.
• 묶음을 바꿀 때마다 ck 를 같이 새로 쓴다(자동 갱신 뒤 «사양 바뀜» 오판 방지).

15-3. 💾 PUT door_ops — 서버 묶음 단위 병합 (dao.update 행 잠금·한 트랜잭션 안)

"door_ops": { "v": 1,
  "up":  [ { "g": { 묶음 }, "rows": [ door_rows 행 ], "base": 0 } ],
  "del": [ { "gid": "DWU-PO-3D02", "id": "g…", "rv": 2, "force": false } ] }

• door_ops 는 요청 본문 칸(data 밖) — 저장되지 않는다. data.doors 는 지금처럼 버린다(저장본 보존) — 3D 묶음은 door_ops 로만 들어간다.
• 저장본에 doors 키가 없을 때(옛 작업본)·POST(새 작업본) = 기존대로 들어온 doors·door_rows 통째(3D 묶음 포함 · rv 는 들어온 값) · door_ops 무시.

15-4. PATCH /doors (door.html·외부 도구 · 배열 통째) — 3D 묶음 보호 추가

• 본문 새 칸 del: [{gid, id, rv}] = door.html 이 이번 세션에 지운 3D 묶음(없으면 빈 목록 = 옛 door.html·외부 도구).
• 저장본 3D 묶음 S(gid 기준)마다:

15-5. GET /doors 추가 (R7 에 같이 넣고 ②·④ 까지 휴면)

• door3d = data.door3d or null(④ 도어 대조 배지) · route_uids = items[].route=='door' 인 uid 목록(② door.html 오픈장 배지).

15-6. 부속 현장 변수 (accgen.js ACC_VARS 한 곳 · 현장 설정 모달 「현장 변수」 아래 소제목 「부속(EP·휠라·걸레받이)」)

15-7. 그 밖 앱 소유 새 키 (서버 무검사 · PUT 통째 · 옛 화면은 Object.assign 으로 모르는 키 보존)

16. 생성 규칙 (3D 에서 새로 추가 · Q10~Q13)

16-1. 공통

• 기호 = §5-1(x 장 왼쪽 0→ · y 몸통 앞면 0 → 벽 + · z 장 바닥 0 → 위 · Wd 벽면 y · F 도어 앞면 y · z0 장 바닥 높이 · C = Ceiling_H · M = Molding · 전고 위 = C − M(scene 56 = 2390)). 기둥·run = §4-1(runsOf).
• 사양 복사: color·back·부품 kind·side = 같은 pos 의 div 10 묶음 중 최다 칼라 묶음 → 없으면 div 10 전체 최다 → 없으면 SCENE.color + 패널 「칼라 확인」. 입력으로 바꿈(gen.ov.color).
• 품명 = PO 관례(§2-4 사전 첫 이름): 좌E/P·우E/P · 좌휠라·우휠라 · 상부휠라·상천판 · 목찬넬·목찬넬(플랜지) · 걸레받이 · 벽판넬 · 하부휠라 · 천장휠라 · 마감판 · 오픈장 → 월드 변환(poin2world 큰제목·하위 품명 규칙)·견적 파서가 PO 행과 똑같이 다룬다. 비고 기본 = 빈칸(규격표 비고는 외주가 읽는다 — 내부 표식 금지 · 3D 여부는 화면 배지) · 예외 = 걸레받이 원장 비고(PO 관례).
• pos: 상부층 = 상부 · 하부층 = 하부(벽 이름에 「창」 = 창하부) · 전고·벽 기준·오픈장 = 주방 라인이면 주방 · 일반가구 라인이면 빈칸. 입력으로 바꿈.
• gid = <접두>-3D<2자리> · 접두 = 기존 gid 최다 접두(^(.*)-(?:G|3D)\d+$) → 없으면 PN<작업본 번호>(새 작업본 = PNNEW) · 번호 = doors gid · placements 키 · 세션에서 쓴 3D 번호의 최대 + 1. src.id = g+8자.
• 겹침 사전 검사: 같은 자리(같은 기준 장·면 또는 상자 부피 50% 넘게 겹침)에 이미 묶음(PO·수동·3D)이 확정·제안돼 있으면 확정 전에 「G01 좌휠라가 이미 이 자리 — [그 묶음 확정] [그래도 새로]」(이중 생산 방지 · §18-3).
• 입력 칸 = 규칙 표의 «입력» 열만(근거 약한 것) · 나머지는 계산값을 회색 글자로 보인다.

16-2. 규칙 표 (단계 ①: ep·fil_side·fil_top·chan·kick·wall_pnl·fil_low · ③: ceil_fil·side_pnl·cornice · ②: open)

16-3. 원장 2440 — 나눔·패킹·막음 (네스팅이 1220×2700 을 조용히 붙이는 길을 생성 단계에서 막는다)

• 한계: 한 판 = 짧은 변 ≤ 1220 · 긴 변 ≤ 2420(실사용 — 효산 원장 2440 · furniture-expert 「2420~2440」) · 원장 그대로 쓰는 걸레받이 부품만 2440. 불변식 = 생성 부품 긴 변 > 2440 = 0(§23 G7).
• 길이 방향(상부휠라·상천판·목찬넬+플랜지·천장휠라): 구간 폭 L > 2420 → 조각 수 k = ⌈L/2420⌉ 부터, 그 구간의 기둥 경계 조합 중 모든 조각 ≤ 2420 이고 가장 긴 조각이 가장 짧은 것 → 없으면 k+1 → 기둥 하나가 2420 넘으면 균등 분할 + 경고. 조각마다 별도 묶음(gid 각자 · gen.at.set 같은 값 · gen.at.i 순번 · 배치 u = 조각 첫 기둥). 다시 계산 때 조각 수가 바뀌면 묶음을 늘리거나 지운다(비수동만 · 수동이 섞이면 그 집합 전체 경고).
• 원장 품목(걸레받이): 조각마다 +5(재단 여유) · 2440 에 First-Fit-Decreasing(조각 사이 커프 4) → 장수 + 걸레받이여유장 = qty. scene 56 = 2255 / 900+615 → 2 + 1 = 3(PO G30 와 같음).
• 판이 1220×2440 에 안 드는 높이·폭(천장 2450 넘는 현장의 전고 EP·벽판넬 폭 1220 초과 등): 미리보기 빨강 + 확정 막음 → 사람이 고른다: [기존 선에서 이음으로 나누기 — 상판선(하부 기둥 위) / 상부장 하단선 / 세로 이음] · 9자(2700) 원장 표기 — 비고 「2700 원장」 · 18T 만 · 장당 비용 증가. 이음 = 기존 선에 숨긴다(furniture-expert 「장 경계·줄눈·선반라인 우선」).

16-4. 벽 관통 금지 = 앞 돌출 (Q13 · 일반 원칙)

• acc.js template() 끝: 기준이 장(회전 0)이고 어떤 상자든 y + d > Wd + 0.5 이면 그 배치(pl)의 모든 상자 y 를 최대 넘침만큼 앞(−y)으로 민다 — ㄴ자·ㄱ자 조립체가 깨지지 않게 통째. 반환 상자에 fwd(mm) → 3D 이름표 「앞 돌출 282」. pl.o 에는 굽지 않는다(계산값 · 장 깊이가 바뀌면 다시 계산 · 데이터 변경 0).
• 1차 §5-2 «벽 관통» 표시는 없앤다 — 이미 확정된 1차 배치(scene 56 G05·G06 상천판 590)도 같은 규칙으로 그려진다(앞 282 돌출).
• 돌출 > 100 = 패널 «확인» 표지(경고 아님 · furniture-expert: 상부장 위 280 돌출판은 한국 주방 표준 부속이 아님 → 도면 확인 권장. 페페 결정 Q13 은 그대로 따른다).
• 벽 기준 배치(w)는 이미 y ≤ 0(방 쪽) 규약 · 회전 장은 벽면이 없어 적용 안 함.

16-5. scene 56 재현표 (R8 생성 엔진 정답 · C:\dev\_work\daewoo-ulsan-munjuro\after_1016c\scene_56.json)

17. 자동 갱신(Q9) · 수동(Q14) · 삭제

• 계산 = rebuild() 끝 ACC.rebuild() 안에서 accgen.regen(scene, geoms) → 생성 기록마다 «기대 묶음·배치·sig».

18. 노출면 EP 누락 경고 · 겹침 경고 (단계 ①)

18-1. 판정 accgen.exposedSides(scene, geoms, cover, opts) → [{wall, lay, end:'s'|'e', u, f:'L'|'R', gap, need, level, by, rule}]

• 대상 = 벽·층별 run 의 첫·끝 기둥 측면(회전 장 제외). gap = 벽 시작 → 첫 기둥 x0 / 끝 기둥 x1 → 벽 len.

18-2. 겹침(이중 생산 의심) — accgen.overlaps(cover)

• 두 묶음(출처 무관)의 배치 상자가 작은 쪽 부피의 50% 넘게 겹치면 = 필수 「겹침 — G01 ↔ 3D01 이중 생산 의심」. 3D 추가 확정 전 사전 검사(§16-1)와 같은 함수.
• 같은 묶음의 조각(나눔 집합)끼리는 빼고, 도어 묶음(div 10)은 대상 아님.

19. 오픈장 (단계 ② · Q8)

19-1. 표지 · 3D

• items[i].route = 'door' = 이 장은 도어규격표로 생산(없음 = 몸통). 포인 자체 오픈장 아티클(C:\dev\pncad\data\poin-articles.json OPN_CORNER_400·OPN_BASIC_400)에 "route": "door" 기본값 → 카탈로그 배치 때 장에 복사 · 장 팝업 토글 「오픈장 — 도어규격표로 생산」(다른 장에도 켤 수 있다).
• 3D = 그대로 장 엔진(칸·선반·뒤판) · 재질 = 도어색(colorMat(hex, door)) · 몸통두께 18 강제(토글이 inst.bodyThk = 18 를 같이 켬 · 끌 때 원래 값 복원 · bodyForce 경로 재사용 — rules 26.10.2).

19-2. 몸통 쪽 제외 — 판정 한 곳 schema.js isDoorRoute(inst)

• 빼는 곳: app.html nestRows()·matUse()·규격표 bom()/renderBom·renderSum(부재 수) · spec.html digest() → 대신 「오픈장(도어규격표) n개 — 장 이름」 한 줄. 3D·이름표·치수·선택·AI 연출은 그대로.
• R13 이 allParts() 호출처를 전부 grep 해 «몸통 산출»만 거른다(목록을 보고서에 남긴다). 새 산출 경로를 만들면 이 판정을 탄다(rules 신규 줄로 남길 것).

19-3. 묶음 생성 (accgen.openGroup(inst, parts, ctx) · gen3d · src.kd 'open' · src.u = 장 uid)

• 묶음: div 40 · join D · shape 빈칸 · name 오픈장(월드 변환 KEEP_KEYWORDS = 블록 유지 · 견적 파서 제목 형식) · dim W*D*H · qty = inst.qty · pos §16-1 · 칼라 = 장 칼라(inst.color) → 없으면 도어 최다 칼라 · back·kind·side 복사.
• 부품 = 장 전개 부재(emit 부재 전부 · 앞면 없음)를 «역할·두께·치수»로 묶음: 품명 = 역할 표시명(roleLabel — 측판(좌)·측판(우)·천판·지판·고정선반·이동선반·뒤판·칸막이·좌대) · 세로판(측판·칸막이·뒤판) = w 깊이(뒤판은 폭) × h 높이 · grain 세로 · 가로판(천·지·선반·좌대) = w 폭 × h 깊이 · grain 가로 + 비고 「결 가로」(포인탭엔 결 칸이 없다 → 비고로 전달) · qty = 같은 치수 개수 · thk = 부재 두께 · 엣지 칸 = 빈칸(칸 의미 확인 전 · 도장 마감).
• 치수 = 엔진 전개값(3D 와 같은 값). furniture-expert 표준식(측판 H×D · 천·지·고정 (W−36)×(D−뒤판) · 이동 (W−38)×(D−뒤판−20))은 아티클 설계 검토용 — 엔진이 정본.
• 검사(권장): 선반 내경 ≥ 800 = 「23T 또는 전면 보강 확인」(furniture-expert).
• 자동 갱신(§17): 장 치수·칸·선반이 바뀌면 다시 묶음(비수동) · 수동이면 경고. 장 삭제 = 그 묶음 pending del(오픈장은 장이 곧 제품).

19-4. 생산 경로 정확히 하나 (코덱스 구멍 3)

• 서버(PUT·POST 병합 뒤 · door_place.check_open_route(items, doors)): ① route='door' 장마다 src.kd='open'·src.u=uid 묶음이 정확히 1개 ② open 묶음마다 그 uid 장이 있고 route='door'. 어기면 9999 · 몸통도 저장 안 함(메시지 = 장 이름·gid).
• 화면이 저장 전에 같은 검사로 맞춘다: 토글 켬 = 묶음 생성(pending up) · 끔 = pending del(수동 묶음이면 「도어규격표에서 고친 오픈장 묶음도 지운다」 확인 → force) · 장 삭제 = del force · 복제 = 새 uid → 새 묶음.
• PATCH(door.html)는 그 장이 route='door' 인 동안 open 묶음을 못 지운다(§15-4 open_kept).

19-5. 왕복·외주·네스팅 영향

• 도어규격표 엑셀 = G 「오픈장 WDH=n」 + B 부품행 → orderpaper-sync/door_order_parse.py parse_poin·api/pfs/estimate/service/door_order_parse.py parse_pages 로 그대로 읽힌다(§23 G6) · poin2world = 「오픈장」 KEEP(블록 유지) · 스티커 동기화(door_order_sync) = 일반 행.
• 몸통 네스팅: 그 장 부재만 nest_rows 에서 빠진다(§23 G5). door_rows 의 네스팅 소비처 = 0(26.10.16 재확인 — pfs 안 door_rows 사용처 = pncad dao·controller 뿐) → 도어(협력사·월드) 쪽은 도어발주서 경로로만 받는다 → 영향 = 발주서에 오픈장 블록이 생김.
• ⚠ 이미 몸통으로 저장된 오픈장 장(26.10.9 이후 OPN_ 배치본)은 토글을 켜고 💾 해야 nest_rows 에서 빠진다(저장 시점 nest_rows · rules 26.10.2) — 배포 보고에 «영향 작업본 목록»(운영 SELECT · OPN_ 참조) 첨부.

20. 마감재 판재류 (단계 ③)

• 규칙 = §16-2 ③ 줄(ceil_fil 천장휠라 · side_pnl 측면 마감판 · cornice 몰딩판). 템플릿 = acc.js fil_top(T) 틀 재사용 + panel L/R 판(§5-2 «나머지·고른 면»을 L/R 측면 판으로 굳힘).
• 천장휠라 = 상부휠라와 같은 틀이지만 대상이 «아무 기둥 위»(키큰장·붙박이장 포함) · 높이 가변(50·60 관행 · 계산값) · 리턴 = 몸통+20(제작 ≤ 400 후 현장 재단).
• 측면 마감판(덧방) = 노출 측판 위에 붙이는 18T 판(9T 선택) · 노출면 경고(§18)의 덮개로 인정.
• 몰딩판 = 정의가 근거 없음(furniture-expert: Molding 변수는 천장 몰딩 공제값이지 부재가 아니고 「몰딩판」 PO 사례 없음) → §27 Q19 답 뒤 규칙 확정. 사전 cornice(코니스·몰딩)는 1차 그대로.

21. 도어 대조(Q15) · 경첩 · 손잡이 (단계 ④)

21-1. 도어 대조 — 전부 표시 · 불일치 색

• 3D 도어 = 전개 부재 중 emit === false(도어·서랍앞판·인출망도어) · 치수 = 앞면 가로 × 세로(반올림 mm) · 층 · 경첩측(p.hinge).
• 표 도어 = div 10 묶음 부품 · 매수 = parts.qty × qty · 좌·우 칸.
• 맞춤: ① 같은 치수(±1) → 수 비교 → 일치(초록 #1e8e3e) / 수량 다름(주황 #e8710a) ② 남은 것끼리 ±5 → 치수 근접(노랑 #b88400) ③ 나머지 = 3D 에만(보라 #8e24aa) / 표에만(빨강 #d93025 · 3D 물체가 없어 패널·door.html 에만).
• 화면: 앱 = 「도어 대조」 보기 칩(켜면 도어 메시 모서리 상태색 · 강조는 색으로만) + 패널 표(치수·3D 수·표 수·상태 · 전부) · door.html = div 10 행 배지(저장 시점 data.door3d 기준 · 「💾 시점」 표기).
• data.door3d = 💾 때 앱이 갱신(§15-7) · GET /doors 가 싣는다(§15-5).
• scene 56 기대 = R18 이 픽스처로 고정(도어 12묶음 · 20매).

21-2. 경첩 방향

• 3D 정본 = 엔진 hinge(imos DOORHISIDE > CP 이름 꼬리표 > 좌 · 더블 = 짝 위치 — schema.js hingeOf) + 장별 덮어쓰기 items[i].doorOpt[pkey].hi(키 = 부재 pkey · k = CP 이름이 다르면 무시 + 고아 보고 — 라운드 own 과 같은 규약 rules 26.10.9). schema.js expand(opts.doorOpt) 가 덮는다 → gMark(대각선)·도어 대조·규격표 채우기가 같은 값을 읽는다. 새 전개 경로를 만들면 doorOpt 도 넘긴다.
• 3D: 도어 클릭 → [경첩 좌↔우] · 확인 표지(권장) = furniture-expert 관행(직각 코너 인접 = 코너 반대 · 벽 끝 = 벽 쪽 · 키큰장·냉장고 옆 = 반대)과 엔진값이 다르면 «경첩 확인»(자동 변경 없음).
• 규격표: 「좌」「우」 칸 = 경첩 방향별 매수(합 = 좌+우) → door.html 3D 로 좌·우 채우기.

21-3. 손잡이 위치

• doorOpt[pkey].hd = T(도어 위쪽) · B(아래쪽) · M(높이 ho) · -(없음) · ht = bar(기본 128) · al(포인 AL 손잡이 = 도어 전체 길이). 기본 = 하부 T · 상부 B · 키큰장 M(바닥에서 1050 — 부속 변수 손잡이높이 추가) · 찬넬 CP(noHandle)·비고 push·J/G = -.
• 3D = 도어 앞 작은 막대(gMark 층 · 칩 「도어」).
• 규격표 표기 = §27 Q20 답 뒤(추천 = 비고 관례).

22. 화면 요약 (web-designer 상담 = R9c·R14·R19 착수 전)

• 앱 부속 패널 머리: [＋ 추가] · 「노출면 n」 · 「갱신 필요 n」 · (④) 「도어 대조」 칩. 추가 = 품목 칩 → 3D 클릭(1차 «놓을 면 클릭» 모드 재사용) → 점선 미리보기 + 입력 칸 → [확정]. 줄 배지 = 「3D」·「3D·수동」·「기록 끊김」·「앞 돌출 n」.
• door.html: 묶음 배지 「3D」·「3D·수동」(고치는 순간 토스트 「3D 자동 갱신을 껐다」) · 3D 묶음 [3D 자동 갱신 다시 켜기] · 삭제 = del 목록 · 오픈장 묶음 배지 「오픈장(3D 장)」 · (④) div 10 대조 배지 · [3D 로 좌·우 채우기] · gidPrefix 정규식 -(?:G|3D)\d+$.
• 규칙: 글자 ≥ 13px · 네이티브 <select>·<datalist> 금지(목록 = droplist.js) · 오른쪽 위 64×60px 단추 금지(QA 헬퍼) · 모달 안 알림 = toast(text, host) · 3D 위 단추는 pointerdown stopPropagation(rules 26.10.8).

23. 불변식 · 검증 (G 시리즈 · 1차 I1~I13 회귀 포함)

24. 런 분할 (단계마다 운영배포 가능 · 서버는 R7 한 번)

25. 위험 · 대책 (2차)

26. 상담 반영

26-1. 코덱스 (26.10.16 · C:\Users\delix\AppData\Local\Temp\claude\c--dev\daf387c8-f84c-42f5-881e-fcb5cdcffdda\scratchpad\r2_codex.out.txt)

26-2. furniture-expert (26.10.16 · 근거 C:\dev\seedchain\projects\furniture-expert\kb\ 01·02·03·05·07)

27. 페페 질문 (서로 독립 · 지금 답하면 바로 반영 · 답 전에도 ① 진행 가능)