유저 플로우

작성일: 2026-10-09 | 바탕: PRD

---

유저 타입

타입	설명	앱 내 역할
돌봄 보호자	발달장애인의 부모·가족. 정보를 가장 많이 보유	기록 작성·수정, 접근 권한 관리, 기관 선택
세컨드 보호자	보호자 부재 시 권한을 이어받는 사람	보호자와 동일한 권한 (부재 시 활성화)
활동 지원사 (기관 소속)	기관 하나에 소속되어 돌봄 서비스를 직접 제공. 활동 지원사 고유 번호 보유	기록 작성·열람, 수정 제안, 추가 정보 요청
기관 (사회 복지사)	활동 지원사를 관리하고 보호자와 정보를 중계	활동 지원사 배정·권한 지정, 보호자 연결·해제

발달장애인 당사자의 앱 직접 사용은 MVP 범위 밖

---

데이터 흐름

상세 다이어그램: data-flow.png · permission-flow.png

삶결 (시스템)
  - 대상자 고유 번호 관리
  - 기관 고유 코드 관리
  - 대상자 전반적 내용 관리
        │ 전반적인 내용
        ▼
기관 (기관 고유 코드)
  - 활동 지원사 추가/수정/삭제 (활동 지원사 고유 번호로 관리)
  - 활동 지원사별 열람 권한 지정
  - 돌봄 보호자 추가/제거 (대상자 고유 번호 이용)
  ┌──────────┴──────────┐
  │ 배치·권한 지정        │ 보호자 추가/제거
  ▼                     ▼
활동 지원사            돌봄 보호자 (대상자 고유 번호)
(활동 지원사 고유 번호)   ↑     │
  │  도전행동 작성         │     │ 도전행동 기록 열람
  │  추가 내용 요청/열람 ──┘     │ 추가 내용 작성
  └──────────────────────────────┘

방향	전달 내용
삶결 → 기관	전반적인 내용, 기관 고유 코드 발급
기관 → 활동 지원사	배치, 열람 권한 지정, 당사자 정보
기관 ↔ 돌봄 보호자	보호자 추가/제거 (대상자 고유 번호), 정보 연결
활동 지원사 → 돌봄 보호자	도전행동 기록 작성, 추가 내용 요청·열람
돌봄 보호자 → 활동 지원사	도전행동 기록 열람, 추가 내용 작성

권한 이동

상황	흐름
기관 이관	보호자가 기관 선택 → 삶결에 이관 요청 → 삶결이 새 기관에 정보 이관
보호자 부재	돌봄 보호자 권한 → 세컨드 보호자로 이동

---

1. 공통 — 온보딩

앱 첫 실행
  └→ 이용약관·개인정보 처리 동의 (/consent)
       └→ [동의] → 역할 선택
                    ├→ 돌봄 보호자 → 회원가입/로그인 → 홈 (/home)
                    ├→ 활동 지원사 → 소속 기관 코드 입력 (삶결이 기관 가입 시 발급한 코드) → 가입/로그인 → 홈 (/home)
                    └→ 기관 → 회원가입 → 삶결 기관 코드 자동 발급 → 로그인 → 홈 (/home)

---

2. 돌봄 보호자 플로우

2-1. 당사자 프로필 최초 등록

처음 로그인한 보호자가 당사자 정보를 등록하는 플로우

홈 (/home) — 등록된 당사자 없음
  └→ [당사자 등록하기]
       └→ 기본 정보 입력 (이름, 생년월일, 장애 유형, 고유 번호 등)
            └→ 등록 완료 → 홈 (당사자 카드 표시)

2-2. 생활기록 작성

홈 (/home) 또는 생활기록 탭 (/records)
  └→ [기록하기]
       └→ 기록 작성 (/records/new)
            ├→ 입력 방식 선택
            │    ├→ 텍스트 입력 → AI가 카테고리 자동 배정 (M6)
            │    │    → 카테고리 확인·수정 가능 (의사소통 방식 / 생활습관 / 식습관 / 선호·비선호 /
            │    │                              도전적 행동 / 건강 정보 / 위기 대처 방법 / 기타)
            │    └→ 음성 입력 → AI가 텍스트 변환 + 카테고리 자동 배정 (M6)
            │         → 내용·카테고리 확인 후 저장
            ├→ 미디어 첨부 (사진·영상·음성) — M2
            └→ [저장] → 생활기록 목록 (/records)

2-3. 중요 정보 핀 (상단 고정)

생활기록 목록 (/records)
  └→ 기록 카드 길게 누르기 또는 더보기 메뉴
       └→ [중요 정보로 고정]
            └→ 돌봄정보 탭 (/care-info) 최상단에 표시
                  └→ 새로운 돌봄 제공자가 가장 먼저 확인

2-4. 돌봄 관계 관리 (기관 경유 배정)

활동 지원사는 기관이 배정. 보호자가 직접 초대하지 않는다.

마이페이지 (/more) → [돌봄 관계 관리]
  └→ 기관이 배정한 활동 지원사 목록 표시
       ├→ 담당자 이름·기관명·접근 기간 확인
       ├→ [돌봄 종료] → 즉시 접근 권한 회수
       └→ [기관 이전]
            └→ 보호자: 새 기관 코드 입력 (기관 선택)
                 └→ 삶결에 이관 요청 → 삶결이 새 기관에 정보 이관
                      └→ 이전 완료 → 기존 기관 연결 해제, 새 기관으로 전환

2-5. 세컨드 보호자 지정 (초대 코드 발급)

보호자 부재 시 권한을 이어받을 사람을 미리 지정하는 플로우

마이페이지 (/more) → [세컨드 보호자 관리]
  └→ [세컨드 보호자 지정]
       └→ 이름·연락처 입력
            └→ 지정 완료 → 초대 코드(invitationToken) 발급
                 ├→ 초대 대상자에게 코드 전달 (외부 수단)
                 ├→ [수정] → 대상 변경
                 └→ [삭제] → 지정 해제

보호자 부재 시: 세컨드 보호자에게 돌봄 보호자와 동일한 권한 이동

2-6. 세컨드 보호자 초대 수락 (초대 받는 측)

초대 코드를 받은 사람이 앱 내에서 수락하는 플로우

마이페이지 (/more) → [세컨드 보호자 초대 수락] 섹션
  └→ 초대 코드 입력
       └→ [수락] → POST /api/auth/invitations/accept
            ├→ 성공: 상태 INVITED → READY 전환, 보호자가 ACTIVE 전환 후 접근 가능
            │         해당 당사자 정보 열람 권한 즉시 부여
            └→ 실패: 잘못된 코드 또는 만료 안내

2-7. 다수 당사자 전환

보호자가 여러 당사자를 등록한 경우 현재 대상을 전환하는 플로우

홈 (/home) 또는 마이페이지 (/more)
  └→ 당사자 전환 셀렉터 (listCareRecipients() 응답이 2건 이상일 때만 노출)
       └→ 다른 당사자 선택
            └→ setSelectedRecipient(id) 호출 → 앱 전역 컨텍스트 갱신
                 └→ 홈·기록·돌봄정보 등 전체 화면 데이터 전환된 당사자 기준으로 갱신

2-8. 활동지원사 수정 요청 검토

활동지원사가 돌봄 내용 수정 요청(RecordRequest)을 보냈을 때 보호자가 검토하는 플로우 (수정 제안(RecordSuggestion) 승인·거부와 별도 흐름)

[방법 A] 알림함 (/notifications)
  └→ RECORD_REQUEST_RECEIVED 알림 클릭
       └→ 수정 요청 검토 화면 (/more/record-requests)으로 이동

[방법 B] 마이페이지 (/more) → [수정 요청 검토]
  └→ 수신된 수정 요청 목록 (GET /api/care-recipients/{id}/record-requests)
       └→ 요청 선택
            ├→ [직접 기록 수정] → 해당 기록 편집 화면으로 이동
            └→ [반려 메시지 전송] → 반려 사유 입력 → 활동지원사에게 알림

---

3. 활동 지원사 플로우 (기관 소속)

3-1. 담당 당사자 정보 확인

소속 기관 코드 입력 (삶결 발급 코드) → 가입 → 홈 (/home)
  └→ 기관이 배정한 당사자 카드 표시
       └→ [당사자 정보 보기] → 돌봄정보 (/care-info)
            ├→ 중요 정보·주의사항 (핀된 항목)
            └→ 전체 생활기록 열람 (/records)

3-2. 기록 작성 및 일별 조회

생활기록 탭 (/records)
  ├→ [기록하기] → 기록 작성 (2-2 플로우와 동일, AI 카테고리 자동 배정)
  │    특히 도전행동 카테고리 기록 강조 (기관 요청 사항)
  └→ 날짜 선택 (캘린더) → 해당 날짜 기록 목록 → 상세 보기

3-3. 추가 정보 요청 (기관 경유)

마이페이지 (/more) → [보호자에게 추가 정보 요청]
  └→ 요청 내용 입력 (보호자에게 추가로 받고 싶은 정보)
       └→ [기관에 전달] → 기관(사회 복지사)이 보호자에게 중계

3-4. 수정 제안 (M7)

본인이 직접 작성한 기록은 직접 수정·삭제 가능. 보호자가 작성한 기록은 수정 제안만 가능 (보호자 승인 후 반영). 마이페이지에서 본인 작성 기록 이력 관리 및 복구 가능.

기록 상세 (/records/:id)
  ├→ [수정] — 본인이 작성한 기록인 경우
  │    └→ 직접 수정 → 저장 (수정 이력 기록)
  └→ [수정 제안] — 보호자가 작성한 기록인 경우
       └→ 변경 내용 입력
            └→ [제안 전송] → 보호자에게 알림
                 └→ 보호자 검토
                      ├→ [승인] → 기록 업데이트
                      └→ [거절] → 기존 기록 유지

---

4. 기관 플로우

4-1. 활동 지원사 배정

기관이 당사자와 활동 지원사를 연결하는 핵심 플로우

기관 대시보드 → 담당 당사자 목록
  └→ 당사자 선택 → [활동 지원사 배정]
       └→ 소속 활동 지원사 목록에서 선택
            └→ 접근 기간 설정 (시작일 ~ 종료일)
                 └→ 배정 완료
                      ├→ 활동 지원사에게 알림 (당사자 정보 접근 가능)
                      └→ 보호자에게 알림 (새 담당 활동 지원사 배정)

4-2. 보호자 정보 수신 및 열람

홈 (/home) → 담당 당사자 목록
  └→ 당사자 선택 → 돌봄정보 (/care-info)
       └→ 보호자가 작성한 전반적인 기록 열람
            └→ 활동 지원사에게 필요한 정보 확인

4-3. 기관 연결 요청 수락·거부 (보호자 측)

기관이 연결 요청을 보내면(PENDING), 보호자가 수락하거나 거부하는 플로우

돌봄 관계 관리 (/more → 돌봄 관계 관리)
  └→ 대기 중(PENDING) 기관 연결 요청 목록 (GET /api/care-recipients/{id}/organization-link-requests)
       └→ 요청 선택
            ├→ [수락] → POST .../organization-link-requests/{requestId}/accept
            │            연결 상태 PENDING → ACCEPTED
            └→ [거부] → POST .../organization-link-requests/{requestId}/reject
                          연결 상태 PENDING → REJECTED

4-4. 활동 지원사에게 도전행동 기록 요청

기관 대시보드 → 담당 활동 지원사 목록
  └→ [도전행동 기록 요청] → 대상 당사자 선택
       └→ 요청 전송 → 활동 지원사 알림
            └→ 활동 지원사가 도전행동 기록 작성 → 기관에서 확인

4-5. 보호자에게 도전행동 기록 전달 및 추가 정보 요청 중계

기관 대시보드 → 활동 지원사 기록 확인
  └→ 도전행동 기록 보호자에게 전달
       └→ 활동 지원사의 추가 정보 요청 중계 → 보호자에게 알림

---

5. 마이페이지 플로우

더보기 탭 (/more)
  ├→ 내 정보
  │    ├→ 프로필 수정
  │    └→ 비밀번호 변경
  ├→ 돌봄 관계 관리  ← 보호자만 표시
  │    ├→ 기관이 배정한 활동 지원사 목록
  │    ├→ 돌봄 종료
  │    └→ 기관 이전
  ├→ 세컨드 보호자 관리  ← 보호자만 표시
  │    ├→ 세컨드 보호자 지정·수정
  │    └→ 지정 해제
  ├→ 접근 이력 확인  ← 보호자만 표시 (Should)
  ├→ 서비스
  │    ├→ 알림 설정
  │    └→ 도움말
  └→ [로그아웃] → 온보딩

---

6. 화면 — 라우트 매핑

화면	라우트	접근 가능 역할
동의	/	공통
홈	/home	공통
생활기록 목록	/records	공통
기록 작성	/records/new	보호자, 제공자
기록 상세	/records/:id	공통
돌봄정보	/care-info	공통
더보기/마이페이지	/more	공통

---

7. 알림

수신자	발송 조건
돌봄 보호자	새 기록 등록됐을 때
돌봄 보호자	기존 기록 수정됐을 때
돌봄 보호자	활동 지원사가 수정 제안 전송했을 때
돌봄 보호자	기관이 새 활동 지원사를 배정했을 때
활동 지원사	기관이 당사자에게 배정했을 때
활동 지원사	기관이 도전행동 기록 작성 요청했을 때
활동 지원사	보호자가 수정 제안을 승인·거절했을 때
기관	활동 지원사가 추가 정보 요청을 전달했을 때

---

8. 미결 사항

항목	질문	담당
기록 작성 권한	✅ 돌봄 제공자도 직접 작성 가능. 보호자 작성 기록은 수정 제안만 (M7)	팀 전체
기록 수정·삭제	저장된 기록을 수정/삭제할 수 있는가? 이력은 남기는가?	팀 전체
당사자 복수 등록	보호자가 여러 당사자를 등록할 수 있는가?	팀 전체
알림	기록 리마인더, 수정 제안 알림이 MVP에 포함되는가?	팀 전체
접근 이력	열람 이력을 보호자에게 보여주는가?	BE