wip(M01): 자재 조합 M01 길 초안 — 합치기 전 임시(sub4 자재조합 표 위에 얹을 예정)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RoyUwuTFiDJfvCfHpvKKzp
2026-09-28 19:00:53 +09:00
parent 0fb69c053b
commit 1904cd5072
5 changed files with 296 additions and 3 deletions
@@ -196,6 +196,22 @@
  - 못 도는 줄은 통째로 멈추지 않고 그 줄만 `ok` false · `까닭` · `멈춤` 에 한 줄 — 나머지 줄의 합계는 그대로 냄.
 - 답 — 200 · 400(틀린 몸 · 이름 없음 · 모르는 소유) · 404(없는 키) · 409(낡은 판본) · 422 `{detail: {errors: […]}}`(검사 걸림 — 없는 로직 키 · 같은 로직 두 번 · 빈 조합 · 조합을 담음).

+### 자재 조합
+
+재료산출에서 쓸 **자재 목록 묶음**(파일 `자재조합.json` · 키 `UM` · `_틀.md` 11장). 담은 자재 `{코드, 이름, 규격, 단위}` 만 지님 — 수량 · 단가 없음. 요소 그룹이 아님(`/groups` · `/rows` 에 안 끼고 제 길로만).
+
+| 길                    | 받음                            | 줌                                          |
+| --------------------- | ------------------------------- | ------------------------------------------- |
+| `GET /matsets`        | `q?` `owner?`                   | `{matsets: […]}` — 줄마다 `count` (자재 수) |
+| `GET /matset`         | `key`                           | `{file, version, matset}`                   |
+| `POST /matset/new`    | `{matset, owner?}`              | `{file, version, key, matset}`              |
+| `POST /matset/edit`   | `{key, version, matset, owner?}` | `{file, version, matset}`                   |
+| `POST /matset/delete` | `{key, version}`                | `{file, version}`                           |
+
+- 답 — 200 · 400(이름 없음 · 모르는 소유 · 없는/자기 본뜬키) · 404 · 409(낡은 판본 · 지우기 막음) · 422(없는 자재 코드 · 같은 자재 두 번 · 자재 줄 모양).
+- 지우기는 구조물집계표 · `구조물집계표조합` 의 「자재조합」 칸으로 쓰는 열이 있으면 409 `{detail: {errors: […], users: [구조물 이름…]}}` — 지우지 않음.
+- M02 화면이 새로 만드는 조합도 같은 파일 · 같은 길이라 M01 목록에 같이 보임.
+
 ## 10. 재료 · 기계 고르기

 재료 줄은 키 대신 기본 검색어로 품목을 찾음 — 파일 모양 · 찾기 규칙 · 자동값 차례 · 단위 환산은 `_틀.md` 7장.