끼리 (KKIRI) — 유저 플로우

flowchart TD
  home["home · S0<br/>랜딩 · 주제 선택"] ==>|"팀 워크숍 카드"| setup["setup · S1<br/>인원 3~8 · 마감 · 초대 방식 · 방장 이름"]
  setup ==>|"초대방 만들기"| invite["invite · S2<br/>링크 · 코드 · 공유 시트 · 참여 현황"]
  invite ==>|"내 답변 시작하기"| join["join · S3<br/>비공개 약속 · 이름"]
  join ==>|"약속 확인"| q["questions · S4<br/>6문항 (상한 토글 · 1·2순위 · 자유서술)"]
  q ==>|"내 대리인 보내기"| waiting["waiting · S5<br/>내 대리인 카드 · 참여 현황 · 마감"]
  waiting -->|"답변 고치기 (시작 전)"| q
  waiting ==> allDone{{"전원 답변?"}}
  allDone ==>|"예 · 3초 뒤 자동"| nego["negotiating · S6<br/>4단계 + 익명 발언 로그"]
  allDone -->|"아니오"| startNow{"방장:<br/>지금 협상 시작?"}
  startNow -->|"확인 모달 · 미응답 조건 미반영"| nego
  startNow -->|"기다림"| deadline{{"답변 마감 도달"}}
  deadline -.->|"답변 ≥ 3명 · 자동 시작"| nego
  deadline -.->|"답변 < 3명"| expired["expired<br/>아직 시작할 수 없어요"]
  expired -.->|"24h 연장 (최대 2회)"| waiting
  expired -.->|"방 닫기"| home
  nego ==> ok{{"거부권 통과<br/>후보 ≥ 1?"}}
  ok ==>|"예"| result["result · S7<br/>최종안 · 이유 · 양보 · 공정성 · 차선"]
  ok -.->|"아니오"| noc["noCandidate<br/>모든 조건을 지키는 안이 없어요"]
  noc -.->|"상한 완화 익명 동의 요청 / 방 닫기"| home
  result ==>|"내 대리인 리포트 (본인만)"| receipt["receipt · S8<br/>지켜진 조건 · 양보 · 내 만족도"]
  receipt ==>|"최종 의견 보내기"| ratify["ratify<br/>동의 / 조건부 / 재조율 → 익명 집계"]
  result -->|"최종 의견 보내기"| ratify
  ratify --> renego{{"재조율 요청 있음?"}}
  renego -.->|"예 · 방당 1회"| nego
  renego ==>|"아니오 · 전원 응답 또는 24h 마감"| confirm{"방장:<br/>결정 확정"}
  confirm ==> done["done · S9<br/>확정 카드 · 공유 · .ics · 실행 체크"]
  done -->|"새 결정 시작하기"| home

  classDef screen fill:#fff,stroke:#171717,stroke-width:1.5px
  classDef exc fill:#fef2f2,stroke:#b91c1c,stroke-dasharray:4 3
  classDef sys fill:#ecfdf5,stroke:#0f766e
  class home,setup,invite,join,q,waiting,nego,result,receipt,ratify,done screen
  class expired,noc exc
  class allDone,deadline,ok,renego sys

flowchart TB
  subgraph H["방장"]
    direction TB
    h1["주제 선택"] --> h2["인원 · 마감 · 초대 방식 · 이름"] --> h3["초대 링크 공유<br/>카톡 · 슬랙 · 문자 · QR · 복사 · 캘린더"]
    h3 --> h4["참여 현황 확인"]
    h4 --> h5{"전원 완료 전<br/>시작할까?"}
    h5 -->|"예"| h6["확인 모달 → 시작"]
    h5 -->|"아니오"| h7["미응답자 다시 알림<br/>(30분 쿨다운)"]
    h8["재확인 집계 확인"] --> h9["결정 확정하기"]
  end
  subgraph P["참가자 (방장 포함)"]
    direction TB
    p1["링크 · 코드로 입장"] --> p2["비공개 약속 · 이름"] --> p3["6문항 답변<br/>상한 = 거부권"] --> p4["자유서술 구조화 확인"] --> p5["대기실<br/>내 대리인 카드"]
    p6["결과 열람"] --> p7["내 리포트 (본인만)"] --> p8["최종 의견<br/>동의 / 조건부 / 재조율"]
  end
  subgraph S["시스템"]
    direction TB
    s1["방 · 링크 · 코드 생성"] --> s2["리마인드<br/>남은 시간 절반 · 마감 1h 전"] --> s3{{"마감 도달"}}
    s3 -->|"≥3명"| s4["협상 시작<br/>익명 구조화 → 거부권 → 최저 만족도 → 설명"]
    s3 -->|"<3명"| s5["연장 제안 (최대 2회)"]
    s4 --> s6["합의 제안 + 개인 리포트"]
    s6 --> s7["재확인 집계 · 24h 마감<br/>미응답 = 기권"]
    s7 -->|"재조율 1회"| s4
  end
  h2 --> s1
  h3 --> p1
  p5 --> s3
  h6 --> s4
  s6 --> p6
  s6 --> h4
  p8 --> s7
  s7 --> h8

stateDiagram-v2
  [*] --> Draft: 주제 선택
  Draft --> Collecting: 초대방 만들기<br/>마감 = 3h / 자정 / 24h(기본) / 48h
  note left of Collecting
    참가자 입장 · 답변 수집
    자동 리마인드 2회 (T/2, T-1h)
    수동 리마인드 (30분 쿨다운)
  end note
  Collecting --> Negotiating: ① 전원 답변 → 3초 뒤 자동<br/>② 방장 조기 시작 (미응답 조건 미반영 모달)<br/>③ 마감 도달 · 답변 ≥ 3명 → 자동 시작 배너
  Collecting --> Expired: 마감 도달 · 답변 < 3명
  Expired --> Collecting: 24h 연장<br/>(최대 2회)
  Expired --> Closed: 방 닫기
  Negotiating --> Proposed: 거부권 통과 후보 ≥ 1<br/>LLM 설명 30초 초과 시 규칙 문장 폴백
  Negotiating --> NoCandidate: 후보 0개
  NoCandidate --> Closed: 방 닫기 / 상한 완화 요청
  Proposed --> Ratifying: 재확인 시작 (마감 24h)
  Ratifying --> Ratifying: 동의 · 조건부 · 재조율 (익명 집계)
  Ratifying --> Negotiating: 재조율 요청 (방당 1회)
  Ratifying --> Confirmed: 방장 확정<br/>조건 = 재조율 0 ∧ (전원 응답 ∨ 24h 경과)
  Confirmed --> Closed: 7일 읽기 전용 후 원문 삭제 ※ 기간 미확정
  Closed --> [*]

flowchart TD
  j["join · 이름 입력"] --> q1["1/6 방식<br/>실내 · 야외 · 반반"]
  q1 --> q2["2/6 시간<br/>반나절 · 하루 · 1박 2일<br/>☐ 이 이상은 어려워요 (거부권)"]
  q2 --> q3["3/6 목적 1·2순위<br/>팀워크 · 재충전 · 아이디어"]
  q3 --> q4["4/6 지역<br/>도심 · 근교 · 무관"]
  q4 --> q5["5/6 1인 예산<br/>3만 · 5만 · 10만 · 상관없음<br/>☐ 이 금액 넘으면 어려워요 (거부권)"]
  q5 --> q6["6/6 이것만은 피하고 싶어요<br/>자유서술 1줄 (선택)"]
  q6 --> parse{{"구조화<br/>(목업: 키워드 규칙 · 실제: LLM)"}}
  parse -->|"성공"| confirm["이렇게 이해했어요:<br/>운전 없는 동선 · 맞나요?"]
  parse -->|"실패"| fail["이 문장은 조건으로 바꾸지 못했어요<br/>다음 버튼 비활성"]
  fail -->|"다시 쓰기"| q6
  fail -->|"건너뛰기"| w
  confirm -->|"내 대리인 보내기"| w["waiting · 대기실"]
  q6 -->|"비워 두고 건너뛰기"| w
  q1 -.->|"← 이전"| j
  q2 -.->|"← 이전 (선택 유지)"| q1
  w -.->|"답변 고치기 (협상 시작 전)"| q1
  classDef veto fill:#fff7ed,stroke:#c2410c
  class q2,q5,q6,confirm veto

sequenceDiagram
  autonumber
  actor H as 방장
  participant S as 서버 (목업: localStorage)
  participant C as 초대 채널<br/>카톡 · 슬랙 · 문자
  actor P as 참가자

  H->>S: 초대방 만들기 (인원 N, 마감 T, 초대 방식)
  alt 공용 링크 + 입장 코드 (친구 · 가족 · 카톡)
    S-->>H: r/{room} + 6자리 코드
    H->>C: 링크 + 코드 한 번 공지
    C->>P: 링크 확인
    P->>S: 코드 입력 · 닉네임
    S-->>P: 입장 (정원 차면 닫힘)
    Note over S,P: 미입장자는 "참가자 N"으로만 표시<br/>같은 사람 재입장은 코드로 막지 못함
  else 이름별 개인 링크 (직장 팀 · 슬랙 · 메일)
    H->>S: 이름 N-1개 입력
    S-->>H: r/{room}/p/{token} 사람마다
    H->>P: 각자에게 개인 링크 전송
    P->>S: 토큰으로 입장 (중복 불가)
    Note over S,P: 방장은 "누가 미응답"까지 앎<br/>답변 내용은 여전히 못 봄<br/>토큰은 내 리포트 접근 인증에도 사용
  end
  P->>S: 6문항 답변 제출
  S-->>H: 참여 현황 갱신 (✓ 완료 · ● 작성 중 · ○ 미접속)
  loop 마감까지
    S->>C: 자동 리마인드 (T/2, T-1h) → 미응답자만
    H->>S: 수동 리마인드 (30분 쿨다운)
  end
  S-->>P: 링크 만료 = 답변 마감 시각

flowchart TD
  t0["T0 09:00<br/>방 생성 · 링크 공유"] --> t12["T/2 21:00<br/>자동 리마인드 1<br/>미응답자만"]
  t12 --> t23["T-1h 08:00<br/>자동 리마인드 2"]
  t23 --> T{{"T 09:00 마감"}}
  T -->|"답변 ≥ 3"| auto["자동 협상 시작<br/>결과에 미응답 N명 배너"]
  T -->|"답변 < 3"| ext["expired 화면"]
  ext -->|"연장 1회 → T+24h"| t0b["리마인드 다시 계산<br/>(T'/2, T'-1h)"]
  t0b --> T2{{"T' 마감"}}
  T2 -->|"≥ 3"| auto
  T2 -->|"< 3 · 연장 2회 소진"| close["방 닫기"]
  t0 -.->|"방장 수동 알림<br/>언제든 · 30분 간격"| t12
  auto --> r["result → ratify<br/>재확인 마감 +24h"]
  r -->|"24h 경과"| abstain["미응답 = 기권 집계<br/>방장 확정 가능"]
  classDef t fill:#f5f5f4,stroke:#6b7280
  class t0,t12,t23,t0b t

flowchart TD
  r["result · 합의 제안"] --> c{"내 최종 의견"}
  c -->|"동의해요"| send["보내기"]
  c -->|"조건부로 동의해요<br/>공개 가능한 실행 조건 1줄"| send
  c -->|"다시 조율해야 해요<br/>새 조건 비공개 추가 · 요청자 익명"| send
  send --> tally["응답 현황 (이름 없이 합계)<br/>동의 · 조건부 · 재조율 · 미응답"]
  tally --> hasR{{"재조율 요청 ≥ 1?"}}
  hasR -->|"예 · 방당 1회"| nego["negotiating 재실행<br/>새 조건 합쳐 재계산"]
  nego --> r2["result · 재조율 1회 반영 배너<br/>이후 재조율 버튼 비활성"]
  r2 --> c
  hasR -->|"아니오"| allIn{{"전원 응답?"}}
  allIn -->|"예"| host{"방장: 결정 확정하기"}
  allIn -->|"아니오"| wait["재확인 마감까지 대기<br/>참가자 화면: 방장의 확정을 기다리는 중"]
  wait -->|"24h 경과"| abst["미응답 = 기권 집계 배너"]
  abst --> host
  host --> done["done · 확정 카드<br/>실행 조건 체크리스트 포함"]
  classDef veto fill:#fff7ed,stroke:#c2410c
  class nego,r2 veto

flowchart LR
  subgraph E1["마감 미달 (shots 23)"]
    a1["마감 도달<br/>답변 2명"] --> a2["expired"] --> a3{"방장"}
    a3 -->|"24h 연장"| a4["waiting 복귀 · 연장 기록"]
    a3 -->|"방 닫기"| a5["home"]
  end
  subgraph E2["합의 불가 (shots 30)"]
    b1["반나절 상한 + 새벽 출발 금지"] --> b2["거부권 통과 후보 0개"] --> b3["noCandidate<br/>제외 사유는 주제만 표시"]
    b3 -->|"상한 완화 익명 동의 요청"| b4["상한 낸 사람 전원 동의 시 재계산 ※ 목업은 토스트"]
    b3 -->|"방 닫기"| b5["home"]
  end
  subgraph E3["LLM 타임아웃 (shots 29)"]
    c1["설명 생성 30초 초과"] --> c2["규칙 기반 문장으로 대체<br/>로그에 시스템 줄"] --> c3["result 배지<br/>설명은 간략하게 제공돼요"]
  end