af-social-scanner — 문서 인덱스

flowchart TD
    SP["social-sync-pipeline
전송 계층
token.flow 큐 구독 · DTO 파싱 · 저장 없음"]
    SCHEMA["social-schema-definition
스키마 계층
contents·accounts·venues·token_links 정의"]
    RP["social-recording-process
오케스트레이션 계층
dedupe → lock → Generator 라우팅 → 저장"]
    RC["reconcile-token
배치·복구 계층
/reconcile · /retry(1시간 크론)"]

    AUDIT["social-url-structure-audit
8소셜 URL 구조 실측 감사"]
    GEN["social-generator
8소셜별 fetch → 스키마 객체 변환"]

    E1["social-url-entry
URL 유입 창구 일원화"]
    E2["social-url-dedupe
재사용 캐시(TTL 14일)"]
    E3["lock-before-execute-recording
토큰 단위 동시성 락"]

    REFACTOR["social-recording-refactor
전체 관통 사후 수선"]

    SP --> RP
    SCHEMA --> RP
    RP --> RC
    AUDIT --> GEN
    GEN --> RP
    E1 --> E2 --> E3
    E3 --> RP
    REFACTOR -. 검증·수정 .-> SCHEMA
    REFACTOR -. 검증·수정 .-> RP

    classDef layer fill:#3b6cff22,stroke:#3b6cff,stroke-width:1.5px;
    classDef sub fill:#1a9c5322,stroke:#1a9c53,stroke-width:1.5px;
    classDef refactor fill:#b8720a22,stroke:#b8720a,stroke-width:1.5px,stroke-dasharray:4 3;
    class SP,SCHEMA,RP,RC layer;
    class AUDIT,GEN,E1,E2,E3 sub;
    class REFACTOR refactor;
    

stateDiagram-v2
    [*] --> pending : 신규 토큰의 URL 목록 선생성
    pending --> ok : 객체를 확정했다
    pending --> not_found : 불렀는데 대상이 없다
    pending --> blocked : 대상 쪽 사정(비공개·초대전용·IP차단)
    pending --> invalid : 200을 받았는데 응답이 계약을 깼다
    pending --> error : 외부 호출 실패 · DB 일시 오류
    pending --> unsupported : 담당 Generator가 없다(호출 0회)
    pending --> skipped_paid : 유료라 안 불렀다(호출 0회)

    not_found --> ok : 재시도로 결과가 바뀐다
    blocked --> ok : 차단이 풀린다
    error --> ok : 일시 오류가 지나간다
    error --> exhausted : attempts가 MAX_ATTEMPTS(5)에 닿았다

    ok --> ok : TTL(14일) 만료 후 재수집 — points가 쌓인다
    unsupported --> ok : 담당 Generator가 생기면
    skipped_paid --> ok : 유료 게이트를 켜면

    invalid --> [*] : 100% 같은 실패다 — 배치가 명시적으로 열어야 한다
    exhausted --> [*] : 상한에 닿았다 — 배치가 명시적으로 열어야 한다