Merge remote-tracking branch 'origin/dev' into sub_laptop_3
# Conflicts: # resources/master_data/_화면_계약.md
This commit is contained in:
@@ -194,7 +194,7 @@
|
||||
"중간": [{ "이름": "증가율", "식": "…" }],
|
||||
"호표": [{ "종류": "인력", "요소": "LB000002", "단위": "인", "수량": "…", "비목": "노무비" }],
|
||||
"덧줄": [{ "이름": "잡재료비", "식": "노무비 * 0.05", "비목": "재료비", "출처": "…" }],
|
||||
"끝수": "원 미만 버림"
|
||||
"끝수": { "대상": "계", "자리": 0, "방법": "버림", "출처": "산림품셈 13-4-1" }
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -204,6 +204,7 @@
|
||||
- `종류` = 인력 · 재료 · 기계 · 로직(하위 로직의 결과를 단가로 씀) — 요소 키의 테이블ID 그룹과 같음.
|
||||
- `비목` = 노무비 · 재료비 · 경비. `덧줄` 식에서 비목 합을 이름으로 씀.
|
||||
- `결과단위` 가 돈이 아닌 로직(㎥/시간)은 `호표` 없이 `중간` + `결과` 식.
|
||||
- `끝수` = 묶음 `{대상, 자리, 방법, 출처?, 비고?}` — 엔진이 계산 맨 끝에 붙임. `대상` 은 `계`(비목 합 셋을 각각 끊고 계 = 그 합) · `결과`(돈 아닌 로직) · `자리` 는 소수 자리(0 = 원 미만) · `방법` 은 `버림`·`올림`·`반올림`. 글자 `끝수`(「손료 원 미만 버림(…)」)는 원문 근거를 적은 설명일 뿐 — 그 끊기는 식 안에 이미 있음.
|
||||
- `종류` 가 로직이고 `비목` 칸이 없는 호표 줄은 불러온 결과를 비목별로 나눠 얹음.
|
||||
재료 고르기 — 호표 재료 줄의 `요소` 를 키 대신 조건 묶음으로 적음:
|
||||
|
||||
|
||||
@@ -14,18 +14,20 @@
|
||||
|
||||
## 2. 읽기
|
||||
|
||||
| 길 | 받음 | 줌 |
|
||||
| --------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `GET /groups` | | `{groups: [{group, files, rows}]}` — 그룹 차례는 `_틀.md` 2장 |
|
||||
| `GET /groups/{group}/files` | | `{files: [{file, book, chapter, edition, rows, version, order}]}` — 머리 `차례` 순 |
|
||||
| `GET /subs` | `file` 또는 `group` | `{file, version, slot, subs: [{name, book, details}]}` — 인력 `구분` · 기계 `세부분류`(머리에 등록된 것) · `group`(소요량 · 계수 · 로직)은 장 파일에서 모음(구분 = 원문 + 부문 · 상세구분 = 장 · 차례대로) |
|
||||
| `GET /rows` | `file` · `page`(1) · `size`(50) · `q` · `sub` · `detail` | `{file, version, total, page, size, rows: [줄…]}` |
|
||||
| `GET /tables` | `file` 또는 `group` · `sub` · `detail` · `q` · `page`(1) · `size`(30) | `{file, version, total, page, size, tables: [{file, 키, 원문번호, 구분, 상세구분, 이름, 기준, 출처, 조건, 값칸, count}]}` — 파일을 가로지른 한 목록 |
|
||||
| `GET /table` | `file` · `key` | `{file, version, table: {표 하나 통째}}` |
|
||||
| `GET /logics` | `sub` · `detail` · `q` · `blocked`(0/1) | `{logics: [{file, 키, 원문번호, 구분, 상세구분, 이름, 결과단위, 출처, blocked, reasons}]}` — 장 차례대로 |
|
||||
| `GET /logic` | `key` | `{file, version, logic: {로직 한 줄 통째}, blocked, reasons, prices: {요소: 요약 \| null}}` |
|
||||
| `GET /elements` | `group` · `q` · `limit`(50 · 200까지) | `{total, items: [{ref, file, 원문번호, 구분, 상세구분, 이름, 규격, 단위, 값, 값칸}]}` |
|
||||
| `GET /materials` | `sub`(구분) · `detail` · `spec` · `region`(자재지역) · `limit`(50 · 200까지) | `{total, 기본, items: [{ref, 구분, 상세구분, 이름, 규격, 단위, 값, 관급}]}` — 재료 고르기 조건 안 후보 · `기본` = 시험 계산이 쓸 줄 |
|
||||
| 길 | 받음 | 줌 |
|
||||
| --------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `GET /groups` | | `{groups: [{group, files, rows}]}` — 그룹 차례는 `_틀.md` 2장 |
|
||||
| `GET /groups/{group}/files` | | `{files: [{file, book, chapter, edition, rows, version, order}]}` — 머리 `차례` 순 |
|
||||
| `GET /subs` | `file` 또는 `group` | `{file, version, slot, subs: [{name, book, details}]}` — 인력 `구분` · 기계 `세부분류`(머리에 등록된 것) · `group`(소요량 · 계수 · 로직)은 장 파일에서 모음(구분 = 원문 + 부문 · 상세구분 = 장 · 차례대로) |
|
||||
| `GET /rows` | `file` · `page`(1) · `size`(50) · `q` · `sub` · `detail` | `{file, version, total, page, size, rows: [줄…]}` |
|
||||
| `GET /tables` | `file` 또는 `group` · `sub` · `detail` · `section` · `q` · `page`(1) · `size`(30) | `{file, version, total, page, size, tables: [{file, 키, 원문번호, 구분, 상세구분, 이름, 기준, 출처, 조건, 값칸, count}]}` — 파일을 가로지른 한 목록 |
|
||||
| `GET /table` | `file` · `key` | `{file, version, table: {표 하나 통째}}` |
|
||||
| `GET /table/options` | `file` · `key` | `{file, key, 이름, 조건, 범위규칙, 값칸, count, 값: {조건 이름: [값…]}}` — 표 줄을 통째로 안 받고 조건 칸의 값만 |
|
||||
| `GET /sections` | `book`(필수) · `division` · `chapter` · `q` · `limit`(200 · 1000까지) | `{total, sections: [{book, division, chapter, chapterNo, section, title, tables, logics}]}` — 원문 절 목록 |
|
||||
| `GET /logics` | `sub` · `detail` · `q` · `blocked`(0/1) · `owner` | `{logics: [{file, 키, 원문번호, 구분, 상세구분, 이름, 결과단위, 출처, 소유, blocked, reasons}]}` — 장 차례대로 |
|
||||
| `GET /logic` | `key` | `{file, version, logic: {로직 한 줄 통째}, blocked, reasons, prices: {요소: 요약 \| null}}` |
|
||||
| `GET /elements` | `group` · `q` · `limit`(50 · 200까지) | `{total, items: [{ref, file, 원문번호, 구분, 상세구분, 이름, 규격, 단위, 값, 값칸}]}` |
|
||||
| `GET /materials` | `sub`(구분) · `detail` · `spec` · `region`(자재지역) · `limit`(50 · 200까지) | `{total, 기본, items: [{ref, 구분, 상세구분, 이름, 규격, 단위, 값, 관급}]}` — 재료 고르기 조건 안 후보 · `기본` = 시험 계산이 쓸 줄 |
|
||||
|
||||
- `rows` 는 요소·로직 파일은 `줄`, 표형 파일(소요량·계수)은 `표` 를 줄로 봄.
|
||||
- `q` = 찾기 — `키`·`원문번호`·`이름`·`옛이름` 에 든 글(대소문자 무시).
|
||||
@@ -37,6 +39,10 @@
|
||||
- `materials` = 재료 고르기 단계 — 로직 재료 줄 `요소` 가 조건 `{구분, 상세구분, 규격}` 이면 이 API 로 후보(방식 A·B·C 가 부품 `M01_MasterData_UI_Test_Pick.ts` 하나를 같이 씀 · 구분 → 상세구분 → 후보 순으로 좁힘). `값` 이 비어 있어도 후보로 둠. 옛 재료 줄(품셈재료 키)은 품셈재료 이름(없으면 이름 첫 낱말)으로 `pick?kind=price` 후보. 후보 글 = 이름 규격 · 값 있는 열 전부(물가자료 · 유통물가 …). 멈춤 까닭 `입력 「X」 없음` · `맞는 줄 0개` 는 방식 A·B·C 가 쉬운 말로 바꿔 보임(`plainReason`) · 빈 수 칸은 「값을 넣어 주세요」 안내 글.
|
||||
- 소요량·계수 표의 `용도`({공종, 대상, 로직키}) = 방식 B 원문 표 미리보기 머리에 안내 · 칸이 없으면 안 보임 · `/tables` 는 `usage` 로 `용도.대상` 거름(기계 `sub`·`detail` 은 인력과 같이 구분 → 상세구분).
|
||||
- 「새로 만들기」 모달(`M01_MasterData_UI_Logic_Wizard*.ts`) — 읽기는 기존 길만 씀: 원문 절 = `/tables`(`group` 소요량·계수 · `q` 절 번호)를 책·원문번호로 거름 · 표 조건 값 목록 = `/table` 줄에서 화면이 뽑음 · 인력 = `/pick?kind=job` · 재료 = `/pick?kind=price` 로 찾아 구분·상세구분 조건 묶음으로 넣음 · 기계 = `/elements` · 다른 로직 = `/logics?q`. 시험 계산 = `/calc` `row`+`file`(키 "") · 저장 = `/save` `add` — 파일 이름에 「자체」 가 든 로직 파일이 있어야 저장 단추가 열림.
|
||||
- `section` = 절 번호 거름 — 그 절과 그 아래 절만(`13-4` 는 `13-4` · `13-4-1` 만 · `13-40` 은 안 걸림). 「만들기」가 절을 고르면 그 절의 표만 보임.
|
||||
- `/sections` = 만들기 첫 걸음 — 원문 본문의 절 제목 줄에서 모음(`book` = 산림품셈 · 건설품셈 · `division` = 건설품셈 부문(공통 · 토목 · 건축 · 기계설비 · 유지관리) · `chapter` = 장 번호 두 자리 「13」 · `q` = 절 번호·제목 찾기). `chapter` = 「부문 NN장 장 제목」 · `chapterNo` = 「NN」 · `tables` · `logics` = 그 절(아래 절 포함)의 마스터 표·로직 수 — 0 이면 아직 안 올린 절.
|
||||
- `/table/options` = 조건 값 고르기 — `고르기` 조건은 줄에 나온 값 차례대로(중복 없음) · `범위` 조건은 `[[아래, 위]…]` · `count` = 줄 수. 표 몸을 통째로 받지 않으려는 자리에만 씀(통째는 `/table`).
|
||||
- `owner` = 로직 `소유` 거름(`공용` 정본 · `현장` 자체) · 빈 글 = 전체.
|
||||
- `pick` = 고르기 창 — `price` = `재료_자재품목.json`(값 = 값 열 다섯 가운데 낮은 값 · `관급` = 관급 값 있음) ref 키 · `job` = `인력.json` 값 있는 공표 직종(구분 「미확보」 빼고) ref 키.
|
||||
|
||||
## 3. 시험 계산
|
||||
@@ -47,6 +53,8 @@
|
||||
- 돈 아닌 로직 — `{ok: true, result, middle}`
|
||||
- 멈춤 — `{ok: false, reason}` (200). 까닭 = 엔진 글 그대로(「입력 「돌」 없음」 · 「값 없음 — 관리자가 채울 값」 …).
|
||||
- `row` 없음 = 저장된 파일로 계산 · `row` 있음 = 그 로직만 고친 줄로 바꿔(없던 로직이면 `file` 에 더해) 메모리에서 계산 — 파일에 안 씀. 요소 값은 늘 저장된 파일.
|
||||
- 저장 안 한 새 초안 = `key` "" · `row` 에 로직 한 줄 통째 · `file` 은 안 보내도 됨(서버가 메모리에만 얹음). 「만들기」 모달의 [시험 계산] 이 이 길을 씀 — 키를 미리 받지 않음.
|
||||
- `끝수` 가 묶음이면 계산 끝에 붙음(6장) · 글자면 설명일 뿐 계산에 안 붙음.
|
||||
|
||||
## 4. 저장
|
||||
|
||||
@@ -68,3 +76,33 @@
|
||||
- 검사 = `check_master.py` 의 틀(고친 파일) + 로직 변수(모든 로직 파일, 고친 뒤 마스터 기준). **고친 뒤 새로 생긴 걸림**만 막음 — 원래 있던 걸림은 막지 않음. 인력·재료의 원문번호 겹침도 걸림(표·로직 원문번호는 절 번호라 겹쳐도 됨 · 자재품목은 줄에 원문번호가 없음).
|
||||
- 요소를 지워 어떤 로직이 가리키던 것이 사라지면 로직 변수 검사에 걸림(422).
|
||||
- 쓰기는 UTF-8 · LF · 들여쓰기 2칸.
|
||||
|
||||
## 5. 자체 로직 (만들기 · 본뜨기 · 고치기 · 지우기)
|
||||
|
||||
정본 로직(`소유` 「공용」 · `로직_산림품셈…` · `로직_건설품셈…`)은 이 길로 못 고침 — 403. 고치려면 먼저 복제.
|
||||
|
||||
- 자리 = `로직_자체.json` 한 파일(원문 장으로 나누지 않음 — 틀이 「자체」 파일에 장 이름을 두지 않음) · 없으면 서버가 머리(`{"그룹": "로직", "원문": "자체", "판": <올해>, "줄": []}`)와 함께 만듦.
|
||||
- 키 = 서버가 `_키대장.json` 에서 `GX` 다음 번호로 줌 — 화면은 키를 만들지 않음. 원문 절이 같아도 줄마다 다른 키.
|
||||
- `소유` = `현장`(기본) · `공용`. 줄의 `구분` = 「자체」 · `상세구분` = 「NN장 장 제목」(`출처`·`원문번호` 에서 서버가 찾음 · 원문 절이 없으면 빈 글)은 서버가 넣음.
|
||||
|
||||
| 길 | 받음 | 줌 |
|
||||
| -------------------- | ----------------------- | ------------------------------------------------------------ |
|
||||
| `POST /logic/new` | `{logic, owner?}` | `{file, version, key, logic}` |
|
||||
| `POST /logic/copy` | `{key, 이름?, owner?}` | `{file, version, key, logic}` — 정본·자체 둘 다 본뜰 수 있음 |
|
||||
| `POST /logic/edit` | `{key, version, logic}` | `{file, version, logic}` |
|
||||
| `POST /logic/delete` | `{key, version}` | `{file, version}` |
|
||||
|
||||
- `logic` = 로직 한 줄 통째(`_틀.md` 7장) · `키`·`구분`·`상세구분` 은 보내도 서버 것이 이김.
|
||||
- `version` = `GET /logic` 이 준 그 파일 판본 — 다르면 409 `{detail: {stale: [file]}}`.
|
||||
- `copy` 는 비고 끝에 「`<본뜬 키>` 를 본뜸」 을 붙이고 `시험입력` 은 그대로 가져옴 · `이름` 을 주면 그 이름으로.
|
||||
- 답 — 200 · 400(틀린 몸) · 403(정본 로직) · 404(없는 키·파일) · 409(낡은 판본) · 422 `{detail: {errors: […]}}`(검사 걸림 — `/save` 와 같은 검사).
|
||||
- 지움은 그 로직을 부르는 다른 로직이 있으면 422.
|
||||
|
||||
## 6. 끝수
|
||||
|
||||
로직 줄의 `끝수` 는 묶음 `{대상, 자리, 방법, 출처?, 비고?}` — 계산 맨 끝에 붙음.
|
||||
|
||||
- `대상` — `계`(돈 로직 · 비목 합 셋을 각각 끊고 계 = 그 셋의 합) · `결과`(돈 아닌 로직의 결과 수).
|
||||
- `자리` = 소수 자리(0 = 원 미만 · 3 = 소수 넷째 자리에서).
|
||||
- `방법` — `버림` · `올림` · `반올림`.
|
||||
- 옛 줄의 글자 `끝수`(「손료 원 미만 버림(…)」)는 원문 근거를 적어 둔 설명 — 계산에 안 붙음(그 끊기는 이미 식 안에 있음).
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
# 일위대가 로직 만들기 화면 설계
|
||||
|
||||
품셈을 모르는 설계자가 **빈 화면에서 로직 한 줄을 새로 만드는 길**. 지금 테스트 컨테이너(`M01_MasterData_UI_Test*.ts`)는 이미 있는 로직을 읽고 시험 계산만 해서 이 길을 못 재는 자리를 메움.
|
||||
품셈을 모르는 설계자가 **빈 화면에서 로직 한 줄을 새로 만드는 길**(`PLAN.md` 2장).
|
||||
|
||||
- 만들기 = 방식 A(질문·답 마법사) 확장 · 보기 = 방식 C(흐름 그림).
|
||||
- 보기·고치기 = **방식 C(흐름 그림)가 일위대가 로직 화면의 기본** · 옛 호표 편집기는 「고급」 으로 남김.
|
||||
- 만들기 = 그 화면의 **[새로 만들기] 모달 + 방식 A(질문·답)** · 저장하면 방식 C 로 열림.
|
||||
- 식은 글자로 치지 않음 — 선택지와 블록으로 세움. 글자 식은 「고급」 뒤.
|
||||
- 저장·계산은 지금 서버 그대로(`POST /calc` · `POST /save`) — 화면만 새로 붙임.
|
||||
- 서버 길은 다 섬 — `GET /sections` · `/tables?section=` · `GET /table/options` · `/logics?owner=` · `POST /calc`(저장 전 초안) · `POST /logic/new|copy|edit|delete`(계약 `_화면_계약.md` 2·3·5·6장). 남은 것은 화면과 TS 타입뿐(③).
|
||||
|
||||
---
|
||||
|
||||
@@ -23,20 +24,20 @@
|
||||
↓
|
||||
[6 시험 계산] 견본 값을 넣어 호표와 합계 확인(저장 전)
|
||||
↓
|
||||
[7 저장] 개인 · 공용 고르기 → 키는 서버가 발급
|
||||
[7 저장] 현장 · 공용 고르기 → 키는 서버가 발급 → 방식 C 로 열림
|
||||
```
|
||||
|
||||
1. **이름** — 「무엇을 얼마만큼 하는 값인지」 한 줄 · 결과 단위는 고르기(`원/㎡` · `원/m` · `원/㎥` · `원/개소` · `원/본` · 그 밖 직접). 단위가 「원」 으로 시작하면 돈 로직(호표) · 아니면 결과 식 하나(`_틀.md` 7장).
|
||||
2. **원문 절** — 책(산림품셈 · 건설품셈 · 자체) → 장 → 절. 절을 고르면 그 절 번호의 표를 모아 보임 — 「이 절에 쓰는 표」 목록에 표 이름 · 기준(1㎡당) · 용도(`공종` · `대상` = 인력 · 재료 · 기계 · 작업량 조건). 표 하나를 고르면 그 표의 **값 칸이 곧 호표 후보 줄**(석공 · 보통인부 …).
|
||||
2. **원문 절** — 책 → (건설품셈이면 부문) → 장 → 절을 `GET /sections` 로 고름(절마다 그 절의 표·로직 수가 같이 옴 — 0 이면 아직 안 올린 절). 고른 절 번호를 `GET /tables?section=` 에 그대로 넘기면 그 절의 표만 옴 — 표 이름 · 기준(1㎡당) · 용도(`공종` · `대상` = 인력 · 재료 · 기계 · 작업량 조건). 표 하나를 고르면 그 표의 **값 칸이 곧 호표 후보 줄**(석공 · 보통인부 …). 원문 절 없이 만들 수도 있음(출처 「자체」).
|
||||
3. **호표 줄** — 줄마다 세 가지를 정함.
|
||||
- 무엇 — 인력 · 재료 · 기계 · 다른 로직. 인력은 직종 찾기 창(`GET /pick?kind=job`) · 재료는 구분 → 상세구분 → 후보(`GET /materials`) · 기계는 구분 → 기종 · 로직은 로직 목록에서.
|
||||
- 단위 — 고른 줄의 단위를 그대로 씀(재료 후보는 이 단위로 거름).
|
||||
- 수량 — 아래 셋 가운데 하나(②).
|
||||
- 비목은 자동 — 인력 노무비 · 재료 재료비 · 기계 경비(고칠 수 있음).
|
||||
4. **설계 입력** — 2·3 에서 고른 표의 `조건` 칸을 그대로 입력 후보로 제안. 조건 종류대로 칸 모양이 정해짐 — `고르기`는 표 줄에서 뽑은 목록 · `범위`는 아래·위 · `수`는 수 칸. 설계자에게 물을 것만 남기고 나머지는 붙박이 값으로 접음. 남긴 칸마다 **쉬운 말 한 줄(`설명`)** 과 단위를 받음.
|
||||
5. **덧줄·끝수** — 「노무비의 몇 %」 같은 줄은 비율 블록으로(비목 고르기 + 퍼센트). 끝수는 고르기(`원 미만 버림` · `원 미만 반올림` · 없음).
|
||||
6. **시험 계산** — 입력마다 견본 값을 넣고 `POST /calc` 에 `row`(저장 전 줄) · `file` 을 실어 보냄 — 파일에 안 씀. 막히면 까닭을 쉬운 말로(`plainReason`) 보이고 그 걸음으로 되돌림.
|
||||
7. **저장** — 소유(개인 · 공용) · 파일 고르기 → `POST /save` `op: add`. 검사에 걸리면(422) 아무것도 안 쓰고 까닭을 걸음별로 되짚음.
|
||||
4. **설계 입력** — 2·3 에서 고른 표의 조건 칸을 `GET /table/options` 로 받아 그대로 입력 후보로 제안(표 몸은 안 받음). 조건 종류대로 칸 모양이 정해짐 — `고르기`는 그 표 줄에 나온 값 목록 · `범위`는 아래·위 · `수`는 수 칸. 설계자에게 물을 것만 남기고 나머지는 붙박이 값으로 접음. 남긴 칸마다 **쉬운 말 한 줄(`설명`)** 과 단위를 받음.
|
||||
5. **덧줄·끝수** — 「노무비의 몇 %」 같은 줄은 비율 블록으로(비목 고르기 + 퍼센트). 끝수는 세 고르기로 받아 묶음 `{대상, 자리, 방법}` 을 만듦 — 대상 `계`(돈 로직) · `결과`(돈 아닌 로직) · 자리 0 이면 원 미만 · 방법 버림·올림·반올림. 엔진이 계산 맨 끝에 붙임.
|
||||
6. **시험 계산** — 입력마다 견본 값을 넣고 `POST /calc` 에 `key` "" 와 `row`(저장 전 줄)만 실어 보냄 — 키를 미리 받지 않고 파일에도 안 씀. 막히면 까닭을 쉬운 말로(`plainReason`) 보이고 그 걸음으로 되돌림.
|
||||
7. **저장** — 소유(현장 · 공용)만 고르고 `POST /logic/new` — 파일과 키는 서버가 잡음. 검사에 걸리면(422) 아무것도 안 쓰고 까닭을 걸음별로 되짚음. 저장이 끝나면 그 키를 방식 C 보기로 엶.
|
||||
|
||||
## ② 식을 글자로 치지 않는 법
|
||||
|
||||
@@ -57,34 +58,34 @@
|
||||
|
||||
## ③ 지금 식 언어·틀·엔진으로 되는 것과 모자란 것
|
||||
|
||||
되는 것(`_틀.md` 8장 · `scripts/master_formula.py`):
|
||||
되는 것(`_틀.md` 8장 · `scripts/master_formula.py` · `M01_MasterData/`):
|
||||
|
||||
- `찾기(표, 조건=값).값칸` · `로직(키, 입력=값)` · `만약` · `올림·버림·반올림` · `최소·최대` · 사칙·비교 · 비목 합 이름 · `{입력}` 끼우기 — 위 블록이 쓸 것은 모두 있음.
|
||||
- 저장 전 계산(`/calc` 의 `row`·`file`) · 새 로직 키 발급(`/save` `op: add`) · 저장 때 전체 검사(422) — 만들기에 필요한 서버 길은 이미 있음.
|
||||
- `찾기(표, 조건=값).값칸` · `로직(키, 입력=값)` · `만약` · `올림·버림·반올림` · `최소·최대` · 사칙·비교 · 비목 합 이름 · 덧줄의 `줄.'호표 줄 이름'` · `{입력}` 끼우기 — 위 블록이 쓸 것은 모두 있음.
|
||||
- 묶음 `끝수` 를 엔진이 계산 끝에 붙임(대상 `계`·`결과`) · 검사가 묶음 모양을 봄.
|
||||
- 절 목록(`GET /sections`) · 절로 표 거르기(`/tables?section=` — `13-4` 가 `13-40` 에 안 걸림) · 표 조건 값만 받기(`GET /table/options`) · 소유 거름(`/logics?owner=`).
|
||||
- 저장 안 한 초안 계산(`/calc` 에 `key` "" · `row`) · 자체 로직 만들기·본뜨기·고치기·지우기(`/logic/*` · 키 GX 는 서버 발급 · 정본은 403) · 저장 때 전체 검사(422).
|
||||
- 재료 후보 거르기(`/materials` — 구분 · 상세구분 · 규격 · 자재지역 · **호표 줄 단위**) · 표 거르기(`/tables` 의 `usage` = 용도 대상).
|
||||
|
||||
모자란 것(고쳐야 만들기 화면이 섬):
|
||||
모자란 것(화면 쪽 · 2-2·2-3 에서 고침):
|
||||
|
||||
1. **`끝수` 를 엔진이 안 씀** — 로직 줄의 칸일 뿐, `run()` 이 읽지 않아 계산에 안 붙음. 만들기에서 받으려면 엔진에 한 자리(비목 합·계에 적용) 필요 · 그 전에는 화면에 「적어만 둠」 으로 표시.
|
||||
2. **TS 타입이 재료 고르기 조건을 못 담음** — `M01_MasterData_UI_Logic_Api.ts` 의 `HoLine.요소: string` · `Logic_Edit.priceCell` 이 `요소.includes(…)` 를 불러 조건 묶음 줄에서 깨짐. `요소: string | 고르기조건` 으로 넓히기 전에는 만들기 화면이 재료 줄을 조건으로 못 세움(키로만 셈).
|
||||
3. **입력 `설명` 칸이 화면 타입에 없음** — `_틀.md` 7장엔 있고 산림 시험 대상 10개에 채워져 있으나 `LogicInput` 에 없어 마법사가 도움말로 못 씀.
|
||||
4. **절 목록 API 없음** — 책·장·절과 절 제목은 원문 본문 폴더 이름에 있음(`scripts/master_keys.py` 의 `title`). `GET /sections?book=&chapter=` 한 길 필요.
|
||||
5. **절로 표 거르기 없음** — 지금은 `/tables?q=13-4` 로 글자 찾기라 `13-40` 까지 걸림. `section=` 한 칸 필요.
|
||||
6. **표 조건 값 목록이 무거움** — 입력 후보를 뽑으려면 `/table` 로 표를 통째 받아야 함(40줄 표는 괜찮으나 큰 표는 무거움). `/table` 답에 `조건값: {칸: [값…]}` 요약 한 칸 권함.
|
||||
7. **소유 거름 없음** — `/logics` 에 `owner` 가 없어 개인 로직만 보기가 안 됨.
|
||||
1. **TS 타입이 재료 고르기 조건을 못 담음** — `M01_MasterData_UI_Logic_Api.ts` 의 `HoLine.요소: string` · `Logic_Edit.priceCell` 이 `요소.includes(…)` 를 불러 조건 묶음 줄에서 깨짐. `요소: string | 고르기조건` 으로 넓히기 전에는 만들기 화면이 재료 줄을 조건으로 못 세움(키로만 셈).
|
||||
2. **입력 `설명` 칸이 화면 타입에 없음** — `_틀.md` 7장엔 있고 산림 시험 대상 10개에 채워져 있으나 `LogicInput` 에 없어 마법사가 도움말로 못 씀.
|
||||
3. **`LogicRow` 에 `소유`·묶음 `끝수` 가 없음** — 목록에서 현장 로직을 가르고 끝수 걸음을 그리려면 타입에 둘 다 필요.
|
||||
4. **자체 로직 길을 부르는 화면 함수가 없음** — `Logic_Api.ts` 에 `/logic/new|copy|edit|delete` 를 부르는 넷과 `/sections` · `/table/options` 를 더해야 함.
|
||||
|
||||
## ④ 저장 자리
|
||||
|
||||
- **소유 칸** — 로직 줄의 `소유` = `공용`(원문 품셈을 옮긴 정본) · `개인`(현장에서 만든 것). 칸은 이미 있음 · 새 로직은 기본 `개인`.
|
||||
- **파일 가르기** — 정본 장 파일(`로직_산림품셈_13장_구조물.json`)에 개인 줄을 섞지 않음. 자체 로직은 `로직_자체_NN장_<제목>.json` — 파일 이름 규칙(`master_keys.CHAPTER`)이 `자체` 를 이미 받음 · 키는 `GX`(대장 `다음` 에 GX 가 없어 첫 줄이 `GX000001`).
|
||||
- **키 발급** — 화면은 키를 만들지 않음. `op: add` 로 보내면 서버가 `_키대장.json` 의 다음 번호를 줌. 대장 열쇠는 「절 번호 + 이름」 이라 줄의 절 번호와 겹치지 않음 — 같은 절에 로직을 둘 만들어도 새 키.
|
||||
- **막는 것** — 저장 전 검사(`check_saved`)를 그대로 받음 · 하나라도 걸리면 아무것도 안 씀. 「값 없는 요소」 처럼 관리자 몫인 까닭은 저장은 되고 계산만 멈춤.
|
||||
- 프로젝트별·사용자별 자리는 뒤 단계 — 마스터에는 사람 개념이 없음. 지금은 「개인 = 이 설치본의 현장 로직」.
|
||||
- **소유 칸** — 로직 줄의 `소유` = `공용`(원문 품셈을 옮긴 정본) · `현장`(현장에서 만든 것). 새 로직은 기본 `현장` · 목록은 `/logics?owner=` 로 가름.
|
||||
- **파일 가르기** — 정본 장 파일(`로직_산림품셈_13장_구조물.json`)에 현장 줄을 섞지 않음. 자체 로직은 `로직_자체.json` 한 파일 — 틀이 「자체」 파일에 장 이름을 두지 않아 장으로 쪼개지 않음. 줄의 `상세구분` 에 「13장 구조물」 이 들어가 목록에서 장별로 모임.
|
||||
- **키 발급** — 화면은 키를 만들지 않음. `POST /logic/new` 면 서버가 `_키대장.json` 의 `GX` 다음 번호를 줌(첫 줄이 `GX000001`). 대장 열쇠는 「절 번호 + 이름」 이고 겹치면 뒤에 번호를 붙여 — 같은 절에 로직을 둘 만들어도 키가 갈림.
|
||||
- **못 고치는 것** — 정본 로직은 `/logic/edit`·`/logic/delete` 가 403. 고치려면 `/logic/copy` 로 본뜬 뒤 고침.
|
||||
- **막는 것** — 저장 전 검사(`check_saved`)를 그대로 받음 · 하나라도 걸리면 아무것도 안 씀. 「값 없는 요소」 처럼 관리자 몫인 까닭은 저장은 되고 계산만 멈춤. 지우려는 로직을 다른 로직이 부르면 422.
|
||||
- 프로젝트별·사용자별 자리는 뒤 단계 — 마스터에는 사람 개념이 없음. 지금은 「현장 = 이 설치본에서 만든 로직」.
|
||||
|
||||
## ⑤ 기존 로직 본떠 만들기
|
||||
|
||||
- 로직 목록·시험 컨테이너에서 「이것처럼 새로 만들기」 한 단추 — 고른 로직을 복사해 키 빈 줄로 만들기 걸음 7 번(저장) 직전 상태로 엶.
|
||||
- 복사할 때 바꾸는 것 — 키 비움 · 소유 `개인` · 파일 자체 파일 · 이름 뒤에 「(수정)」 · 출처는 본뜬 원문 절 그대로 두고 비고에 「<키> 를 본뜸」 한 줄.
|
||||
- 방식 C 보기에서 「이것처럼 새로 만들기」 한 단추 — `POST /logic/copy` 한 번이면 자체 파일에 새 키로 복사본이 생기고, 그 키를 방식 C 로 열어 상자에서 고침.
|
||||
- 서버가 바꾸는 것 — 새 키 · 소유 `현장` · 파일 `로직_자체.json` · 비고 끝에 「<본뜬 키> 를 본뜸」. 이름은 보내면 그 이름 · 출처와 시험입력은 본뜬 줄 그대로.
|
||||
- 걸음은 같음 — 이름 → (원문 절은 그대로 두고) 호표 줄 고치기 → 입력 다듬기 → 시험 계산 → 저장.
|
||||
- 가장 흔한 길 — 원문 품셈 로직에서 재료 한 줄만 현장 자재로 바꾸기 · 덧줄 비율만 바꾸기.
|
||||
- 본뜬 뒤 원본은 안 바뀜 — 시험 컨테이너의 「바꿔 보기」(`swappedRow`)와 같은 방식으로 복사본에만 씀.
|
||||
@@ -92,29 +93,36 @@
|
||||
## ⑥ 화면 구성과 구현 조각
|
||||
|
||||
```
|
||||
로직 화면(관리자) 테스트 컨테이너
|
||||
┌───────────────┐ ┌─────────────────────┐
|
||||
│ 목록 · 고급 편집기 │◀──「고급」──│ [만들기] A 확장 마법사 │
|
||||
└───────────────┘ │ [보기] C 흐름 그림 │
|
||||
▲ └─────────────────────┘
|
||||
└─────── 같은 서버 길(/calc · /save) · 같은 부품(Pick) ───────┘
|
||||
일위대가 로직 화면
|
||||
┌──────────────────────────────────────────┐
|
||||
│ 목록(소유 거름) │ [새로 만들기] ──▶ 모달 = 방식 A │
|
||||
├──────────────────────────────────────────┤
|
||||
│ 기본 보기 = 방식 C 흐름 그림 │
|
||||
│ 상자 누름 → 값·출처·원문 표·쉬운 말 풀이 │
|
||||
│ 자체 로직이면 상자에서 바로 고치기·줄 더하기·지우기 │
|
||||
│ 정본이면 [이것처럼 새로 만들기] 만 │
|
||||
├──────────────────────────────────────────┤
|
||||
│ [고급] 옛 호표 편집기(글자 식) │
|
||||
└──────────────────────────────────────────┘
|
||||
저장 끝 ──▶ 그 키를 방식 C 로 엶
|
||||
```
|
||||
|
||||
- **만들기 = A 확장** — A 는 「입력을 묻고 계산」 · 만들기는 그 앞에 「무엇을 만들지」 걸음을 더한 같은 마법사 틀(한 번에 한 질문 · 뒤로 · 다시).
|
||||
- **보기 = C** — 저장 직전과 저장 뒤 모두 C 흐름 그림으로 전체를 보임(설계 값 → 표 찾기 → 수량 → × 단가 → 덧줄 → 비목 → 계). `Test_C_Model.ts` 는 순수 함수라 저장 전 줄에도 그대로 씀.
|
||||
- **만들기 = 모달 + A** — 한 번에 한 질문 · 뒤로 · 다시. A 는 「입력을 묻고 계산」 이었고 만들기는 그 앞에 「무엇을 만들지」 걸음(①)을 더한 같은 틀.
|
||||
- **보기·고치기 = C** — 저장 직전 미리보기와 저장 뒤 보기가 같은 그림(설계 값 → 표 찾기 → 수량 → × 단가 → 덧줄 → 비목 → 계). `Test_C_Model.ts` 는 순수 함수라 저장 전 줄에도 그대로 씀.
|
||||
- 테스트 컨테이너(`UI_Test`)와 방식 B 화면 · 방식 A 의 읽기 전용 화면은 모달로 옮긴 뒤 걷음.
|
||||
|
||||
파일 경계(새로 만들 것 · 한 파일 700줄 아래):
|
||||
|
||||
| 파일 | 몫 |
|
||||
| --- | --- |
|
||||
| `M01_MasterData_UI_New.ts` | 걸음 틀 · 만드는 중인 줄 한 벌 · 앞뒤 이동 · 저장 |
|
||||
| `M01_MasterData_UI_New_Steps.ts` | 걸음별 화면(이름 · 절 · 호표 · 입력 · 덧줄) |
|
||||
| `M01_MasterData_UI_New_Qty.ts` | 수량 블록(직접 값 · 표에서 찾기 · 다른 로직 · 할증 · 조건) → 식 글자 |
|
||||
| `M01_MasterData_UI_New_Text.ts` | 화면 글(쉬운 말) |
|
||||
| 파일 | 몫 |
|
||||
| -------------------------------- | -------------------------------------------------------------------- |
|
||||
| `M01_MasterData_UI_New.ts` | 모달 틀 · 만드는 중인 줄 한 벌 · 앞뒤 이동 · 저장 |
|
||||
| `M01_MasterData_UI_New_Steps.ts` | 걸음별 화면(이름 · 절 · 호표 · 입력 · 덧줄·끝수) |
|
||||
| `M01_MasterData_UI_New_Qty.ts` | 수량 블록(직접 값 · 표에서 찾기 · 다른 로직 · 할증 · 조건) → 식 글자 |
|
||||
| `M01_MasterData_UI_New_Text.ts` | 화면 글(쉬운 말) |
|
||||
|
||||
그대로 쓰는 것 — `Test_Pick.ts`(재료·기계 고르기) · `Logic_Api.ts`(`fetchLogic` · `runCalc` · `saveFiles` · `fetchMaterials`) · `Test_C*.ts`(보기) · `Logic_Edit.ts`(고급) · `Test_Text.ts`(`plainReason`).
|
||||
그대로 쓰는 것 — `Test_Pick.ts`(재료·기계 고르기) · `Logic_Api.ts`(`fetchLogic` · `runCalc` · `fetchMaterials`) · `Test_C*.ts`(기본 보기로 옮김) · `Logic_Edit.ts`(고급) · `Test_Text.ts`(`plainReason`).
|
||||
|
||||
서버에 더할 것 — `GET /sections`(책·장·절 목록) · `/tables` 의 `section` 거름 · `/table` 답의 `조건값` 요약 · `/logics` 의 `owner` 거름 · `Logic_Api` 타입 셋(`HoLine.요소` 넓히기 · `LogicInput.설명` · `LogicRow.소유`).
|
||||
`Logic_Api.ts` 에 더할 것 — 새 길 여섯(`/sections` · `/table/options` · `/logic/new|copy|edit|delete`)과 타입 넷(`HoLine.요소` 넓히기 · `LogicInput.설명` · `LogicRow.소유` · 묶음 `끝수`).
|
||||
|
||||
## ⑦ 예 — 산림 13-4-1 메쌓기를 빈 화면에서
|
||||
|
||||
@@ -132,14 +140,14 @@
|
||||
— 표 마지막 칸이 범위 값(80∼100)이라 그 자리는 설계자 입력 `초과증가율` 로 받음(`_틀.md` 6장 · 값 칸 범위는 입력으로).
|
||||
5. **설계 입력** — 3·4 에서 물은 칸이 그대로 입력이 됨.
|
||||
|
||||
| 이름 | 모양 | 설명(쉬운 말) |
|
||||
| --- | --- | --- |
|
||||
| 뒷길이 | 고르기 25·30·35·45·55·60·75 (㎝) | 쌓을 돌의 뒤쪽 길이 |
|
||||
| 돌 | 고르기 견치돌·깬돌·깬잡석·호박돌 및 야면석 | 쌓을 돌 종류 |
|
||||
| 쌓기 | 고르기 골쌓기·켜쌓기 | 돌을 어긋나게 쌓는지 줄 맞춰 쌓는지 |
|
||||
| 높이 | 수 (m) | 쌓는 벽 높이 |
|
||||
| 초과증가율 | 범위 80∼100 (%) | 기준 높이를 넘어 더 드는 품 비율 |
|
||||
| 이름 | 모양 | 설명(쉬운 말) |
|
||||
| ---------- | ------------------------------------------ | ----------------------------------- |
|
||||
| 뒷길이 | 고르기 25·30·35·45·55·60·75 (㎝) | 쌓을 돌의 뒤쪽 길이 |
|
||||
| 돌 | 고르기 견치돌·깬돌·깬잡석·호박돌 및 야면석 | 쌓을 돌 종류 |
|
||||
| 쌓기 | 고르기 골쌓기·켜쌓기 | 돌을 어긋나게 쌓는지 줄 맞춰 쌓는지 |
|
||||
| 높이 | 수 (m) | 쌓는 벽 높이 |
|
||||
| 초과증가율 | 범위 80∼100 (%) | 기준 높이를 넘어 더 드는 품 비율 |
|
||||
|
||||
6. **덧줄·끝수** — 원문에 잡재료·할증 줄이 없어 덧줄 없음 · 끝수 없음.
|
||||
7. **시험 계산** — 견본으로 뒷길이 35 · 돌 깬잡석 · 쌓기 골쌓기 · 높이 4 · 초과증가율 80 을 넣어 호표 두 줄과 계를 확인. 표에 없는 조합(뒷길이 25 · 견치돌 등)은 「맞는 줄 0개」 로 멈추므로 화면이 「원문 표에 없는 조합」 으로 되짚어 줌.
|
||||
8. **저장** — 소유 `개인` · 파일 `로직_자체_13장_구조물.json` → 키 `GX……` 발급. 공용 정본으로 올리는 것은 관리자 몫(뒤 단계).
|
||||
6. **덧줄·끝수** — 원문에 잡재료·할증 줄이 없어 덧줄 없음 · 끝수 없음(원문에 끊기 규정이 없음).
|
||||
7. **시험 계산** — 견본으로 뒷길이 35 · 돌 깬잡석 · 쌓기 골쌓기 · 높이 4 · 초과증가율 80 을 넣고 `POST /calc` 에 `key` "" 와 초안 줄만 보내 호표 두 줄과 계를 확인. 표에 없는 조합(뒷길이 25 · 견치돌 등)은 「맞는 줄 0개」 로 멈추므로 화면이 「원문 표에 없는 조합」 으로 되짚어 줌.
|
||||
8. **저장** — 소유 `현장` 만 고르고 `POST /logic/new` → 서버가 `로직_자체.json` 에 키 `GX……` 로 넣고 `상세구분` 을 「13장 구조물」 로 채움. 저장 끝나면 그 키가 방식 C 로 열림. 공용 정본으로 올리는 것은 관리자 몫(뒤 단계).
|
||||
|
||||
@@ -426,6 +426,21 @@ def evaluate(node, env: dict, master: Master, depth: int = 0):
|
||||
raise FormulaError(f"모르는 마디 {kind}")
|
||||
|
||||
|
||||
ROUND_WAYS = {"올림": ROUND_UP, "버림": ROUND_DOWN, "반올림": ROUND_HALF_UP}
|
||||
ROUND_ON = ("계", "결과")
|
||||
|
||||
|
||||
def cut(row: dict, value: Decimal, on: str) -> Decimal:
|
||||
"""줄의 `끝수` 를 붙임 — 묶음 `{대상, 자리, 방법}` 만 · 글자 끝수는 원문 근거를 적은 설명."""
|
||||
rule = row.get("끝수")
|
||||
if not isinstance(rule, dict) or rule.get("대상") != on:
|
||||
return value
|
||||
way = ROUND_WAYS.get(str(rule.get("방법")))
|
||||
if way is None:
|
||||
raise FormulaError(f"「{_name(row)}」 끝수 방법 「{rule.get('방법')}」")
|
||||
return _round(value, rule.get("자리") or 0, way)
|
||||
|
||||
|
||||
def _inputs(row: dict, given: dict) -> dict:
|
||||
env = {}
|
||||
for spec in row.get("입력", []):
|
||||
@@ -463,7 +478,8 @@ def run(master: Master, ref: str, given: dict, depth: int = 0) -> dict:
|
||||
for step in row.get("중간", []):
|
||||
env[step["이름"]] = evaluate(parse(step["식"]), env, master, depth)
|
||||
if "결과" in row:
|
||||
return {"결과": evaluate(parse(row["결과"]["식"]), env, master, depth), "중간": env}
|
||||
value = evaluate(parse(row["결과"]["식"]), env, master, depth)
|
||||
return {"결과": cut(row, value, "결과"), "중간": env}
|
||||
sums = dict.fromkeys(COST_ITEMS, Decimal(0))
|
||||
lines = []
|
||||
for item in row.get("호표", []):
|
||||
@@ -526,6 +542,7 @@ def run(master: Master, ref: str, given: dict, depth: int = 0) -> dict:
|
||||
"비목": {extra["비목"]: value},
|
||||
}
|
||||
)
|
||||
sums = {k: cut(row, v, "계") for k, v in sums.items()} # 비목 합마다 끊고 계는 그 합
|
||||
return {"줄": lines, **sums, "계": sum(sums.values()), "중간": env}
|
||||
|
||||
|
||||
@@ -679,9 +696,34 @@ def check_logic(master: Master, row: dict) -> tuple[list[str], set]:
|
||||
names = names | {extra["이름"]}
|
||||
if extra.get("비목") not in COST_ITEMS:
|
||||
out.append(f"{key} 덧줄 {extra['이름']} · 비목 「{extra.get('비목')}」")
|
||||
out += _check_cut(row, key)
|
||||
return out, calls
|
||||
|
||||
|
||||
def _check_cut(row: dict, key: str) -> list[str]:
|
||||
"""끝수 — 묶음이면 칸·대상·방법·자리 · 글자는 설명(검사 안 함)."""
|
||||
rule = row.get("끝수")
|
||||
if rule is None or isinstance(rule, str):
|
||||
return []
|
||||
if not isinstance(rule, dict):
|
||||
return [f"{key} 끝수 · 묶음도 글자도 아님"]
|
||||
out = []
|
||||
unknown = set(rule) - {"대상", "자리", "방법", "출처", "비고"}
|
||||
if unknown:
|
||||
out.append(f"{key} 끝수 · 모르는 칸 {sorted(unknown)}")
|
||||
on = rule.get("대상")
|
||||
if on not in ROUND_ON:
|
||||
out.append(f"{key} 끝수 · 대상 「{on}」 — {' · '.join(ROUND_ON)}")
|
||||
elif ("결과" in row) != (on == "결과"):
|
||||
out.append(f"{key} 끝수 · 대상 「{on}」 이 로직 갈래와 안 맞음")
|
||||
if rule.get("방법") not in ROUND_WAYS:
|
||||
out.append(f"{key} 끝수 · 방법 「{rule.get('방법')}」 — {' · '.join(ROUND_WAYS)}")
|
||||
place = rule.get("자리", 0)
|
||||
if not isinstance(place, (int, Decimal)) or place != int(place) or not 0 <= int(place) <= 6:
|
||||
out.append(f"{key} 끝수 · 자리 「{place}」 — 0∼6 정수")
|
||||
return out
|
||||
|
||||
|
||||
def find_loops(graph: dict[str, set]) -> list[list[str]]:
|
||||
"""로직 부르기의 돌고 도는 길."""
|
||||
loops, state = [], {}
|
||||
|
||||
Reference in New Issue
Block a user