daf6a0ade9
plan ds-s1-backend-1 잔여 구현 (A·C-1 은 16b0fe1):
- B 중복검사: services/dedup.py (OFF-list law_monitor 공용) + 업로드 채움(B-1)
+ GET /documents/duplicates(B-2) + post-upload near-dup 비동기(B-3)
+ backfill_dedup.py(B-4) + 야간 dedup_reconcile 잡(03:30 KST 멱등 재계산)
- C MD-first: marker_worker office/hwp 분기 _process_office(C-2) + md_status
상태머신 postcondition success|failed(C-5) + backfill_nonpdf_markdown.py(C-4)
+ requirements markitdown
- D 스토리지: services/storage ABC+Range 계약 / LocalBackend / NasApiBackend 503
(D-1) + /file resolver 경유, 로컬 동작 불변(D-2)
- E 운영: pre-change pg_dump + rollback_287.sql + apply runbook(E-3) + 테스트(E-1)
비파괴 불변식 유지(기존 응답 shape 무변경, md_status success→completed read-time 매핑).
어드버서리얼 리뷰 확정 1건(soft-delete canonical 승격 시 stale duplicate_of) → B-1
승격 정규화 + 야간 재계산으로 정합.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
34 lines
1.2 KiB
Python
34 lines
1.2 KiB
Python
"""NasApiBackend — 외부 스토리지(맥미니4TB / NAS Docker API) stub (plan D-1).
|
|
|
|
★ 미프로비전 = 503. silent fallback 금지(다른 백엔드로 자동 우회 X). 실 프로비전 후
|
|
D-3 에서 활성화. infra_inventory.md 갱신(Update Rule) 이 선행이다.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from collections.abc import AsyncIterator
|
|
|
|
from .base import StatResult, StorageBackend, StorageNotConfigured
|
|
|
|
_MSG = "NasApiBackend 미구성 — 외부 스토리지 프로비전 후 활성(D-3). silent fallback 없음."
|
|
|
|
|
|
class NasApiBackend(StorageBackend):
|
|
is_local = False
|
|
|
|
def __init__(self, base_url: str | None = None) -> None:
|
|
self._base_url = base_url
|
|
|
|
def local_path(self, rel_path: str) -> os.PathLike[str] | None:
|
|
return None
|
|
|
|
async def stat(self, rel_path: str) -> StatResult:
|
|
raise StorageNotConfigured(_MSG)
|
|
|
|
async def stream(
|
|
self, rel_path: str, *, start: int | None = None, end: int | None = None
|
|
) -> AsyncIterator[bytes]:
|
|
raise StorageNotConfigured(_MSG)
|
|
yield b"" # 도달 불가 — async generator 형태 유지용(호출부 `async for` 계약 일치).
|