오프라인 저장소: 플랫폼 동작
오프라인 저장소에 대한 사용자 흐름, 라이프사이클 상태, 권한 프롬프트, 오프라인 동작 및 플랫폼별 엣지 케이스를 정의합니다. 환경별 한계를 구성 가능하게 유지하면서 채택 경계와 관찰 가능한 실패 증거를 고정합니다.
패키지 상태: 참조 컨텍스트가 인간 검토를 위해 준비됨. 계약 및 테스트 시나리오는 완성되었으나, 채택 구현이 이를 통과했다는 주장은 없습니다.
결정
오프라인 저장소에 대해 명시적 네이티브 어댑터가 있는 플랫폼 중립 도메인 계약을 채택합니다. 가시적인 상태, 가능한 경우 되돌릴 수 있는 선택, 보존된 입력 및 접근 가능한 복구가 포함된 결정론적 사용자 여정을 정의합니다. 이 UX 블록은 플랫폼 동작에 특히 집중합니다. 이 패키지는 참조 계약이며, 채택 팀은 자체 환경의 증거를 바탕으로 수치 한계, 공급자, 관할권 및 운영 소유자를 선택해야 합니다.
범위
- 이 UX 블록의 플랫폼 동작 초점에 필요한 오프라인 저장소 행위자, 입력, 출력, 상태, 정책 또는 스키마 버전 및 외부에 보이는 결과.
- 기본 및 대체 인터페이스, 백그라운드 작업, 캐시, 통합, 지원 경로 및 동일 경계를 실행할 수 있는 증거.
- 참조를 안전하게 적용하기 위해 필요한 채택별 구성, 롤아웃, 복구 및 검증 책임.
이 블록에 포함되지 않는 사항
- 모든 채택자를 위한 범용 공급자, 프레임워크, 관할권, 수치 임계값, 보존 기간 또는 서비스 수준 목표 선택.
- 패키지된 시나리오가 하위 구현에서 실행되었거나 이 참조가 법적, 보안 또는 접근성 인증을 부여한다는 주장.
계약
- 기능이 의존하는 경우 포그라운드, 백그라운드, 종료됨, 오프라인, 복원됨, 로그아웃됨 및 권한 거부 상태를 모델링합니다.
- 운영 체제 콜백과 외부 링크를 신뢰할 수 없는 입력으로 처리하고 결과 도메인 작업을 재인가합니다.
- 민감한 키는 플랫폼 보호 시설을 통해서만 저장하고 알림, 로그, 백업 및 클립보드에 복사되는 값을 최소화합니다.
- 동기화 작업은 경과 시간 가정 대신 내구성 버전 또는 작업 식별자를 사용하여 멱등성을 보장합니다.
- 실제 작업이 대기 중일 때만 진행 상황을 표시하고 사용자의 확정된 의도를 숨기지 않으면서 중복 활성화를 방지합니다.
- 검증, 권한, 연결성, 충돌 및 최종 실패를 구분하는 평이하고 작업별 메시지를 사용합니다.
- 스키마, 계정, 테넌트, 소스 버전, 신선도 및 축출 정책과 함께 경계가 있는 암호화된 하위 집합을 저장하고 로그아웃, 권한 취소 또는 소유권 변경 시 제거합니다.
- 로컬 초안과 승인된 상태를 분리하고 내구성 ID가 있는 변형을 대기열에 넣으며 재연결 시 오래된, 대기 중인, 충돌된, 거부된 및 복구 불가능한 결과를 표시합니다.
- 플랫폼 동작 변형에 대해 이 선언된 경계를 시행합니다: 오프라인 저장소에 대한 사용자 흐름, 라이프사이클 상태, 권한 프롬프트, 오프라인 동작 및 플랫폼별 엣지 케이스를 정의합니다.
구현 지침
- 행복 경로 레이아웃을 고정하기 전에 가장 길고, 비어있고, 느리고, 오프라인이며, 거부되고, 보조 기술 경로를 프로토타입합니다.
- 프레임워크 또는 공급자 세부 정보를 선택하기 전에 오프라인 저장소 입력, 출력, 행위자, 상태, 불변 조건, 부작용 및 증거를 모델링합니다.
- 적용 가능한 오프라인 저장소 계약 또는 정책 버전을 물질 상태와 함께 저장하여 마이그레이션, 재생 및 지원 결정을 추적 가능하게 합니다.
- 통제된 롤아웃 뒤에 경로를 도입하고 예상 결과와 관찰된 결과를 비교하며 채택 증거가 완성될 때까지 테스트된 복구 경로를 유지합니다.
실패 처리 및 안전장치
- 중단된 네이티브 작업은 내구성 체크포인트에서 재개되거나 부작용을 중복하지 않고 안전한 가시 상태로 복귀합니다.
- 잘못되었거나 모순된 오프라인 저장소 상태는 거부되거나 격리되며, 구현은 권한을 확장하거나 효과를 중복하는 값을 추측하지 않습니다.
- 재시도는 한계가 있으며 내구성 ID를 사용합니다; 소진 후 작업은 책임 있는 소유자가 있는 검사 가능한 최종 상태에 도달합니다.
검증 및 운영
- 키보드, 터치, 화면 읽기 프로그램, 좁은 뷰포트, 지연된 네트워크 및 복구 가능한 서버 오류로 여정을 완료합니다.
- 민감한 페이로드 차원 없이 계약 버전별로 오프라인 저장소 성공, 거부, 검증 실패, 종속 실패, 재시도 소진 및 복구를 모니터링합니다.
- 정책, 스키마, 종속성, 마이그레이션 또는 경계 변경 후 양성 및 음성 픽스처를 다시 실행하고 결과 증거를 보존합니다.
채택 가정
- 예제의 이름과 값은 구체적인 픽스처이며 보편적 기본값이 아니며, 채택자는 문서화된 증거와 소유권을 통해 이를 교체합니다.
- 채택 시스템은 인증된 신원, 내구성 작업 또는 기록 버전, 경계가 있는 원격 측정 및 변경을 위한 통제된 경로를 제공할 수 있습니다.
이 패키지의 실행 가능한 예제처럼 보이는 것들은 픽스처 및 수용 계약입니다.
구조와 메타데이터를 확인하려면 컬렉션 검증기를 실행한 후, 대상 저장소에서 시나리오를 번역하고 실행하여 구현 증거를 기록하십시오.