105 lines
4.7 KiB
Markdown
105 lines
4.7 KiB
Markdown
# 공유/소통/ — 너드나비스 부서간 통신 허브 (Phase 1)
|
|
|
|
> **본 디렉토리는 PM·개발실·기획실 간 공식 비동기 통신 채널이다.**
|
|
> 모든 부서간 요청·응답·보고는 본 허브의 6축 채널을 경유하며, 처리 완료 후 `완료/` 로 아카이브된다. git commit·push 이벤트가 유일한 트리거이며, 부서 세션 SessionStart hook(Phase 2) 및 NAS post-receive hook(Phase 3)이 본 채널 변경을 감지한다.
|
|
|
|
## 6축 채널 구조
|
|
|
|
| 채널 | 송신자 | 수신자 | 주요 용도 |
|
|
|------|--------|--------|----------|
|
|
| `PM→개발실/` | 총괄PM | 개발실 | PD님 지시 하달, 업무 지시, 검토 요청, 상태 질의 |
|
|
| `PM→기획실/` | 총괄PM | 기획실 | 동일 (기획실 대상) |
|
|
| `개발실→PM/` | 개발실(실장·팀장) | 총괄PM | 일일보고, 진행 보고, 블로커 보고, 검토 응답 |
|
|
| `기획실→PM/` | 기획실(팀장) | 총괄PM | 동일 (기획실 → PM) |
|
|
| `기획실→개발실/` | 기획실 | 개발실 | 기획 REQ (데이터 해석 확인·스펙 요청·의존성) |
|
|
| `개발실→기획실/` | 개발실 | 기획실 | 기획 REQ 응답, 기술 가이드, 프리뷰 |
|
|
|
|
완료 처리된 파일은 `완료/` 로 이동. 감사·추적 목적으로 영구 보존.
|
|
|
|
---
|
|
|
|
## 파일 명명 규칙
|
|
|
|
```
|
|
YYYY-MM-DD_[REQ번호]_[제목].md
|
|
|
|
예시:
|
|
2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md
|
|
2026-04-15_STATUS001_Phase3_HOLD_사유.md
|
|
2026-04-15_REPORT001_일일보고_개발실.md
|
|
```
|
|
|
|
- 날짜는 **작성일**
|
|
- REQ번호는 채널별 일련번호 (채널 시작 시점부터 증가, 자율 부여)
|
|
- 제목은 20자 이내 권장
|
|
|
|
---
|
|
|
|
## 파일 내부 표준 — YAML 프론트매터 (필수)
|
|
|
|
모든 통신 파일 **최상단에 다음 YAML 블록 필수**:
|
|
|
|
```yaml
|
|
---
|
|
from: <발신자> # 예: 총괄PM, 개발실장, 기획팀장, 클라이언트팀장 등
|
|
to: <수신자> # 예: 개발실, 기획실, 총괄PM (조직 단위 또는 개인)
|
|
type: <유형> # 업무지시 | 검토요청 | 상태질의 | REQ | 응답 | 일일보고 | 상태보고 | 블로커
|
|
subject: <제목> # 파일명 제목과 동일
|
|
ref: <참조 경로> # 선행 파일 있을 시 상대경로 (없으면 생략)
|
|
priority: normal | high | urgent
|
|
status: 대기 | 처리중 | 완료 | 보류 | 취소
|
|
created: YYYY-MM-DD
|
|
due: <희망처리시점> # 없으면 생략 (C15: 기한 개념 배제, 우선순위로만 관리)
|
|
---
|
|
```
|
|
|
|
본문 구조 자유. 단 장문은 `## 요청 내용`, `## 맥락`, `## 응답 필요 항목` 같은 섹션 구분 권장.
|
|
|
|
---
|
|
|
|
## 응답 처리 절차
|
|
|
|
### 수신자 측
|
|
1. 파일 상단 YAML 확인 → priority·type 파악
|
|
2. 본문 읽고 처리
|
|
3. **응답 방식 선택**:
|
|
- **같은 파일에 `## 응답` 섹션 추가**: 간단한 확인·답변
|
|
- **반대 방향 채널에 신규 파일 작성**: 독립 안건으로 관리해야 할 응답
|
|
4. 원본 파일의 YAML `status` 를 `완료` 또는 `처리중` 으로 갱신
|
|
5. `완료` 처리 시 원본을 `완료/` 디렉토리로 `git mv`
|
|
|
|
### 발신자 측
|
|
- 응답 파일이 자기 수신 채널에 도착하면 SessionStart hook(Phase 2)이 자동 알림
|
|
- 응답 확인 후 원본은 이미 `완료/` 에 있거나, 수신자가 이동하지 않았다면 발신자가 이동 가능
|
|
|
|
---
|
|
|
|
## 커밋 메시지 규칙
|
|
|
|
통신 파일 커밋 시 prefix 표준 (NAS post-receive hook 패턴 매칭·Phase 3):
|
|
|
|
| prefix | 의미 |
|
|
|--------|------|
|
|
| `comm(req):` | 신규 요청 발송 |
|
|
| `comm(ans):` | 응답 발송 |
|
|
| `comm(rpt):` | 보고·상태 공유 |
|
|
| `comm(mv):` | 완료 아카이브 이동 |
|
|
|
|
예: `comm(req): PM→개발실 C21 초안 v2 검토 요청`
|
|
|
|
---
|
|
|
|
## C21(초안)과의 관계
|
|
|
|
- C21-1(작업 완료 즉시 push): 통신 파일 생성·응답 작성 시점에 **안건 단위로 1회 push**
|
|
- C21-2(PM 능동 fetch): PD님이 "개발실·기획실 현황 체크" 지시 시 PM이 즉시 fetch 후 `PM`방향 inbox 스캔
|
|
|
|
## 연관 코어룰
|
|
- **C13** (PD 지시 트래킹): PD님 지시 수령분은 본 허브의 PM→ 채널로 하달 시 그 경로 자체가 트래킹 로그
|
|
- **C17·C18** (세션 도달·공유 완료): 본 허브 변경은 push + 수신 세션 pull·hook 감지까지가 "도달"
|
|
- **C21**(초안, 부서 검토중): 즉시 push·능동 fetch
|
|
- **C22** (용어 일관): 본 README의 용어(채널명·type·status 값)를 임의 변경 금지
|
|
|
|
## 마이그레이션 주석
|
|
2026-04-15 Phase 1 신설과 함께 기존 `공유/기획실→개발실/`, `공유/개발실→기획실/`, `공유/완료/` 는 본 허브 하위로 통합 이관됨. 미처리 REQ001~003(2026-04-14)은 현재 `공유/소통/기획실→개발실/` 에 위치.
|