47 lines
3.4 KiB
Markdown
47 lines
3.4 KiB
Markdown
# 06 · 분석 → 채움 절차
|
|
|
|
> 입력: `docs/[Ubisam산출물]/산출물문서/양식/`(빈 양식) 또는 타설비 산출물. 출력: 단계 슬롯에 채운 산출물 + 갱신된 `_task.md` + 로그.
|
|
|
|
## 절차
|
|
1. **분석**: 원본 구조 파악(시트/슬라이드/컬럼). 결과를 `[분석]/<yyyy_mm_dd>_<주제>-분석.md`에 기록.
|
|
- 엑셀 구조 추출(파이썬·Office 없이): `unzip -p file.xlsx xl/workbook.xml`(시트명), `xl/sharedStrings.xml`(라벨).
|
|
2. **양식 식별**: 타설비 템플릿 잔재 분리. 채울 슬롯 결정 → [04-stage-deliverables.md](04-stage-deliverables.md).
|
|
- 시트·컬럼 골격은 [05-form-schemas.md](05-form-schemas.md) 기준(ref 없어도 재현 가능).
|
|
3. **채움**: 이 프로젝트 사실로 값 작성. **출처(원본 파일·코드 경로) 명시**.
|
|
- 미확정 디바이스주소·축범위는 `(제안)` 표기.
|
|
4. **디자인 적용**: [08-design-system.md](08-design-system.md) 배너·뱃지·섹션헤더를 삽입한다.
|
|
- MD 최상단: 배너(§1) → 부제 바 순.
|
|
- 상태·유형 필드: 텍스트 대신 뱃지(§2·3) 사용.
|
|
- 진행률: `<progress>` 바(§4) 병기.
|
|
- 산출물 시트 구분 `##` 헤더: `<span style="color:#2E75B6">` 적용(§5).
|
|
5. **배치**: 해당 `NN.단계명/<슬롯>/`에 저장.
|
|
6. **PPTX 생성**: [09-pptx-integration.md](09-pptx-integration.md) 참고.
|
|
- 2.설계 채움 완료 → `SW_설계서.pptx` (선택)
|
|
- 5.양산 채움 or 명시 요청 → `<설비명>_HMI_매뉴얼.pptx` (필수)
|
|
- MD 내용 → JSON spec → `ubisam-ppt-make/build_deck.py` → 슬롯에 저장
|
|
- 임시 spec JSON 생성 후 pptx 완성 즉시 삭제
|
|
7. **카드 갱신**: `_task.md`의 상태·진행률·첨부 매핑 갱신(PPTX 파일명 포함, [02-enums.md](02-enums.md)).
|
|
8. **기록**: `[작업일지]/<오늘>.md`에 한 일·다음 TODO.
|
|
|
|
## xlsx 재생산 (from scratch · ref 불필요)
|
|
- `references/xlsxfill.py` — 스타일 상수 하드코딩 + scratch-build API.
|
|
- `references/build_02설계_xlsx.py` — PtoP 데이터 내장, 4종 xlsx 자동 생성.
|
|
**`ptop-deliverables` 경로 한정.** 타사 문서 재생산(rebuild)에는 쓰지 않는다 — 데이터가 하드코딩돼 매핑표를 반영할 수 없다.
|
|
- 실행: cwd=repo root, `PYTHONUTF8=1 py .claude/skills/ubisam-deliverables/references/build_02설계_xlsx.py`
|
|
- ref xlsx 없어도 동일 외형 재현. 스타일 상수 변경 시 xlsxfill.py만 수정.
|
|
|
|
## pptx 재생산 (from scratch · ref 불필요)
|
|
- `references/build_02설계_pptx.py` — 슬라이드 스펙(22슬라이드) 내장, `ubisam-ppt-make/build_deck.py` 자동 호출.
|
|
- 실행: cwd=repo root, `PYTHONUTF8=1 py .claude/skills/ubisam-deliverables/references/build_02설계_pptx.py`
|
|
- 출력: `docs/[Ubisam산출물]/02.설계/설계리뷰_DR/SW_설계서.pptx`
|
|
- 임시 spec JSON 자동 생성·삭제. 표 높이 상한 5.3" 적용 — 푸터 비침범 보장.
|
|
|
|
## MD 분할 규칙
|
|
- 모든 산출/분석 MD는 **200줄 이내** (`rules.md` #4). 초과 시 주제별 분할 + 상호 링크(상대경로)로 매핑.
|
|
- 인덱스 문서(예: [분석] 폴더 README)에 1줄 포인터로 목록 유지.
|
|
|
|
## 자기완결 보장 (ref 없이 동작)
|
|
- 이 스킬은 양식 골격을 [05-form-schemas.md](05-form-schemas.md)에 내장한다.
|
|
- `ref/`가 비어 있어도 트리·enum·양식 골격을 동일하게 생성한다.
|
|
- 새 양식 입수 시: 골격을 추출해 05 파일에 추가 → 이후 ref 없이 재현 가능.
|