Documentation
The FA 고객지원 문서
The FA는 AI 매장 운영 분석, CCTV 기반 Vision AI, FA Score, 금융 연계, QR Survey, SaaS 대시보드를 연결하는 운영 플랫폼입니다. 이 문서는 설치, 운영, API 연동에 필요한 기준을 한 곳에 정리합니다.
서비스 개요
The FA는 매장 운영 데이터를 수집하고 분석해 운영 리스크와 개선 기회를 보여줍니다. 고객 설문과 CCTV 분석 결과는 FA Score와 리포트에 반영됩니다.
데이터 연결
매장 상태를 같은 기준으로 기록하고 다음 조치를 판단합니다.
운영 분석
매장 상태를 같은 기준으로 기록하고 다음 조치를 판단합니다.
금융 연계
매장 상태를 같은 기준으로 기록하고 다음 조치를 판단합니다.
신규 매장 온보딩
온보딩은 매장 기본 정보 등록, 사용자 권한 설정, 데이터 연결, 첫 리포트 확인 순서로 진행합니다. 처음부터 모든 기능을 켜기보다 운영 데이터 품질을 확인하면서 단계적으로 활성화하는 것을 권장합니다.
- 1매장명, 주소, 담당자, 운영 시간, 브랜드 정보를 등록합니다.
- 2운영자, 매장 관리자, 조회 전용 사용자 권한을 나눕니다.
- 3CCTV 또는 NVR 정보, QR Survey 링크, 기존 운영 데이터를 연결합니다.
- 4첫 24~72시간 데이터 수집 상태를 확인하고 누락 구간을 점검합니다.
- 5FA Score 리포트와 액션 항목을 확인해 매장 운영 기준을 확정합니다.
Vision AI 설치 전 체크리스트
- 카메라 시야에 주요 운영 구역이 들어오는지 확인합니다.
- 조도, 역광, 야간 운영 조건에서 영상 품질을 확인합니다.
- RTSP 또는 NVR 주소와 접근 권한을 준비합니다.
- 출입구, 계산대, 대기열, 테이블 구역처럼 분석 목적별 구역 이름을 미리 정합니다.
- 매장 내 안내문, 개인정보 처리 고지, 내부 접근 권한 정책을 설치 전에 확인합니다.
CCTV 연결
CCTV 연결은 네트워크 접근, 스트림 주소, 권한, 해상도 조건이 맞아야 안정적으로 동작합니다. 연결 오류가 반복되면 방화벽과 NVR 설정을 먼저 확인합니다.
권장 확인 항목
카메라 전원, 내부망 접근, RTSP 주소, 계정 권한, NVR 채널 번호, 영상 해상도, 프레임레이트를 확인합니다.
분석 품질 조건
고정 카메라, 안정적인 조도, 주요 동선 확보, 과도한 역광 방지, 가림 영역 최소화가 필요합니다.
{
"storeId": "store_001",
"cameraName": "Main Hall",
"streamType": "rtsp",
"status": "ready"
}SaaS 대시보드 지표
대시보드는 점수 하나만 보는 화면이 아니라, 점수 변화의 원인과 다음 액션을 함께 확인하는 운영 화면입니다. 기간 필터와 매장 필터를 먼저 확인한 뒤 각 지표를 해석합니다.
금융 연계
FA Score와 운영 리포트는 금융 상담을 준비하는 참고 지표로 사용할 수 있습니다. 실제 금융 조건은 제휴사 정책과 심사 결과에 따라 달라질 수 있습니다.
API Docs
API는 서버 간 연동을 기준으로 설계합니다. 토큰은 브라우저에 노출하지 않고 서버 환경변수에 저장합니다.
/api/v1/stores/{storeId}/scoreFA Score와 추세 조회/api/v1/stores/{storeId}/missions매장별 액션 미션 조회/api/v1/dashboard/qscQSC 대시보드 요약 조회/api/v1/surveys/{surveyId}/responsesQR Survey 응답 등록/api/v1/files첨부파일 업로드{
"storeId": "store_001",
"score": 87,
"trend": "up",
"riskFlags": ["survey_drop", "peak_congestion"]
}장애 대응 런북
장애가 발생하면 먼저 범위를 나눕니다. 특정 매장만 문제인지, 전체 API인지, CCTV 스트림인지, 대시보드 표시 문제인지 분리하면 조치 시간이 줄어듭니다.
데이터 공백
기간 필터, 수집 상태, backend API 응답, 배치 작업 로그를 확인합니다.
CCTV 끊김
카메라 전원, 내부망, NVR 채널, RTSP 인증 정보를 확인합니다.
FAQ/문서 오류
frontend 배포 버전과 support 도메인 rewrite 설정을 확인합니다.
API 오류
상태 코드, 요청 ID, 토큰 만료 여부, 권한 범위를 확인합니다.
오류 응답 기준
400요청 형식 오류필수 필드, 날짜 범위, 매장 ID 형식을 확인합니다.401인증 실패토큰 누락 또는 만료 상태입니다.403권한 없음해당 매장 또는 리포트에 접근 권한이 없습니다.404대상 없음매장, 설문, 리포트 ID가 존재하지 않습니다.409중복 또는 충돌이미 처리된 요청이거나 고유값이 중복되었습니다.429요청 제한짧은 시간에 요청이 너무 많습니다.보안
운영 데이터 접근은 역할 기반으로 제한합니다. 영상과 설문 데이터는 목적에 맞게 처리하고, 보관 기간과 접근 권한은 운영 정책에 따라 관리합니다.
- 관리자 권한은 최소 인원에게만 부여합니다.
- API 토큰은 서버 환경변수에 저장하고 브라우저 코드에 노출하지 않습니다.
- 영상 원본 보관 기간과 접근 권한은 설치 전 운영 정책으로 합의합니다.
- 설문 응답은 매장 운영 개선 목적에 맞게 수집하고 불필요한 개인정보 입력을 요구하지 않습니다.