초안 및 게시: 저장, 안전성 및 운영
초안 및 게시를 위한 데이터 구조, 렌더링, 권한, 중재 제어, 감사 추적, 테스트 및 운영을 명시합니다. 환경별 제한을 구성 가능하게 유지하면서 채택 경계와 관찰 가능한 실패 증거를 고정합니다.
패키지 상태: 인간 검토를 위한 참조 컨텍스트 준비 완료. 계약 및 테스트 시나리오는 완성되었으나, 채택 구현이 이를 통과했다는 주장은 하지 않습니다.
결정
초안 및 게시를 위해 버전 관리된 콘텐츠 기록과 중재 상태 기계를 채택합니다. 하나의 권위 있는 쓰기 경로, 타입화된 인터페이스, 명시적 상태, 멱등 부작용 처리를 통해 동작을 구현합니다. 이 패키지는 참조 계약이며, 채택 팀은 자체 환경의 증거를 바탕으로 숫자 제한, 공급자, 관할권, 운영 소유자를 선택해야 합니다.
범위
- 이 구현 블록에서 설명하는 초안 및 게시 행위자, 입력, 출력, 상태, 정책 또는 스키마 버전, 외부에 보이는 결과.
- 기본 및 대체 인터페이스, 백그라운드 작업, 캐시, 통합, 지원 경로, 동일 경계를 실행할 수 있는 증거.
- 참조를 안전하게 적용하기 위해 필요한 채택별 구성, 롤아웃, 복구 및 검증 책임.
이 블록 외부
- 모든 채택자를 위한 보편적 공급자, 프레임워크, 관할권, 숫자 임계값, 보존 기간 또는 서비스 수준 목표 선택.
- 패키지된 시나리오가 하위 구현에서 실행되었다거나 이 참조가 법적, 보안 또는 접근성 인증을 부여한다고 주장하는 것.
계약
- 원본 입력을 정규화되거나 렌더링된 출력과 별도로 저장하고 사용된 변환기 및 정책 버전을 식별합니다.
- 실제 출력 컨텍스트에 맞게 정화하며, 파싱, Markdown 변환, MIME 라벨은 활성 콘텐츠를 신뢰할 수 있게 하지 않습니다.
- 생성, 편집, 게시, 중재, 항소, 삭제 작업을 독립적으로 승인하고 실질적인 결정 추적을 유지합니다.
- 보류, 허용, 제한, 거부, 항소, 제거 상태를 명시적으로 표현하며 가시성 플래그를 과부하하지 않습니다.
- 경계에서 입력을 한 번 검증하고 하위 로직에서 사용하는 정규화된 표현을 보존합니다.
- 비즈니스 전환을 아웃박스 레코드와 원자적으로 또는 그 이전에 영속화하며, 소비자는 내구성 있는 작업 ID로 중복 제거합니다.
- 권한 있는 전환과 불변의 게시 증거를 가진 초안, 검토, 예약, 게시, 대체, 보관, 제거 상태를 모델링합니다.
- 게시 시 정확한 개정, 대상, 로케일, 정책 결과, 시간을 고정하며, 이후 편집은 새 초안을 생성하고 이미 게시된 개정을 조용히 변경할 수 없습니다.
구현 지침
- 추가적인 저장 및 인터페이스 변경을 먼저 배포하고, 관찰 가능하게 백필한 후 호환성 증거가 확보되면 이전 경로를 폐기합니다.
- 프레임워크나 공급자 세부사항을 선택하기 전에 초안 및 게시 입력, 출력, 행위자, 상태, 불변 조건, 부작용, 증거를 모델링합니다.
- 적용 가능한 초안 및 게시 계약 또는 정책 버전을 실질 상태와 함께 저장하여 마이그레이션, 재생, 지원 결정이 추적 가능하도록 합니다.
- 통제된 롤아웃 뒤에 경로를 도입하고 예상 결과와 관찰된 결과를 비교하며, 채택 증거가 완성될 때까지 테스트된 복구 경로를 유지합니다.
실패 처리 및 안전장치
- 안전하지 않거나 분류할 수 없는 콘텐츠는 기본적으로 사용할 수 없으며 제한된 검토 또는 거부 경로로 들어갑니다.
- 잘못되었거나 모순된 초안 및 게시 상태는 거부되거나 격리되며, 구현은 권한을 확장하거나 부작용을 중복시키는 값을 추측하지 않습니다.
- 재시도는 제한되며 내구성 있는 ID를 사용합니다; 소진 후 작업은 검사 가능한 최종 상태에 도달하며 책임 있는 소유자가 있습니다.
검증 및 운영
- 영속화 전후에 의존성 실패를 주입하고 재시도가 하나의 외부 가시 결과로 수렴함을 증명합니다.
- 계약 버전별로 초안 및 게시 성공, 거부, 검증 실패, 의존성 실패, 재시도 소진, 복구를 민감한 페이로드 차원 없이 모니터링합니다.
- 정책, 스키마, 의존성, 마이그레이션 또는 경계 변경 후 양성 및 음성 픽스처를 재실행하고 결과 증거를 보존합니다.
채택 가정
- 예제의 이름과 값은 구체적인 픽스처이며 보편적 기본값이 아니므로, 채택자는 문서화된 증거와 소유권을 통해 이를 교체합니다.
- 채택 시스템은 인증된 신원, 내구성 있는 작업 또는 기록 버전, 제한된 원격 측정, 변경을 위한 통제된 경로를 제공할 수 있습니다.
이 패키지의 실행 가능한 예제는 픽스처 및 수용 계약입니다. 구조와 메타데이터를 확인하려면 컬렉션 검증기를 실행한 후 대상 저장소에서 시나리오를 번역하고 실행하여 구현 증거를 기록하세요.