PharmAlone 사용자 매뉴얼

약국 재고를 바코드로 스캔해서 빠르게 관리하는 앱입니다. 혼자 사용하셔도 되고, 동료와 같이 사용해도 됩니다.

목차

  1. 앱 소개
  2. 시작하기
  3. 약국 만들기 / 합류하기
  4. 메인 화면 둘러보기
  5. 바코드 스캔과 재고 추가
  6. 수납장 관리
  7. 스캔 내역 (검색·필터·정렬)
  8. 재고 수정·삭제
  9. 알약 카운팅
  10. 재고 내보내기 (CSV)
  11. 팀 / 멀티유저
  12. 동기화 / 클라우드 상태
  13. 계정 / 설정
  14. 약국·계정 정리
  15. 3가지 사용 모드 안내
  16. FAQ
  17. 문제 해결
  18. 데이터 보호 정책
  19. 지원 받기

1. 앱 소개

PharmAlone 은 약국에서 약품을 바코드로 스캔하면 자동으로 약품명·유효기간·로트번호 등이 입력되는 재고 관리 앱입니다.

주요 기능

  • 📷 바코드 스캔 — GS1 바코드를 카메라로 찍으면 약품 정보 자동 인식.
  • 📦 수납장 / 칸 관리 — 약국의 수납장을 사진으로 기억하고 칸 단위로 분류.
  • 👥 여러 직원과 공유 — 한 약국을 여러 직원이 같은 데이터로 사용.
  • 🔄 자동 동기화 — 한 기기에서 추가하면 다른 기기에서도 즉시 보임.
  • 📤 CSV 내보내기 — 재고 목록을 엑셀로 정리하기 쉽게 내보냄.
  • 💊 알약 카운팅 — 카메라로 알약 갯수를 자동으로 셈.
  • 📱 iOS / Android 모두 지원.

작동 방식

  1. 약국마다 한 명이 약국장 (owner) 으로 약국을 만듭니다.
  2. 약국장이 초청 코드 를 만들어 동료에게 알려줍니다.
  3. 동료가 코드를 입력하면 같은 약국 데이터를 함께 사용합니다.
  4. 한 명이 추가/수정한 재고는 모든 사람의 화면에 자동 반영됩니다.

혼자 사용하기: 약국 만들지 않고 그냥 본인 기기에만 저장하는 모드도 있습니다. 인터넷 없어도 사용 가능. 나중에 약국에 합류하면 이 데이터를 옮겨갈 수 있습니다.

2. 시작하기

2-a. 첫 실행

앱을 처음 켜면 카메라 권한 을 요청합니다. 바코드 스캔에 필수이므로 허용해주세요.

온보딩 화면

2-b. 3가지 시작 방법

방법 설명 적합한 경우
혼자 사용 회원가입 없이 바로 시작 개인 약국 / 테스트
회원가입 이메일 + 비밀번호로 신규 가입 새 약국 시작
로그인 기존 계정으로 들어오기 기기 변경 / 다른 약국 합류

회원가입과 로그인은 우상단 톱니바퀴(⚙) 설정 에서 진입합니다.

2-c. 회원가입 절차

  1. 설정 → 아래쪽으로 스크롤 → 회원가입 누름.
  2. 이메일 / 비밀번호 (8자 이상) 입력.
  3. 약관 동의.
  4. 인증 코드 입력 화면이 나타나면 메일함 확인 → 받은 6자리 코드 입력.
  5. 인증 완료 → 자동으로 약국 만들기 / 합류하기 화면으로 이동.

💡 코드가 안 와요:

  • 스팸함 확인.
  • 60초 후 “코드 다시 보내기” 클릭. 60초 안에는 카운트다운이 표시됩니다.
  • 그래도 안 오면 §17 문제 해결 참고.

회원가입 화면 OTP 입력 화면

2-d. 로그인 (기존 계정)

  1. 설정 → 로그인 영역에 이메일 + 비밀번호 입력 → 로그인 버튼.
  2. 자동으로 가입했던 약국으로 들어감 (이미 멤버라면).
  3. 약국 합류 전이면 “약국 만들기 / 합류하기” 화면.

3. 약국 만들기 / 합류하기

회원가입 또는 로그인 후 약국에 속하지 않은 상태 라면 설정 화면에 두 옵션이 나타납니다.

3-a. 새 약국 만들기 (약국장이 처음으로)

설정 → “약국” 섹션 → 내 약국 만들기 (💊 아이콘) 클릭.

  1. 약국 이름 입력 (예: “OO약국”).
  2. 본인의 닉네임 입력 (팀원에게 보일 이름).
  3. 약국 만들기 버튼.

자동으로 본인이 약국장 (owner) 이 되고, 기본 수납장 1개 (“기본 수납장”) 가 생성됩니다.

3-b. 기존 약국에 합류 (직원이 들어올 때)

약국장이 알려준 8자리 초청 코드 가 필요합니다.

설정 → “약국” 섹션 → 약국 합류하기 (👤+ 아이콘) 클릭.

  1. 8자리 초청 코드 입력 (대문자/숫자, 예: “AB12CD34”).
  2. 본인의 닉네임 입력.
  3. 합류 버튼.

성공하면 자동으로 약국 데이터를 받아 보기 시작합니다.

초청 코드 받기: 약국장 또는 매니저 권한자에게 요청. §11 팀 / 멀티유저 참고.

약국 만들기 화면 약국 합류 화면

4. 메인 화면 둘러보기

메인 화면

4-a. 화면 구성 (위에서 아래로)

  1. 상단 — 스캔 설정 카드:
    • “스캔 설정” 글자 + 우측 아이콘들.
    • 수납장 위치 선택 드롭다운.
    • 온통/낱개 토글 (“온통” 박스 통째로 / “낱개” 한 개씩).
    • 🔍 검색 / ☁️ 클라우드 상태 (약국 멤버일 때만 표시) / ☰ 햄버거 메뉴 아이콘.
  2. 중간 — 카메라 영역:
    • 검은 박스. 탭하면 카메라 켜짐.
    • 카메라 OFF: “바코드 스캔 시작” 표시.
    • 카메라 ON: 실시간 바코드 인식.
  3. 하단 — 스캔 내역:
    • 슬라이드 가능한 시트.
    • 3단계 위치:
      • 기본 (peek): 카메라 박스 바로 밑.
      • 첫 번째 위로: 카메라를 다 덮음.
      • 두 번째 위로: “스캔 설정” 글자 바로 밑까지.
    • 손잡이 위쪽 부분을 위/아래로 끌어 단계 변경.
    • 필터 칩 (3개월 임박 / 6개월 대비 / 전체 / 수납장별).
    • 정렬 드롭다운 (유효기간 임박순 / 등록순 / 이름순).
    • 우측 아래 + 버튼 (수동 추가).

4-b. 햄버거 메뉴 (☰)

  • 💊 알약 카운팅 — 카메라로 알약 개수 자동 세기.
  • 📤 재고 내보내기 — CSV 파일 만들어 공유 (viewer 권한 제외).
  • ❓ 도움말 — 코치마크 시작.
  • ⚙️ 설정 — 계정 / 약국 / 팀 관리 화면.

4-c. 스캔 내역 시트의 동작

  • 빈 약국 / 0건: “아직 스캔된 약품이 없습니다.” 안내.
  • n건 이상: 카드 형태로 약품 리스트 표시.
  • 스와이프 동작: 손잡이 부분을 잡고 위/아래로.
  • 카드 탭 → 상세 / 수정 화면.
  • 카드 좌측 스와이프 → 삭제 (권한 있을 때만).

5. 바코드 스캔과 재고 추가

5-a. 자동 입력 흐름

  1. 수납장 위치 선택 (드롭다운에서).
  2. 온통/낱개 토글 설정 (박스째 / 낱개).
  3. 카메라 박스 탭 → 카메라 켜짐.
  4. 약품 박스의 GS1 바코드 를 카메라에 비춤.
  5. 자동 인식 → 입력 시트 자동 표시.
  6. 약품명 / GTIN / 유효기간 / 로트번호 자동 채워짐.
  7. 수량 입력 → 저장.

5-b. 입력 시트 구조

항목 자동 입력 사용자 수정 가능
약품명 ✅ (DB 매칭) ✅
제조사 ✅ ✅
GTIN (바코드 번호) ✅ ❌
유효기간 ✅ (바코드에서) ✅
로트번호 ✅ (바코드에서) ✅
수량 ❌ (직접 입력) -
수납장 위치 메인 화면 설정 그대로 ✅
칸 (Zone) 선택 안 함 ✅

5-c. 수동 추가

바코드 없는 약품이거나 직접 입력하고 싶을 때:

  1. 메인 화면 우측 아래 + 버튼 클릭.
  2. 입력 시트가 빈 상태로 열림.
  3. 모든 항목 직접 입력 후 저장.

viewer 권한 은 + 버튼이 회색 (사용 불가). manager 이상이 필요합니다.

바코드 스캔 흐름 수동 추가 시트

6. 수납장 관리

6-a. 수납장이란?

약국 안의 물리적 수납 위치 (예: 전문의약품, 일반의약품, 냉장고). 약품마다 위치를 지정해 나중에 빠르게 찾을 수 있게 합니다.

신규 약국엔 기본 수납장 1개 (“기본 수납장”) 가 자동 생성됩니다.

6-b. 수납장 추가 / 이름변경 / 삭제

메인 화면 → “스캔 설정” → 수납장 위치 드롭다운 펼치기 → 맨 아래 수납장 관리 진입.

또는 + 표시 → 수납장 관리 화면 열림.

여기서:

  • 새 수납장 추가 — 이름 입력.
  • 이름 변경 — 수납장 카드 탭 → 편집.
  • 삭제 — 좌측 스와이프 (안에 약품이 있으면 경고).

6-c. 수납장 사진 등록

수납장 카드를 길게 누르면 수납장 상세 화면이 열립니다.

  • 사진이 없으면: 사진 등록 버튼.
  • 카메라로 촬영 / 갤러리에서 선택.
  • 사진이 있으면: 칸 편집 가능.

6-d. 칸 (Zone) 편집

수납장 사진 위에 칸을 표시 해 약품을 더 세밀하게 분류할 수 있습니다.

  1. 수납장 상세 → 칸 편집 버튼.
  2. 사진 위에 박스를 그려 칸을 만듦.
  3. 각 칸의 이름 입력 (예: “1단”, “2단”).
  4. 색상 선택 (선택).

칸 편집 후 약품 추가 시 수납장 + 칸 조합으로 위치 지정 가능.

수납장 관리 칸 편집

7. 스캔 내역 (검색·필터·정렬)

7-a. 필터 칩

  • 3개월 임박 — 유효기간 3개월 이내 (빨강).
  • 6개월 대비 — 유효기간 3~6개월 (주황).
  • 전체 — 모든 약품.
  • 수납장별 — 특정 수납장 약품만.

여러 칩을 동시에 선택 가능 (수납장별 + 임박 등).

7-b. 정렬

  • 유효기간 임박순 (기본) — 빨리 만료되는 것이 위.
  • 등록순 — 최근 추가가 위.
  • 이름순 — 가나다.

7-c. 검색

상단 우측 🔍 검색 아이콘 → 검색 시트.

  • 약품명 / 제조사 / 로트번호 / GTIN 모두 매칭.
  • 결과 카드 탭 → 위치 / 수량 / 상세 정보.

검색 화면

8. 재고 수정·삭제

8-a. 수정

  • 메인 스캔 내역의 카드 탭 → 입력 시트 (편집 모드).
  • 모든 항목 수정 가능 (GTIN 제외).
  • 저장 → 자동 동기화.

8-b. 삭제

  • 카드 좌측 스와이프 → 빨강 삭제 버튼.
  • 권한이 없으면 안내: “재고 삭제 권한이 없습니다.”

8-c. 마지막 수정 정보

각 카드의 수정 배지 = “OO 님이 마지막 수정” 표시.

  • 약국장 / 매니저 권한자가 누가 무엇을 변경했는지 빠르게 알 수 있음.
  • “최초 등록” 도 같이 표시.

9. 알약 카운팅

햄버거 메뉴 → 💊 알약 카운팅.

  1. 알약 카운팅 카메라가 열림.
  2. 알약을 평평한 곳에 놓고 사진 촬영.
  3. AI 가 자동으로 갯수 인식.
  4. 저장 → 마지막 수정 약품에 수량 적용.

정확도는 알약 색·모양에 따라 다르며, 인식 결과를 항상 사용자가 확인 후 저장하세요.

알약 카운팅

10. 재고 내보내기 (CSV)

햄버거 메뉴 → 📤 재고 내보내기 (viewer 는 메뉴에 없음).

  1. 수납장 선택 시트 표시.
  2. 체크박스로 다중 선택 (또는 “전체 선택”).
  3. 내보내기 버튼.
  4. 시스템 공유 시트 → 메일/카카오톡/파일 앱 등으로 전송.

10-a. 파일명 규칙

  • 1개 수납장: 20260504_153022_전문의약품.csv
  • 모두: 20260504_153022_전체.csv
  • 부분 (n개 선택): 20260504_153022_전문의약품_외_2개.csv (첫번째 = 표시 순서 가장 작은 수납장)

10-b. CSV 항목

약품명 / 제조사 / GTIN / 수량 / 단위 / 유효기간 / 로트번호 / 수납장 / 칸 / 등록자 / 등록일.

엑셀로 열면 한글이 깨지지 않게 UTF-8 BOM 포함.

재고 내보내기 선택

11. 팀 / 멀티유저

여러 직원이 같은 약국을 함께 사용하는 흐름.

11-a. 4가지 역할 (Role)

역할 한국어 권한
owner 약국장 모든 권한 + 멤버 관리 + 약국 삭제
manager 매니저 재고 모든 / 초청 / 감사 로그
staff 직원 재고 추가·수정·내보내기 (삭제 X / 초청 X)
viewer 뷰어 재고 보기만 (수정·삭제·내보내기 X)

11-b. 권한 매트릭스

기능 owner manager staff viewer
재고 보기 ✅ ✅ ✅ ✅
바코드 스캔 / 수동 추가 ✅ ✅ ✅ ❌
재고 수정 ✅ ✅ ✅ ❌
재고 삭제 ✅ ✅ ❌ ❌
수납장 / 칸 관리 ✅ ✅ ❌ ❌
알약 카운팅 ✅ ✅ ✅ ❌
재고 내보내기 ✅ ✅ ✅ ❌
팀원 초청 ✅ ✅ ❌ ❌
팀원 역할 변경 / 비활성화 ✅ ❌ ❌ ❌
약국 자체 삭제 ✅ ❌ ❌ ❌
약국 이름 변경 ✅ ❌ ❌ ❌
본인 닉네임 변경 ✅ ✅ ✅ ❌
비밀번호 재설정 ✅ ✅ ✅ ✅

11-c. 초청 코드 발급 (owner / manager)

설정 → 초청 코드 관리 → 새 코드 생성 버튼.

  1. 발급 받을 사람의 역할 선택 (owner / manager / staff / viewer).
  2. 만료 기간 (기본 7일).
  3. 생성 → 8자리 코드 + QR 코드 (선택) 표시.
  4. 동료에게 코드 공유 (메시지 / 카카오톡 등).

코드는 1회 사용 만 가능하며 만료 후 자동 폐기됩니다.

11-d. 팀원 합류 (받는 사람)

  1. 받은 코드를 회원가입 또는 §3 약국 합류하기 흐름으로 입력.
  2. 자동으로 해당 역할로 합류.

11-e. 팀 관리 (owner 전용)

설정 → 팀 관리 → 멤버 리스트.

각 멤버 카드:

  • 닉네임 + 역할 + 이메일.
  • 탭하면 액션:
    • 역할 변경 — 4가지 중 선택.
    • 비활성화 — 멤버 추방. 추방된 사람은 자동 강제 로그아웃.
  • 자기 자신은 비활성화 불가 (가드).
  • 마지막 owner 는 강등 / 비활성화 불가 (약국이 owner 없는 상태가 됨).

11-f. 감사 로그 (owner / manager)

설정 → 감사 로그 → 모든 멤버의 활동 이력.

  • 누가 / 언제 / 무엇을 변경했는지 시간순 표시.
  • 검색 / 필터 가능.

팀 관리 감사 로그

12. 동기화 / 클라우드 상태

12-a. 클라우드 상태 아이콘 (메인 화면 우상단)

표시 조건: 약국 멤버 모드 (OnlineMember) 일 때만 보입니다. 혼자 사용 모드 / 인증 후 약국 합류 전에는 데이터가 클라우드로 가지 않으므로 아이콘 자체가 없습니다. (§15 사용 모드 안내 참고.)

  • ☁️ 초록 / 보라 — 정상 연결, 동기화 작동 중.
  • ☁️ 주황 — 재연결 중.
  • ☁️ 빨강 — 오류 (탭하면 동기화 화면).
  • ☁️🚫 — 오프라인.

12-b. 자동 동기화 시점

  • 앱 시작 시 / 포그라운드 복귀 시 자동 (30초 쓰로틀).
  • 약품 추가/수정/삭제 직후 즉시 푸시.
  • 다른 멤버가 변경하면 5초 이내 자동 수신 (실시간 WebSocket).

12-c. 충돌 알림

다른 사람이 같은 약품을 거의 동시에 수정하면:

“다른 사람이 방금 … 약품을 변경했어요”

토스트가 잠시 표시. 항상 최신 시간 의 변경이 우선 (Last Write Wins).

12-d. 오프라인 사용

  • 인터넷이 없어도 모든 기능 사용 가능.
  • 오프라인에서 추가/수정한 데이터는 다음 인터넷 연결 시 자동 푸시.

13. 계정 / 설정

설정 화면 (메인 → 햄버거 → ⚙ 설정) 의 구성은 사용 모드 에 따라 달라집니다.

13-a. 모드별 설정 화면

모드 표시 항목
혼자 사용 로그인 폼 + 회원가입
인증 + 약국 합류 전 약국 만들기 / 합류하기 + 회원탈퇴
약국 멤버 계정 / 초청코드관리 / 팀관리 / 감사로그 / 데이터가져오기 / 로그아웃 + 탈퇴/데이터정리

13-b. 닉네임 변경

설정 → “계정 / 약국” 섹션 → 닉네임 row 탭.

  1. 새 닉네임 입력 (1~30자).
  2. 저장 클릭 → 자동으로 dismiss + 다른 멤버 화면에도 반영 (sync 후).

viewer 는 닉네임 변경 권한이 없습니다 (row 는 표시되지만 tap 비활성).

13-b’. 약국 이름 변경 (약국장만)

약국 이름은 약국장 (owner) 만 변경할 수 있습니다. 매니저 / 직원은 약국 이름 row 가 보이지만 chevron 없이 정보만 표시됩니다.

(약국장) 설정 → “계정 / 약국” 섹션 → 약국 이름 row 탭 → 새 이름 입력 (1~50자) → 저장.

변경 후 다른 멤버 기기는 다음 동기화 (자동 / 수동) 시점에 새 이름으로 갱신됩니다.

13-c. 데이터 가져오기 (owner 전용)

혼자 사용 모드에서 추가했던 데이터 → 약국에 합류 후 온라인 약국으로 이전 가능.

설정 → 데이터 가져오기 (X건) 버튼.

  1. 미리보기 시트 → 옮길 데이터 확인.
  2. 가져오기 클릭 → 약국 데이터에 합쳐짐.

같은 이름의 수납장이 있으면 두 개 다 INSERT 됩니다 (단순 머지).

13-d. 비밀번호 잊었을 때 — 비밀번호 재설정

설정 → 로그인 폼 영역 → 비밀번호 잊으셨나요? 클릭.

  1. 이메일 입력: 가입한 이메일 입력 (현재 폼의 값이 자동 채워집니다) → 재설정 코드 받기.
  2. 6자리 코드 입력: 메일함 확인 → 받은 코드 입력 → 코드 확인.
  3. 새 비밀번호: 8자 이상 + 같은 비번 두 번 입력 → 비밀번호 변경.
  4. 자동으로 메인 화면으로 이동 — 새 비밀번호로 로그인된 상태.

흐름 중 주의:

  • 코드 메일이 안 오면 60초 후 코드 다시 보내기 가능 (카운트다운 표시).
  • 가입하지 않은 이메일을 입력해도 화면은 똑같이 진행되지만 메일이 가지 않습니다 (보안).
  • 새 비밀번호는 이전과 달라야 하며, 너무 짧거나 흔한 비번은 거부될 수 있습니다.

비밀번호 재설정 화면

14. 약국·계정 정리

설정 화면의 탈퇴 / 데이터 정리 섹션.

14-a. 약국 떠나기

이 약국 멤버에서만 빠집니다. 다른 멤버는 그대로 사용 가능.

  • 본인이 약국장이 1명뿐인 경우 → 다른 약국장 임명 또는 약국 자체 삭제 후 가능.
  • 떠난 후 → 자동으로 약국 만들기 / 합류하기 화면 (인증 유지).

14-b. 약국 데이터 초기화 (owner / manager)

이 약국의 모든 약품·수납장·사진·로그가 삭제. 약국과 멤버는 그대로 유지.

  • 빈 약국 + 기본 수납장 1개로 다시 시작.
  • 되돌릴 수 없음.

14-c. 약국 자체 삭제 (owner)

약국과 모든 데이터, 모든 멤버 정보가 영구 삭제.

  • 다른 멤버도 자동으로 강제 로그아웃 (수 초 이내 알림).
  • 자동으로 약국 만들기 / 합류하기 화면 (인증 유지).
  • 서버에서 영구 삭제 — 복구 불가.

14-d. 회원탈퇴

계정 자체를 삭제. 같은 이메일로 다시 가입은 가능하지만 이전 계정의 데이터는 복구 안 됨.

  • 본인이 약국장이 1명뿐인 약국이 있으면 → 약국 자체 삭제 또는 다른 owner 임명 먼저.
  • 탈퇴 후 → 로그인 화면 (혼자 사용 모드).

14-e. 비교 표

액션 약국 데이터 약국 자체 다른 멤버 본인 모드
약국 떠나기 유지 유지 유지 AuthenticatedSolo (인증 유지)
데이터 초기화 삭제 유지 유지 OnlineMember 그대로
약국 자체 삭제 삭제 삭제 강제 로그아웃 AuthenticatedSolo
회원탈퇴 (멤버에 따라) (마지막 owner면 안 됨) 영향 없음 SoloOffline (인증 끊김)

15. 3가지 사용 모드 안내

PharmAlone 은 인증 / 약국 합류 상태에 따라 3가지 모드로 자동 전환됩니다.

15-a. 혼자 사용 (SoloOffline)

  • 상태: 회원가입 안 함 / 로그아웃 / 회원탈퇴 후.
  • 데이터: 이 기기에만 저장. 인터넷 불필요.
  • 표시: 설정에 “혼자 사용 모드” 표시 + 로그인 / 회원가입 입구.
  • 닉네임: “오프라인” 으로 자동 표시.

15-b. 인증 후 약국 합류 전 (AuthenticatedSolo)

  • 상태: 회원가입/로그인은 됐지만 아직 약국에 안 들어감.
  • 데이터: 이 기기에만 저장 (placeholder pharmacy). 약국 합류 시 옮길 수 있음.
  • 표시: 설정에 “내 약국 만들기” / “약국 합류하기” 두 진입점.
  • 닉네임: “오프라인” 으로 자동 표시.

15-c. 약국 멤버 (OnlineMember)

  • 상태: 약국에 정상 합류.
  • 데이터: 클라우드 동기화 + 다른 멤버와 공유.
  • 표시: 권한별 다른 메뉴 (자세히는 §11).
  • 닉네임: 합류 시 정한 본인 이름.

모드는 자동으로 전환되며 사용자가 직접 선택할 필요 없습니다.

16. FAQ

Q. 비밀번호를 잊었어요.

설정 → 로그인 폼 영역 → 비밀번호 잊으셨나요? 클릭. 가입한 이메일로 6자리 코드를 받아 입력 후 새 비밀번호를 정하시면 자동 로그인됩니다. 자세한 흐름은 §13-d 참조.

Q. 코드 다시 보내기 버튼이 안 눌려요.

이메일 인증 코드는 60초 간격 으로만 재발송 가능합니다 (스팸 방지). 버튼에 “X초 후 코드 다시 보내기” 라고 표시되며 0초가 되면 자동으로 활성화됩니다.

Q. 코드를 입력했는데 “코드가 만료되었습니다” 라고 나와요.

OTP 코드는 발급 후 수 분 안에 사용 해야 합니다. 코드 다시 보내기 로 새 코드를 받으세요 (60초 cooldown 후).

Q. 사진을 등록했는데 다른 기기에서 안 보여요.

사진은 자동 동기화되지만 약 5~15초 정도 시간이 걸립니다. 클라우드 아이콘이 초록/보라색이고 잠시 후에도 안 보이면 §17 문제 해결 참고.

Q. “이 작업에 대한 권한이 없습니다” 라고 나와요.

본인의 역할 (role) 이 해당 기능을 사용할 수 없습니다. 약국장에게 권한 변경을 요청하세요.

Q. 다른 사람이 추가한 약품이 안 보여요.

  • 클라우드 아이콘 색상 확인 (초록/보라 = 정상).
  • 앱을 잠시 백그라운드 → 다시 열기 (catch-up 동기화).
  • 그래도 안 되면 클라우드 아이콘 탭 → 동기화 화면에서 수동 동기화 시도.

Q. “이 약국이 삭제되었습니다” 라는 알림이 떴어요.

약국장이 약국을 삭제했습니다. 확인 을 누르면 이 기기의 약국 데이터가 삭제되고 “약국 만들기 / 합류하기” 화면으로 이동합니다 (인증은 유지).

Q. “이 계정은 비활성화되었습니다” 라는 알림이 떴어요.

약국장이 본인을 약국에서 추방했습니다. 확인 을 누르면 이 기기의 약국 데이터가 삭제됩니다. 새 초청 코드를 받으면 다시 합류 가능 (인증 유지).

Q. 회원가입 직후 메일 주소가 UUID 같은 이상한 문자로 표시돼요.

V4 이전 버전 빌드에서 발생하던 회귀입니다. 최신 빌드에서는 정상 표시되며 만약 여전히 보이면 앱을 종료 후 재실행하세요.

Q. 인터넷이 끊겼어요. 어떻게 되나요?

모든 기능이 정상 작동합니다. 추가/수정한 내용은 인터넷 연결 시 자동으로 동기화됩니다.

Q. 같은 약품을 두 사람이 동시에 수정했어요.

가장 최근 시간의 변경이 우선 적용됩니다 (Last Write Wins). 덮어써진 사람의 화면에는 “다른 사람이 방금 … 변경했어요” 토스트가 잠시 표시됩니다.

17. 문제 해결

17-a. 인증 / 로그인

증상 시도
코드 메일 안 옴 스팸함 / 60초 후 재발송 / 다른 이메일 사용
비밀번호 잊음 (향후 추가) — 현재는 새 계정 가입
“Email not confirmed” 받은 코드를 OTP 복구에서 입력
로그인 후 약국 안 보임 약국 합류 안 한 상태 → “약국 만들기 / 합류하기”

17-b. 동기화

증상 시도
클라우드 아이콘 빨강 탭 → 동기화 화면 → 수동 동기화
클라우드 아이콘 주황 자동 재연결 중 (수 초 대기)
변경이 안 보임 백그라운드 → 다시 열기
사진이 빈 썸네일 자동 재시도 됨. 1분 이내 표시

17-c. 카메라 / 스캔

증상 시도
카메라 안 켜짐 시스템 설정 → PharmAlone → 카메라 권한 ON
바코드 인식 안 됨 조명 / 거리 / 흔들림 확인 / 수동 추가
약품명이 안 자동입력됨 DB 에 없는 약품. 수동 입력 후 저장

17-d. 데이터

증상 시도
데이터 사라짐 약국 자체 삭제 또는 약국 데이터 초기화 했을 가능성
다른 약국 데이터 보임 자동 격리됨. 보이면 §19 지원
잘못 추가/삭제 약국장에게 감사 로그 확인 요청

18. 데이터 보호 정책

18-a. 데이터 위치

  • 혼자 사용 모드: 본인 기기에만 저장 (로컬 SQLite). 클라우드로 가지 않음.
  • 약국 멤버: Supabase 클라우드 (서버 위치는 운영팀 안내).

18-b. 보호되는 정보

  • 약품 / 수납장 / 사진 모두 약국 단위로 격리.
  • 다른 약국의 데이터는 절대 접근 불가 (Row-Level Security).

18-c. 약국 자체 삭제

약국장이 약국을 삭제하면:

  1. 즉시: 모든 멤버 강제 로그아웃 + 클라이언트의 데이터 삭제.
  2. 서버 데이터도 영구 삭제 — 복구 불가.

약품 / 수납장 / 사진 등 약국에 속한 모든 데이터가 함께 영구 파기됩니다. 신중히 결정해주세요.

18-d. 회원탈퇴

  • 계정 자체 삭제. 같은 이메일로 다시 가입 가능.
  • 단 이전 데이터는 복구 불가.
  • 본인이 마지막 약국장인 약국이 있으면 → 다른 약국장 임명 또는 약국 자체 삭제 먼저 필요.

18-e. PIPA (개인정보보호법) 합치

  • 사용자가 삭제 요청 시 영구 파기.
  • 백업 / 로그 등 부가 저장소도 동일 정책 적용.

19. 지원 받기

19-a. 앱 내 도움말

메인 화면 → 햄버거 메뉴 → ❓ 도움말.

  • 처음 사용하시는 분을 위한 코치마크 (화면별 안내) 시작.

19-b. 문의

문제 발견 / 기능 요청 / 사용법 질문:

  • (이메일 / 카카오톡 채널 / 전화 — 운영팀 안내).

19-c. 빠른 진단 정보 제출

문제 보고 시 다음 정보 첨부 권장:

  • 기기 종류 / OS 버전 (예: iPhone 15 Pro / iOS 17.4).
  • 앱 버전 (설정 → 정보).
  • 발생 시각 + 절차.
  • 가능하면 화면 캡처.

끝

PharmAlone 을 사용해주셔서 감사합니다 🙏

마지막 업데이트: 2026-05-06