109 lines
7.7 KiB
Markdown
109 lines
7.7 KiB
Markdown
---
|
|
name: ubisam-format-map
|
|
description: Ubisam 협업관리 양식의 공통 enum·스키마·단계↔산출물 슬롯 매핑 레퍼런스. 상태(4종)·일감유형(9종)·진행 6단계(분석/협의·설계·제작·셋업·양산·CS)·일감/프로젝트 필드 스키마·티켓 코드 규칙을 제공. Ubisam 양식으로 산출물을 재생산·재배치·검증하거나, 타사 양식 문서를 Ubisam 단계로 매핑할 때 반드시 이 스킬을 먼저 읽을 것. "Ubisam 양식", "협업관리", "일감 6단계", "산출물 슬롯", "상태/유형 enum" 언급 시 사용. 구분 — 이 스킬은 **조회 전용 사전**이다. 실제로 산출물을 만들거나 고치는 것은 `ubisam-deliverables`(트리 생성)·`ubisam-deliverable-rebuild`(기존 문서 재생산)·`ptop-deliverables`(소스 기준 MD)다.
|
|
---
|
|
|
|
# Ubisam 협업관리 양식 맵 (Format Map)
|
|
|
|
타사 양식 산출물을 Ubisam 협업관리 양식으로 **재생산·재배치·검증**할 때의 단일 기준 사전이다.
|
|
근거 원본(스크린샷 분석)은 아래를 참조하며, 값이 갱신되면 **이 파일과 원본을 함께** 고친다.
|
|
|
|
- `docs/[Ubisam산출물]/[분석]/_ubisam-협업관리-용어집(skill-ref).md` — enum 사전(원본)
|
|
- `docs/[Ubisam산출물]/[분석]/2026_06_29_협업관리-프로젝트관리-분석.md` — 단계별 산출물 정의 상세
|
|
- `docs/[Ubisam산출물]/ref/` — 화면 캡처
|
|
|
|
> ⚠ 위 3개 경로는 **`ubisam-deliverables` 스캐폴딩 이후에만 존재**하며, `docs/[Ubisam산출물]/`은
|
|
> `.gitignore` 제외 대상이라 clone 직후에는 없다. 없으면 **본문 §1~§5를 유일 기준으로 삼고**,
|
|
> 본문이 답하지 못하는 항목은 `미정 — 확인 필요`로 남긴다. 없는 파일을 찾다 멈추지 말 것.
|
|
|
|
## 1. 상태(Status) enum — 4종 (전이 순서)
|
|
|
|
```
|
|
해야 할 일 → 분석 진행 → 업무 진행중 → 진행 완료
|
|
```
|
|
아래 **ARGB는 xlsx 셀 채우기용**이다. MD·HTML 뱃지 색은
|
|
`ubisam-deliverables/references/02-enums.md`의 HEX 표를 쓴다 (같은 상태, 다른 용도).
|
|
|
|
| 상태 | 색(ARGB · xlsx) | 칸반 컬럼 |
|
|
|---|---|---|
|
|
| 해야 할 일 | `FFD9D9D9` (회색) | Todo |
|
|
| 분석 진행 | **미확인** — 원본 스크린샷에서 확인 후 기입 | Select For dev |
|
|
| 업무 진행중 | `FF8FAADC` (파랑) | InProgress |
|
|
| 진행 완료 | `FFA9D08E` (연두) | Done |
|
|
|
|
> `분석 진행`은 이전 판에서 `업무 진행중`과 **같은 ARGB(`FF8FAADC`)로 잘못 적혀 있었다.**
|
|
> 같은 색이면 조건부서식이 두 상태를 구분하지 못한다. 실제 값을 확인하기 전까지 지어내지 말고
|
|
> `미확인`으로 두고, 확인되면 이 표를 고친다. 실제 파일 색이 표와 다르면 **파일이 진실원이다.**
|
|
|
|
상태 문자열은 위 4개만 사용한다. 임의 변형(예: "완료", "진행중") 금지 — 칸반/조건부서식 매칭이 깨진다.
|
|
|
|
> ARGB가 `미확인`인 상태는 **셀 채우기 없이 문자열만 기입**하고 그 사실을 작업 로그에 남긴다.
|
|
> 색을 지어내면 조건부서식이 잘못 매칭된다.
|
|
|
|
## 2. 일감 유형(Type) enum — 9종
|
|
|
|
오류수정 · 불합리 · 미팅 · 설계 · 개발 · 제작 · 입고셋업 · 적용 및 모니터링 · 요청대응
|
|
|
|
## 3. 진행 6단계 ↔ 기본 일감유형 ↔ 산출물 슬롯
|
|
|
|
| # | 단계 | 기본 유형 | 핵심 산출물(슬롯) |
|
|
|---|---|---|---|
|
|
| 1 | 분석/협의 | 미팅 | 사양서, CR회의록, 마스터플랜, URS 분석/제어 시나리오 검토 |
|
|
| 2 | 설계 | 설계 | HMI 화면정의서·UI 스토리보드·기능명세서 / 시퀀스 다이어그램·인터록 정의서 / 통신맵(Memory·IO·Register)·DB 스키마 / D/R 회의록 |
|
|
| 3 | 제작 | 제작 | 개발환경·핵심모듈·UI/메인 시퀀스·시뮬레이션 / 단위·통합 테스트 결과 보고서(Check-List) |
|
|
| 4 | 셋업 | 입고셋업 | HW IO/모션 점검 시트 / 파라미터·레시피 백업 / 이슈 로그(Dry Run·Tack Time) / MES 연동 / SAT 결과서 |
|
|
| 5 | 양산 | 적용 및 모니터링 | 운영 가이드·매뉴얼(HMI·알람조치) / S/W 최적화 / 최종 버전 동결·마스터 백업 / 프로젝트 완료 보고서 |
|
|
| 6 | CS | 요청대응 | 요청대응 이력(가동 후 CS) |
|
|
|
|
**타사 양식 → 슬롯 매핑 원칙**: 원본 문서의 목적(요구분석/설계정의/테스트/셋업/운영매뉴얼)을 위 슬롯 키워드와 대조해 단계를 결정한다. 한 문서가 여러 단계에 걸치면 단일 슬롯 배치가 기본값이며 보조 단계를 비고에 병기한다.
|
|
**단 분할 여부의 최종 판정은 `ubisam-analyst.md` §4가 소유한다** — 시트/슬라이드 단위로 서로 다른
|
|
슬롯에 배치하는 것이 적절한 문서가 있기 때문이다. 이 절과 충돌하면 analyst §4를 따른다.
|
|
|
|
## 4. 일감 필드 스키마
|
|
|
|
| 필드 | 규칙 |
|
|
|---|---|
|
|
| 제목 | `N.단계명` (예: `2.설계`) |
|
|
| 티켓번호 | `{프로젝트코드}-{일련번호}` — 프로젝트코드는 `_meta/project.yaml`에서 읽는다 |
|
|
| 유형 | §2 enum 1개 |
|
|
| 상태 | §1 enum 1개 |
|
|
| 우선순위 | 보통(=Normal) 기본 |
|
|
| 담당자/참조자 | `이름(직급)` |
|
|
| 진행률 | % |
|
|
| 등록일/수정일/종료일 | yyyy/mm/dd (또는 yyyy-mm-dd) |
|
|
| 예상시간 | `2w 4d 6h 45m` 형식 |
|
|
| Hashtag | 자유 태그 |
|
|
| 첨부파일 | 최대 2.93GB |
|
|
|
|
## 5. 프로젝트 메타 스키마
|
|
|
|
프로젝트명 · 종류(Software) · 프로젝트형식(Kanban) · 코드명 · 사업부/팀 · PL · 등록자 · 계약일/납기 · 권한(책임자→참여자→열람자).
|
|
|
|
**프로젝트 메타의 유일 진실원은 `docs/[Ubisam산출물]/_meta/project.yaml`이다.**
|
|
이 스킬에 특정 프로젝트의 값을 적어두지 않는다 — 다른 프로젝트에서 복사해 온 값이 여기 남아 있으면,
|
|
그것을 읽은 작성가가 산출물에 그대로 기입하고 검증가는 그 값을 정답으로 대조하게 된다.
|
|
즉 **하네스가 잡아야 할 "타설비 잔재"를 하네스 스스로 공급하는 꼴**이 된다.
|
|
|
|
`project.yaml`이 없으면 값을 지어내지 말고 `미정 — 확인 필요`로 남기고 사용자에게 묻는다.
|
|
|
|
## 6. PTOP 채움 시 참고값 (검증 기준 아님)
|
|
|
|
> 아래는 **이 저장소 한정 참고값**이다. §5 원칙대로 프로젝트 메타의 진실원은 `_meta/project.yaml`이며,
|
|
> qa는 이 절을 정답으로 대조하지 않는다. `project.yaml`과 어긋나면 `project.yaml`이 우선한다.
|
|
|
|
|
|
설비: 각형 배터리 레이저 용접기(ILSOS OC5 PtoP Welder), Aurora 2.0 / .NET 4.8.1 / WPF.
|
|
주요 디바이스: PLC(Mitsubishi Melsec·MX Component), Laser Scanner(RTC), Laser(IO Gate),
|
|
Digital IO — 구현 클래스는 `PAIX_PTOP`(`EquipmentSetup.cs:153` 등록), 보드 타입은 런타임
|
|
`IOUnitConfig.BoardType` 설정값이다. "Ajin"으로 단정하지 말고 설정을 확인할 것.
|
|
메인 시퀀스: `SeqAutoRunPTOP`. PLC 인터페이스: `Machines/ILSOS_PrismaticRD_PTOP/Device/PLC/PLCController.Address.cs`.
|
|
|
|
> 재생산 산출물의 **출처(코드 경로/커밋)**를 항상 명시한다 — 검증가가 근거 추적에 사용한다.
|
|
|
|
> **규약 바인딩.** 이 스킬은 enum·양식의 **단일 기준**이라 여기서 새는 추측은 하류 전체를 오염시킨다.
|
|
> - 확인하지 않은 값·해석은 문장 앞에 `[추론]` 을 붙인다 (`rules.md` #15·#16). 확인 후 표기를 떼고
|
|
> `파일:심볼` 로 바꾼다. 검색은 **`\[추론\]`** 로 이스케이프한다(대괄호=정규식 문자클래스).
|
|
> - `미확인`(값을 못 찾음)과 `[추론]`(확인 전 서술)은 축이 다르다 — 대체하지 말고 필요하면 병기한다.
|
|
> - 주석·클래스명을 근거로 삼지 않는다 (#1). 위 `BoardType` 이 그 사례다.
|
|
> - 모르면 지어내지 말고 모른다고 한다 (#9).
|