📖 CareFlow 사용 설명서

v1.3

회원가입부터 CSV 송출까지 전체 사용법을 한 페이지에 정리했습니다. 각 단계마다 도달 경로(어떤 버튼을 눌러야 하는지)와 화면 예시를 포함합니다.

설명서를 읽기 어렵다면 화면 우측 아래 케피 버튼을 눌러 직접 물어보세요. 캐릭터 챗봇이 그룹 상황에 맞춰 답변합니다.

1. 회원가입 2. 그룹 등록 3. 그룹 정보 4. APK 설치 5. NFC 등록 6. 업무 사용 7. CSV 송출

🗺️ 전체 흐름 요약

1. 회원가입→2. 그룹 등록→3. 그룹 정보→4. APK 설치→5. NFC 등록→6. 업무 사용→7. CSV 송출

처음 한 번만 설정하면 6번(업무 사용)은 반복 루틴입니다.

👤회원가입

📍 도달 경로:홈→로그인→회원가입

이메일 또는 Google 계정으로 가입합니다. 가입 직후에는 역할이 정해지지 않은 상태이며, 다음 단계(그룹 등록)에서 그룹 관리자로 전환됩니다.

이메일 가입: 이메일 주소 + 비밀번호 + 인증 메일 확인
Google 가입: 구글 계정 선택 1회 클릭
가입 완료 직후: 마이페이지로 자동 이동

💡 처음 방문자라면

홈 화면에서 오른쪽 위 로그인 버튼을 누르고 로그인 화면 하단의 회원가입 링크를 누르세요.

🏢그룹 등록 (그룹 관리자용)

📍 도달 경로:마이페이지→그룹 미등록 상태→그룹 등록 요청 버튼

아직 앱에 등록되지 않은 그룹이라면, 본인이 그룹 팀장으로서 직접 등록할 수 있습니다. 등록 즉시 본인이 그 그룹의 팀장이 됩니다 (별도 승인 절차 없음).

그룹명·주소·연락처 입력 (필수)
산업 분야 선택: 돌봄 / 산업안전 / 시설관리 / 보안순찰 / 기타 중 택1
세부 업종 선택 (선택 — 사업자 인증 후 KSIC 자동 매핑 또는 직접 선택)
등록 즉시 그룹 운영 메뉴 활성화 → NFC 태그·장소·구성원 초대 시작 가능

ℹ️ 이미 등록된 그룹에 가입하려면

그룹 찾기(/centers) 에서 그룹을 찾아 이 그룹 등록하기 버튼을 누르면 그룹 팀장 또는 구성원으로 가입 요청할 수 있습니다.

💡 이해관계자도 그룹 등록 가능

보호자·의뢰주·건물주처럼 그룹과 관계된 외부 이용자도 본인이 직접 그룹을 등록해 그룹 공지 수신대상이 될 수 있습니다 (산업별 용도 상이).

📋그룹 정보 등록 (주소·운영시간·장소·행동)

📍 도달 경로:그룹 상세 페이지→관리 탭→설정 섹션

그룹이 승인되면 그룹 상세 페이지(/centers/[id]?tab=manage)에서 그룹 정보를 세팅합니다. 이 정보가 활동 로그 계산·NFC 작동·외부 신뢰 지표의 기반이 됩니다.

주소: 입력하면 좌표 자동 설정 → 지도·거리 기반 신뢰 지표 반영
운영시간: 요일별 시작·종료 시각, 휴게시간, 휴무일 설정 → 운영시간 내 로그만 지표 반영
장소 목록: 실제 운영 단위 (예: 생활실, 식당, 복도, 차량, 상담실)
행동 카탈로그: 각 장소에서 자주 일어나는 행동 등록 (예: 식사 보조, 상태 확인, 순찰 완료)
- 공통 기본 행동은 템플릿에서 자동 제공
- 유료 그룹은 직접 추가·수정 가능
- 돌봄 템플릿은 28 소분류 3단 카탈로그 제공

⚠️ 운영시간은 단순 표시용이 아님

운영시간 외에 찍힌 NFC 로그는 참고용으로만 저장되며 활동 신뢰도 지표에는 반영되지 않습니다. 법적 면책 문구가 NFC 스캔 화면·비상 보고 모달·가이드라인 3곳에 표시됩니다.

📱APK 설치 (안드로이드)

📍 도달 경로:/download→APK 다운로드 버튼

현장 기록(NFC 태그)은 안드로이드 앱에서만 작동합니다. /download에서 APK를 받아 설치합니다.

/download 접속 → APK 다운로드 버튼 클릭
다운로드한 파일(careflow-release.apk) 클릭
안드로이드 설정 → "출처를 알 수 없는 앱" 허용 요청 → 허용
설치 진행 → 완료
앱 아이콘(CareFlow 민트 로고) 클릭 → 로그인

ℹ️ 필요 권한

앱이 처음 실행되면 NFC 권한과 위치 권한 허용 요청이 뜹니다. 현장 기록에는 NFC가, 지도·거리 계산에는 위치가 사용됩니다.

💡 iOS는?

현재 안드로이드 APK만 제공됩니다. iOS는 향후 지원 예정입니다. NFC 하드웨어 인식·리더 모드 호환성 때문에 안드로이드를 우선합니다.

🏷️NFC 태그 등록 (그룹 관리자)

📍 도달 경로:그룹 상세 페이지→관리 탭→NFC 관리 섹션→새 태그 등록 버튼

물리적 NFC 스티커를 그룹의 각 장소에 부착하고, 앱에서 해당 스티커를 CareFlow 시스템에 등록합니다.

💡 📱 NFC 등록 진입점 (3가지)

홈 → "NFC 등록하기" 버튼 — 안드로이드 크롬 모바일 웹은 즉시 스캔 가능, iOS·데스크톱은 앱 다운로드 안내
마이페이지 → "NFC 관리" — `/manager/places` 로 이동
등록되지 않은 NFC 스캔 시 자동 — "이 태그 등록하기" 버튼이 표시되어 `/manager/places?tag=<uid>` 로 UID가 자동 입력됩니다 (2026-05-01 적용)

3가지 태그 타입

📍 장소 전용: 해당 스티커 = 특정 장소. 찍으면 "이 장소에 멤버가 왔다" 로그 시작
🎯 행동 전용: 해당 스티커 = 특정 행동. 장소 로그가 열린 상태에서 찍으면 행동이 추가됨
📍+🎯 장소+행동 묶음: 스티커 하나에 "이 장소에서 이 행동" 두 가지가 동시에 기록됨

2가지 등록 방식

📱 앱 스캔: 앱에서 "스캔 시작" 버튼 → 등록할 빈 NFC 스티커를 폰에 대기 → UID 자동 입력
⌨️ UID 직접 입력: NFC 스티커 포장지에 적힌 UID를 수기로 타이핑 (스캔이 안 될 때 대안)

⚠️ 중요: 그룹에 등록한 NFC만 작동

CareFlow는 시스템에 등록된 UID만 로그를 남깁니다. 개인 소지의 교통카드·출입카드·신분증 NFC는 앱이 잠시 튀어오를 수 있지만 실제 로그는 기록되지 않습니다 (등록되지 않은 태그 표시).

💡 NFC 스티커 구입 안내

권장 규격: NTAG213 / 215 / 216 (NDEF 표준, 144~888 bytes 지원)
가격: 개당 500~1,500원 (구매 개수에 따라)
초기 구매: 쿠팡·11번가 등에서 "NTAG215 NFC 스티커" 검색 (베타 기간 직접 구매 권장)
추후: CareFlow 직접 판매 예정 (Phase 2~3, 그룹 구독 기관 무상 포함)
부착 위치: 그룹 벽·문·차량 내부 등 실제 동선에 맞춰 부착
분실 시: 마이페이지 → NFC 관리 → 해당 태그 "삭제" → 새 태그 재등록

⚠️ 📱 안드로이드 권장 · iOS 제약

안드로이드 크롬 81+: 앱 없이 Web NFC 즉시 사용 가능 (Mode 1·2 모두)
안드로이드 APK: 앱이 꺼져 있거나 백그라운드 상태에서도 NFC 인식 시 자동으로 깨어납니다 (Mode 2 전체 지원)
iOS: 애플 사파리 = Web NFC 미지원. 앱 출시 후 포그라운드 상태 또는 알림을 누른 뒤에만 인식 가능 (Phase 2)

👥 사람 폰 NFC 태그 (Phase 1.5 신규)

기존 NFC 스티커 외에, 본인 폰 자체를 NFC 태그로 활성화할 수 있습니다. 같은 그룹 멤버가 본인 폰 뒷면을 다른 폰의 NFC 리더로 가까이 대면 인식됩니다. (대상자-제공자 양방향 흐름)

💡 📱 폰 NFC 태그 켜는 방법 (안드로이드 한정)

1단계 (회원가입 시): 회원가입 폼에 "폰 NFC 태그 사용 동의" 체크박스 → 기본 OFF
2단계 (마이페이지): 마이페이지 → "📱 폰 NFC 태그" 섹션 → 토글 켜기
3단계 (자동): 앱이 그룹별 HMAC 토큰을 받아 폰에 저장합니다 (만료 24시간)
표시: 그룹 운영 페이지 → "👥 사람 NFC 태그" 카드에 활성 멤버 목록 표시

⚠️ ⚠️ 사용 제약 + iOS fallback

안드로이드 + HCE 지원 폰만 활성: NFC + HCE(Host Card Emulation) 둘 다 있어야 합니다. 거의 모든 안드로이드 5.0 이상 폰에서 가능합니다.
iOS 불가: Apple은 HCE를 일반 앱에 허용하지 않습니다. iOS 사용자는 NFC 스티커 fallback 또는 BT 근접 보조를 사용해 주세요.
토큰 만료 24시간: 만료 후에는 다시 "토글 끄고 켜기" 또는 24시간 안에 자동 갱신 (Phase 2 예정).
동의 해제 시: 마이페이지 토글 OFF → 즉시 모든 그룹의 본인 폰 노드가 archive 처리됨 (다른 폰 리더에 응답 안 함).
구형 안드로이드: 4.4 미만 또는 NFC 미탑재 폰은 활성화 불가 안내가 뜹니다.

* 활동 신뢰도 안내 — 사람 노드 스캔 + 위치 검증을 동시에 충족하면 인증 로그로 인정되어 활동인증피드 작성이 가능합니다. 사람 노드만 스캔되고 위치 검증이 안 되면 일반 로그로 처리됩니다.

⚡업무 시 사용법 (핵심 — 반복 루틴)

📍 도달 경로:앱 설치된 폰→화면 ON 상태→NFC 태그에 폰 대기

⚠️ 필수 전제 — 꼭 지키세요

앱이 설치된 폰에서만 작동 (APK 설치 필수)
폰 화면이 켜진 상태에서 태그해야 반응합니다
(잠금화면 포함 — 화면만 켜져있으면 OK. 완전 꺼진 상태에서는 Android NFC 하드웨어가 절전 모드라 반응하지 않습니다.)
본인이 멤버로 등록된 그룹의 NFC 태그만 반응합니다. 등록 안 된 그룹의 태그를 찍어도 로그가 생성되지 않습니다.

기본 흐름 (장소 NFC → 행동 선택)

주머니에서 폰을 꺼내고 화면을 켬 (전원 버튼 1회)
📍 장소 NFC 태그에 폰을 댐
→ 앱이 자동으로 튀어 올라오며 "○○ 장소 도착" 로그가 생성됩니다.
행동을 선택하는 2가지 방법
- 방법 A: 화면에 뜬 행동 버튼 중 하나를 터치 (식사 보조·상태 확인 등)
- 방법 B: 🎯 행동 NFC 태그에 폰을 이어서 댄다 → 별도 터치 없이 행동이 추가됩니다
저장 완료 토스트 확인 (✅ "저장되었습니다")

묶음 태그 사용 (한 번에 장소+행동)

장소+행동 묶음 타입 태그는 한 번만 찍으면 장소와 행동이 동시에 기록됩니다. 반복 패턴이 명확한 위치(예: "생활실 입구 = 입실 확인")에 적합합니다.

ℹ️ 중복 찍기 방지

같은 NFC를 3분 안에 다시 찍으면 시스템이 중복으로 판단해 기록하지 않습니다. 의도적으로 재기록하려면 3분 뒤에 다시 태그하세요.

⚠️ ⚠️ 개인 NFC 카드 · 기타 NFC 장치 분리 보관

업무 중 폰과 개인 NFC 카드(교통카드·출입카드·신분증·신용카드 등)를 분리해서 보관하세요. 지갑·파우치·가방 등에 함께 있으면 오인식될 수 있습니다.
케이스 뒷면에 카드 끼우기 금지. 카드 슬롯 있는 케이스는 업무용 폰에 비권장.
업무 중에는 본인 그룹의 NFC 태그만 반응하지만, 폰과 개인 카드가 붙어 있으면 오인식·간섭이 생길 수 있어요.업무 종료 후 폰을 정리할 때 개인 NFC 물품과 합치세요.

⚠️ 비상 상황 발생 시

화면 하단의 ⚠ 비상 보고 버튼을 누르면 비상 기록이 별도로 저장됩니다. NFC 태그와는 별개 흐름이라 업무 중·업무 외 어느 시점이든 비상 보고는 가능합니다. 관리자 대시보드의 안전 칸반에서 관리됩니다.

📊CSV 송출 (관리자용 로그 내보내기)

📍 도달 경로:그룹 상세 페이지→관리 탭→로그 대시보드 또는 SAFETY Kanban→CSV 내보내기 버튼

그룹 관리자는 축적된 활동 로그·비상 로그를 CSV 파일로 내보낼 수 있습니다. 엑셀·구글시트에서 바로 열립니다.

2가지 CSV

활동 로그 CSV: 기간별 전체 로그 (시간·장소·행동·신원 4축). 로그 대시보드에서 생성
비상 사안 CSV: 안전 칸반에서 발생한 비상 건의 처리 이력 전체. 사안별 담당자·처리 로그 포함

포함 컬럼 (활동 로그 CSV)

멤버 ID · 직종 · 시간
장소 · 행동 · 사진 유무
비상 연결 여부 · 수정 여부 · 조치 내용
운영시간 외 기록 여부 (is_outside_hours)

💡 언제 송출하나요?

월말·분기말 보고서 작성 시 / 외부 감사 요청 시 / 사고 발생 후 증빙 자료 준비 시.

ℹ️ 보안

CSV 파일에는 개인정보가 포함될 수 있습니다. 다운로드 후 그룹 내부 보안 정책에 따라 저장·전송하세요. CareFlow는 CSV 송출 이력을 내부 로그로 보관합니다.

🆓 무료 그룹 · 일반 사용자는 무엇을 할 수 있나요?

CareFlow의 기록 기능(NFC 스캔·활동 로그·피드 작성·관리 대시보드)은 Pro 이상 구독 그룹에서만 활성화됩니다. 무료 그룹·비구독 그룹은 일반 사용자와 동일한 권한으로 다음만 가능합니다.

🔍 그룹 찾기 · 필터·지역별 검색
📄 그룹 페이지 열람 · 활동 신뢰도 · 공개된 활동 인증 피드
📣 그룹 공지 수신 · 이해관계자(보호자·의뢰주·건물주 등)로 등록된 경우
📞 그룹 문의 · 4 산업(돌봄·산업안전·시설관리·보안순찰) 그룹 공통

💡 유료 구독으로 업그레이드하면

NFC 현장 기록·활동 인증 피드 게시·관리자 대시보드·CSV 송출 등 전체 운영 기능이 열립니다. 그룹 설정 페이지에서 Pro 전환이 가능합니다.

🎯 요약 한 줄

설치 한 번 · 설정 한 번 · NFC 등록 한 번. 이후에는 폰 화면 켜고 태그에 대기 2초만으로 모든 현장 기록이 자동으로 쌓입니다. (Pro 이상 구독 기준)

그룹 찾기 시작하기 APK 다운로드 마이페이지

📮 문의

설명서에 없는 내용이 있거나 화면이 설명과 다르게 보인다면 FAQ 페이지의 개발자 문의 링크로 알려주세요. 버전 업데이트에 따라 UI가 달라질 수 있습니다.