Compare commits
2 Commits
3904309a14
...
c510e840ae
| Author | SHA1 | Date | |
|---|---|---|---|
| c510e840ae | |||
| 72eb1a46d7 |
@ -30,6 +30,7 @@ tags: [infra, workflow, docs, operations]
|
||||
| [51123_log_ingest_recovery_workflow.md](./51123_log_ingest_recovery_workflow.md) | 51123 Fluent Bit -> OpenSearch 로그 적재 복구 절차 |
|
||||
| [51124_remote_workspace_config_operations_workflow.md](./51124_remote_workspace_config_operations_workflow.md) | 24 서버 SSH 접속과 workspace-config 원격 수정·검증 |
|
||||
| [local_developer_workflow.md](./local_developer_workflow.md) | 로컬 PC 워크스페이스 레포 동기화·푸시 |
|
||||
| [shared_editing_draft_collaboration_workflow.md](./shared_editing_draft_collaboration_workflow.md) | NAS `shared-editing/drafts` 초안 교환·잠금·결과 보고 절차 |
|
||||
|
||||
## 관련 문서
|
||||
- [../README.md](../README.md)
|
||||
|
||||
76
workflow/shared_editing_draft_collaboration_workflow.md
Normal file
76
workflow/shared_editing_draft_collaboration_workflow.md
Normal file
@ -0,0 +1,76 @@
|
||||
---
|
||||
type: workflow
|
||||
tags: [infra, workflow, shared-editing, nas, drafts, collaboration]
|
||||
last_updated: 2026-03-23
|
||||
---
|
||||
|
||||
# 공유편집 드래프트 협업 워크플로우
|
||||
|
||||
## 상위 원칙
|
||||
- [../../../0_VALUE/README.md](../../../0_VALUE/README.md)
|
||||
- [../../../0_VALUE/20_Governance/project-artifacts-ssot.md](../../../0_VALUE/20_Governance/project-artifacts-ssot.md)
|
||||
- [../../../0_VALUE/20_Governance/infrastructure-ssot-principle.md](../../../0_VALUE/20_Governance/infrastructure-ssot-principle.md)
|
||||
- `/mnt/nas/workspace/shared-editing/README.md`
|
||||
|
||||
## 정의
|
||||
|
||||
- `/mnt/nas/workspace/shared-editing/`는 23·24 서버 에이전트가 git push/pull 없이 초안, 질의, 리뷰를 교환하는 NAS 협업 공간입니다.
|
||||
- `drafts/`는 자유 작성·토의·임시 메모의 단일 위치입니다.
|
||||
- 확정본은 각 git 레포로 이관한 뒤 `archive/`로 옮깁니다.
|
||||
|
||||
## 적용 기준
|
||||
|
||||
- 파일명은 서버 접두를 붙여 작성합니다. 예: `[23]_주제.md`, `[24]_주제.md`.
|
||||
- 상대 서버 초안은 같은 `drafts/`에서 직접 읽고, 내 답글은 새 파일로 작성합니다.
|
||||
- 같은 파일을 수정할 때만 `scripts/lock.sh`로 잠금합니다. 새 파일 작성은 잠금 없이 시작할 수 있지만, 기존 파일 수정이면 잠금이 필수입니다.
|
||||
- `/mnt/nas/workspace/shared-editing/`에는 일반 셸 리다이렉션(`>`) 쓰기 실패 가능성이 있으므로 `lock.sh`, `sudo tee`, 또는 그와 동등한 안전한 쓰기 절차를 사용합니다.
|
||||
- watch/감시 루프는 `감지`로 끝내지 않습니다. `watch 실행 -> 감지 -> drafts 결과 보고 작성`까지 한 작업 단위로 완료합니다.
|
||||
- 24 서버 Codex는 대기 감시가 필요할 때 `/home/admin/scripts/watch_and_report.sh`를 우선 사용합니다.
|
||||
|
||||
## 표준 흐름
|
||||
|
||||
### 1. 드래프트 식별
|
||||
|
||||
- 먼저 `drafts/`에서 주제 파일을 찾고, 작성자·날짜·요청 대상을 읽습니다.
|
||||
- "드래프트가 무엇인가"라는 질문에는 `shared-editing/README.md` 기준으로 "`drafts/`는 자유 작성·토의·임시 메모 공간"이라고 답합니다.
|
||||
|
||||
### 2. 서버 식별
|
||||
|
||||
- 현재 셸이 어느 서버인지 추정하지 않습니다.
|
||||
- 답글에 서버 정체성을 적기 전 `hostname`으로 확인합니다.
|
||||
- 24 서버라고 말할 때는 `hostname` 또는 infra SSOT로 교차 확인된 근거가 있어야 합니다.
|
||||
|
||||
### 3. 초안 작성
|
||||
|
||||
- 기존 파일에 덧붙이지 말고 새 답글 파일을 만듭니다.
|
||||
- 권장 파일명: `[24]_YYMMDD_주제_24codex.md`, `[23]_YYMMDD_주제_23claude.md`
|
||||
- 본문에는 최소한 다음을 분리해 씁니다.
|
||||
- 확인한 사실
|
||||
- 의견 또는 판단
|
||||
- 필요한 후속 액션
|
||||
|
||||
### 4. 기존 파일 수정
|
||||
|
||||
- 기존 파일을 수정할 때만 아래 순서를 지킵니다.
|
||||
|
||||
```bash
|
||||
cd /mnt/nas/workspace/shared-editing
|
||||
./scripts/lock.sh drafts/topic.md 24
|
||||
# 안전한 편집 수행
|
||||
./scripts/lock.sh drafts/topic.md 24 unlock
|
||||
```
|
||||
|
||||
- 잠금이 실패하면 상대 서버가 편집 중인 것이므로 새 답글 파일로 회신하고, 원본 덮어쓰기를 시도하지 않습니다.
|
||||
|
||||
### 5. 결과 보고
|
||||
|
||||
- 답글을 쓴 뒤 파일 경로와 핵심 결론을 상대가 바로 읽을 수 있게 남깁니다.
|
||||
- 합의가 끝난 문서만 각 git 레포로 이관합니다.
|
||||
- 이관 후 원본 초안은 `archive/`로 옮깁니다.
|
||||
|
||||
## 검증 기준
|
||||
|
||||
- `drafts/`에 새 파일이 실제로 생성되었는지 확인합니다.
|
||||
- 파일명 접두가 서버 기준과 맞는지 확인합니다.
|
||||
- 링크, 경로, 명령 예시는 최소 1회 다시 읽어 오탈자와 경로 오류를 점검합니다.
|
||||
- "완료" 보고는 실제 파일 생성 또는 수정 결과를 확인한 뒤에만 합니다.
|
||||
Loading…
x
Reference in New Issue
Block a user