운영 FAQ와 문제 해결
이 문서는 AnyVet Smart 운영 중 자주 발생하는 질문을 빠르게 정리한 실무형 FAQ입니다.
Q. 재고가 실제보다 적거나 많게 보입니다.
먼저 아래 순서로 확인합니다.
/stock메인에서Show Depleted Lots를 켭니다.- lot별 잔량과 만료 lot를 확인합니다.
/stock/movement-history에서 최근PURCHASE,WITHDRAWAL,ADJUSTMENT,SALE이력을 봅니다.- 필요하면
Adjustment문서를 새로 만듭니다.
관련 문서:
Q. PO는 만들었는데 재고가 늘지 않았습니다.
PO 생성만으로는 재고가 증가하지 않습니다. 실제 재고 증가는 Receive 처리 후 반영됩니다.
확인 순서:
- PO 상태를 확인합니다.
RECEIVED또는PARTIALLY_RECEIVED처리 여부를 봅니다./stock/receive-order에서 입고 이력이 생성됐는지 확인합니다.
Q. 직원이 Admin 메뉴를 못 봅니다.
코드 기준 관리자 메뉴는 super_admin, admin 역할만 기본 접근 대상입니다. 먼저 계정 역할을 확인하세요.
관련 문서:
Q. Grooming 또는 Pet Taxi 메뉴가 안 열립니다.
역할 문제일 수도 있지만, 먼저 지점 기능 활성화 여부를 확인해야 합니다.
확인 순서:
- 해당 지점의 시설 설정을 엽니다.
Grooming또는Pet Taxi기능이 활성화돼 있는지 확인합니다.- 지점 전환을 잘못한 것은 아닌지 봅니다.
- 그다음 계정 역할과 메뉴 접근 범위를 확인합니다.
관련 문서:
Q. Hotel, Grooming, Pet Taxi에서 방/스테이션/차량이 이상하게 보입니다.
대부분은 리소스 마스터 설정 또는 보기 모드 차이에서 발생합니다.
확인 순서:
- 현재 화면이
booking보기인지daily보기인지 확인합니다. - 운영 허브에서 객실, 스테이션, 차량 리소스가 실제 운영 구조와 맞는지 봅니다.
- 당일 시간 문제인지, 기간 예약 문제인지 구분합니다.
- 이름이 중복되거나 비활성 리소스가 남아 있지 않은지 확인합니다.
관련 문서:
Q. 누가 데이터를 바꿨는지 찾고 싶습니다.
/admin/logs에서 사용자, 카테고리, 액션, 검색어로 좁힌 뒤 상세 시트의 diff를 확인합니다.
관련 문서:
Q. 보고서 숫자가 예상과 다릅니다.
대부분은 기간 또는 상태 필터 차이에서 발생합니다.
확인 순서:
- 날짜 범위를 다시 맞춥니다.
- 지점, 사용자, 상태 필터를 초기화합니다.
- export 전 정렬과 검색어가 남아 있지 않은지 봅니다.
Q. 수익 배분 보고서를 못 봅니다.
Revenue Shared는 관리자 계열 역할과 고급 리포트 기능이 필요한 화면입니다. 계정 역할과 병원 플랜을 먼저 확인하세요.
Q. Receipt에서 방금 만든 청구가 안 보입니다.
/pos/receipt은 현재 PAID, VOID 상태만 조회합니다. 아직 결제 전인 ISSUED 청구는 Shop이나 미결 청구 선택 흐름에서 확인해야 합니다.
관련 문서:
Q. 세금계산서가 출력되지 않습니다.
프린터 문제로 보기 전에 고객 주소와 Tax 정보 전제를 먼저 확인합니다.
확인 순서:
- 대상 Bill이 이미 결제 완료 상태인지 확인합니다.
- 보호자 주소가 충분히 입력돼 있는지 봅니다.
- Full Tax 전환이 필요한 Bill인지 확인합니다.
- 그다음 출력 모달에서 고객 정보가 올바르게 로드되는지 봅니다.
관련 문서:
Q. 결제는 끝냈는데 추가 서비스 청구가 빠졌습니다.
서비스성 예약은 체크아웃 시점 장바구니를 다시 확인해야 합니다. 특히 Hotel, Grooming, Pet Taxi는 종료 직전 추가 서비스가 가장 많이 누락됩니다.
권장 대응:
- 예약 상세와 체크아웃 단계에서 추가 서비스 누락 여부를 다시 봅니다.
- 이미 결제가 끝났다면 Receipt와 결제 이력을 먼저 확인합니다.
- 필요한 경우 정정 또는 추가 청구를 운영 기준에 따라 처리합니다.
관련 문서:
Q. 수의사 SOAP 형식을 병원 표준으로 맞추고 싶습니다.
/admin/hospital/templates의 SOAP 템플릿을 먼저 정리하세요. 개별 사용자에게 구두로 요청하는 방식보다 템플릿 표준화가 효과적입니다.
Q. 로그인 실패 알림이 갑자기 많아졌습니다.
감사 로그의 LoginFailed 추세를 먼저 확인하고, 특정 사용자나 특정 IP에 집중되는지 봅니다. 필요하면 해당 사용자를 강제 로그아웃하거나 비밀번호 재설정을 안내합니다.
Q. 만료 예정 약품이 계속 쌓입니다.
/stock의 Expiring Soon 위젯과 Inventory Finance의 만료 리스크를 함께 보세요. 원인은 대개 과다 lot 입고, 느린 회전율, 카테고리별 발주 정책 부재입니다.
Q. 문서상 기능과 실제 화면이 조금 다릅니다.
이 사용자 문서는 현재 코드 기준으로 작성되지만, 릴리스 직후 UI가 바뀌면 일부 위치나 용어가 달라질 수 있습니다. 우선 메뉴 라우트와 버튼 명칭이 같은지 확인하고, 차이가 크면 문서를 갱신해야 합니다.