---

name: fc-workflow description: FC 온보딩 워크플로우 이해 및 상태 관리 가이드. FC 상태, 위촉 프로세스, 권한 관련 질문 시 사용. allowed-tools: Read, Grep, Glob

FC 온보딩 워크플로우 가이드

FC(Financial Consultant) 온보딩 프로세스와 상태 관리를 설명합니다.

사용자 역할

FC 온보딩 상태 흐름

Copydraft → temp_id_issued → consent_approved → docs_approved → appointed → completed

상태별 설명

주요 플래그

identity_completed

• false: 신원정보(주민번호, 주소) 미입력 → home-lite 화면만 접근
• true: 신원정보 입력 완료 → 전체 기능 접근

phone_verified

• 회원가입 시 SMS OTP 인증 완료 여부

화면 접근 제어

identity_completed = false (home-lite)

• 1:1 메시지
• 공지사항
• 정보 게시판

identity_completed = true (full home)

• 위 기능 + 전체 온보딩 프로세스

데이터베이스 테이블

fc_profiles

주요 필드:

• id: UUID
• temp_id: 임시 ID (관리자 발급)
• name, phone, affiliation: 기본 정보
• status: 온보딩 상태
• identity_completed: 신원정보 입력 완료
• allowance_date: 수당동의일
• appointment_date: 위촉일

fc_identity_secure

암호화된 민감 정보:

• resident_number_encrypted: 암호화된 주민번호
• address_encrypted: 암호화된 주소

fc_credentials

로그인 정보:

• password_hash, password_salt: 비밀번호 해시
• failed_count, locked_until: 로그인 시도 제한

인증 플로우

회원가입

Copyrequest-signup-otp → verify-signup-otp → set-password

로그인

Copylogin-with-password → JWT 발급 → 세션 저장

비밀번호 재설정

Copyrequest-password-reset → reset-password

Manager(본부장) 읽기 전용 모드

Manager 계정은 모든 화면에서 읽기 전용:

• 버튼: 회색(disabled)
• 토글: 회색 + 투명도 감소
• 입력 필드: disabled
• 알림 배너: "읽기 전용 모드 - 본부장 계정은 조회만 가능합니다"

Copyconst { isReadOnly } = useSession();

<Button
  color={isReadOnly ? "gray" : "orange"}
  disabled={isReadOnly}
>
  저장
</Button>

관련 파일

• app/index.tsx: 홈 허브 (identity_completed 기반 분기)
• app/home-lite.tsx: 제한된 홈 화면
• app/identity.tsx: 신원정보 입력
• app/apply-gate.tsx: 온보딩 시작 동의
• hooks/use-session.tsx: 세션 관리
• hooks/use-identity-gate.ts: 신원정보 게이트