Running App

flowchart LR
    subgraph Clients
      Web[React Web]
      iOS[SwiftUI iOS]
    end
    subgraph Backend["Spring Boot"]
      API[REST API]
      JWT[JWT 인증]
      Event[Spring Events]
      Async[Async Listeners]
      API --> JWT
      API --> Event
      Event --> Async
    end
    subgraph Data
      PG[(PostgreSQL)]
      Redis[(Redis)]
    end
    subgraph Infra
      Nginx[Nginx]
      NCP[NCP Cloud]
    end
    Web --> Nginx
    iOS --> Nginx
    Nginx --> API
    API --> PG
    API --> Redis
    Async --> PG

erDiagram
    users ||--o{ running_activity : "기록"
    users ||--o{ user_challenge : "참여"
    users ||--o{ user_plan : "등록"
    challenge ||--o{ user_challenge : "포함"
    training_plan ||--o{ plan_week : "구성"
    training_plan ||--o{ user_plan : "포함"

    users {
      bigint id PK
      varchar email UK
      varchar password
      varchar nickname
      int level
      double total_distance
      double weight
      double height
    }
    running_activity {
      bigint id PK
      bigint user_id FK
      double distance
      int duration
      double pace
      int heart_rate
      int cadence
      json route
      varchar memo
      datetime created_at
    }
    challenge {
      bigint id PK
      varchar name
      enum type
      double target_distance
      int target_count
      date start_date
      date end_date
      int recommended_level
    }
    user_challenge {
      bigint id PK
      bigint user_id FK
      bigint challenge_id FK
      double current_distance
      int current_count
      datetime joined_at
      datetime completed_at
    }
    training_plan {
      bigint id PK
      varchar name
      enum goal_type
      enum difficulty
    }
    plan_week {
      bigint id PK
      bigint plan_id FK
      int week_number
      double target_distance
      int target_run_count
    }
    user_plan {
      bigint id PK
      bigint user_id FK
      bigint plan_id FK
      int current_week
      datetime started_at
      datetime completed_at
    }

sequenceDiagram
    participant C as Client
    participant API as Controller
    participant AS as ActivityService
    participant E as EventPublisher
    participant UL as UserLevelListener
    participant CL as ChallengeListener
    participant PL as PlanListener
    C->>API: POST /api/activities
    API->>AS: createActivity
    AS->>AS: save to DB
    AS->>E: publish ActivityCreatedEvent
    AS-->>API: Activity
    API-->>C: 201 Created
    Note over E,PL: AFTER_COMMIT 비동기 처리
    par 병렬 실행
      E->>UL: onActivityCreated
      UL->>UL: updateUserLevel
    and
      E->>CL: onActivityCreated
      CL->>CL: updateChallengeProgress
    and
      E->>PL: onActivityCreated
      PL->>PL: updatePlanProgress
    end

sequenceDiagram
    C->>API: POST /api/challenges/{id}/join
    API->>CS: joinChallenge
    CS->>CS: validate eligibility
    CS->>UC: save UserChallenge
    API-->>C: 200 OK

sequenceDiagram
    C->>API: POST /api/plans/{id}/start
    API->>PS: startPlan
    PS->>PS: check not already enrolled
    PS->>UP: save UserPlan
    API-->>C: 200 OK