Skip to content

Code Flow Diagrams

ClarusIubar edited this page May 3, 2026 · 4 revisions

코드 흐름 다이어그램

JamIssue의 주요 실행 흐름을 Mermaid로 정리합니다.

배포 흐름

flowchart LR
    A["main merge"] --> B["GitHub Actions"]
    B --> C["Pages build"]
    B --> D["Worker deploy"]
    C --> E["daejeon.jamissue.com"]
    D --> F["api.daejeon.jamissue.com"]
Loading

로그인 흐름

flowchart TD
    A["login click"] --> B["OAuth start"]
    B --> C["provider auth"]
    C --> D["callback code"]
    D --> E["token exchange"]
    E --> F["profile lookup"]
    F --> G["identity mapping"]
    G --> H["session issue"]
Loading

지도 bootstrap 흐름

flowchart TD
    A["client request"] --> B["Worker route"]
    B --> C["base data service"]
    C --> D["Supabase adapter"]
    D --> E["row data"]
    E --> F["DTO mapper"]
    F --> G["client response"]
Loading

알림 흐름

flowchart TD
    A["comment event"] --> B["notification write"]
    B --> C["SSE event"]
    C --> D["client store"]
    D --> E["notification panel"]
Loading

리팩터 목표 흐름

flowchart LR
    A["routing"] --> B["use case"]
    B --> C["repository / adapter"]
    C --> D["mapper"]
    D --> E["response"]
Loading

관련 문서

리뷰/댓글/알림 흐름

flowchart TD
    A["사용자 댓글 작성"] --> B["Worker route"]
    B --> C["comment use case"]
    C --> D["owner/permission check"]
    D --> E["comment repository"]
    E --> F["notification service"]
    F --> G["notification repository"]
    G --> H["SSE event"]
    H --> I["client notification store"]
Loading

마이페이지 흐름

flowchart TD
    A["GET /api/my/summary"] --> B["session user 확인"]
    B --> C["my summary service"]
    C --> D["stamp repository"]
    C --> E["review repository"]
    C --> F["notification repository"]
    D --> G["summary mapper"]
    E --> G
    F --> G
    G --> H["client response"]
Loading

공공데이터 import 흐름

flowchart TD
    A["internal import request"] --> B["import token check"]
    B --> C["external data fetch"]
    C --> D["normalize rows"]
    D --> E["dedupe"]
    E --> F["Supabase upsert"]
    F --> G["import result"]
Loading

Wiki/Issue handoff 흐름

flowchart TD
    A["Parent issue"] --> B["Sub issue"]
    B --> C["Checklist"]
    C --> D["Implementation"]
    D --> E["Validation evidence"]
    E --> F["PR"]
    F --> G["main merge"]
    G --> H["Release/Wiki update"]
Loading

API 호환성 검증 흐름

flowchart LR
    A["backend change"] --> B["contract test"]
    B --> C["web client check"]
    B --> D["app compatibility note"]
    C --> E["PR evidence"]
    D --> E
Loading

CodeQL finding 처리 흐름

flowchart TD
    A["CodeQL finding"] --> B["파일/라인 확인"]
    B --> C["stale 여부 확인"]
    C --> D["원인 수정"]
    D --> E["local validation"]
    E --> F["push / PR"]
    F --> G["security-quality 재확인"]
Loading

Clone this wiki locally