이용 안내

눌러 볼 것

• 자연어로 한 줄 써서 축이 자동으로 붙는지
• 추천회원 게시물이 상단에 오는지

이렇게 읽습니다

• AI 가 못 맞춘 축은 unmapped 로 남고 지어내지 않는다. 선택 목록을 주고 사람이 고른다.

눌러 볼 것

• 수락 전에는 연락처가 가려져 있는지

이렇게 읽습니다

• 연락처 공개와 계약 승인은 다른 단계다. 수락했다고 계약이 된 것은 아니다.

눌러 볼 것

• 3단계로 넘어가는지
• “전부 양호” 로 한 번에 고르기
• 서식을 눌러 원래 크기로 키워 보기

이렇게 읽습니다

• 처음에는 화면 폭에 맞춰 전체가 보이고, 누르면 원래 크기가 된다.
• 표기는 ○ · × · 미 셋뿐이다. 해당 월이 아닌 날은 빈칸이 아니라 아예 칸이 없다.

눌러 볼 것

• 차주별 작성·미작성·불량 건수
• 열 정렬

이렇게 읽습니다

• 미작성이 많으면 알림대장에서 그 차주들만 걸러 안내를 보낼 수 있다.

눌러 볼 것

• 경유를 건너뛰고 도착을 눌러 보기
• 재접속 후에도 남아 있는지

이렇게 읽습니다

• 경유 미보고 상태로 도착은 막힌다.
• 대기료는 무료 2시간을 빼고 30분 단위로 올림한다.

눌러 볼 것

• 단계를 건너뛰어 보기
• 명세서 발행 후 알림대장에서 발송
• 지급일별 비례 분할(2~3회)에서 원 단위가 뒤 순번 지급일에 붙고 공제는 차주별 한 번인지
• PDF 다운로드가 파일로 저장되는지 — 아니면 오류 문구에 제공자 응답 형식(HTTP 상태·본문 앞부분)이 보이는지
• 취소 재개 때 서버가 고정한 원래 사유가 자동으로 채워지는지(재접속 뒤에도)

이렇게 읽습니다

• 앞 단계가 끝나지 않으면 다음이 열리지 않는다.
• 정정본은 원본과 같은 증빙 종류로만 발행된다(종류는 서버가 원본에서 가져온다).
• 발행 직전 검사에서 거절되면 진행 표시가 바로 풀려 ④ 를 다시 누를 수 있다(제공자를 부른 뒤의 실패만 「재확인」으로 잇는다).
• 명칭은 용역비지급대장 · 용역비지급명세서 · 차량공제대장 으로 고정이다.
• PDF 는 서버가 제공자에게서 실제 바이트(%PDF-·쪽 수·SHA-256)를 확인한 뒤 내려준다. 새 창의 빈 화면(1.0.0)은 이제 화면에 오류로 보인다.
• 비례 분할은 원천 항목마다 누적 비율로 나눈다 — 분할 순서를 바꾸면 원 단위가 붙는 자리도 바뀐다.

눌러 볼 것

• “도달 결과 조회·반영” 을 눌러 접수 → 도달로 바뀌는지
• 열 이름 정렬, 회원별 좁히기
• CSV 를 받아 화면과 같은 순서·같은 시각인지

이렇게 읽습니다

• 접수(SENT)와 도달(DELIVERED)은 다른 사건이다. 접수는 제공자가 받았다는 뜻일 뿐이다.
• 도달 코드는 1000 하나만 성공이다. 3003 은 수신 번호 형식 오류 또는 결번.
• 도달시각은 제공자가 준 실제 시각이다 — 버튼 누른 시각이 아니다.
• “제공자가 일부 구간에서 전체 결과를 돌려주지 않았습니다” 가 뜨면 구간을 좁혀 다시 조회하라. 넓은 창에서는 제공자가 오래된 쪽만 준다.
• 도달하지 못한 건은 과금이 0 으로 되돌아간다.

눌러 볼 것

• 경로별 단건 발송
• MMS 첨부 1·2·3장
• 전체선택 다량 발송
• 예약 등록·취소

이렇게 읽습니다

• 여기 수신처는 환경변수에 등록된 시험 번호다. 차주 실번호가 아니다.
• MMS 는 JPG 3장·각 300KB·합계 800KB·1000px 가 경계다. 넘으면 접수 전에 막힌다.

눌러 볼 것

• 맨 위 시험 절차표 — 기록으로 판정한다 (9/9 가 기준)
• 내 회원사 지갑 잔액과 원장 연속성이 “끊김 없음” 인지
• 카드 4242 는 승인, 4000 0000 0000 0002 는 거절 (모의 PG)
• 계좌이체는 운영사 관리자가 입금 확인해야 지갑에 들어간다
• 운영사 관리 절은 프로그램 관리자에게만 보인다

이렇게 읽습니다

• 두 정산은 별건이다. 팝빌↔동서물류 요금(/popbill 장부)과 동서물류↔회원사 지갑(이 화면)을 섞지 않는다.
• 카드는 카드매출전표가 증빙이라 현금영수증을 겹쳐 내지 않는다. 이체는 현금영수증 또는 세금계산서를 반드시 낸다.
• 이미 쓴 충전금은 환불되지 않는다(REFUND_EXCEEDS_BALANCE). 발행된 증빙이 있는 건은 운영사만 취소한다.
• 증빙 발행이 실패하면 실패로 남고 “증빙 재발행” 으로 회복한다. 재시도는 이전 문서번호를 먼저 조회해 이중 발행을 막는다.
• 설계·실측·리뷰 결과는 docs/MEMBER-SETTLEMENT-20260923.md, 감사 절차는 docs/AUDIT-REQUEST-20260923.md, 감사 반영은 docs/AUDIT-RESPONSE-20260924.md.
• 회원 카드 충전이 "닫힘" 이면 서버 자격(SUPABASE_SERVICE_ROLE_KEY)이 없는 것이다 — 회원 토큰으로 대신 확정하지 않는다. 계좌이체는 열려 있다.

눌러 볼 것

• 맨 위 “지금 환경” 이 테스트인지
• 연동회원 · 잔여 포인트가 보이는지
• 예금주 조회 — 은행과 계좌번호로
• 발행은 테스트 환경에서만 열린다

이렇게 읽습니다

• 발행은 되돌릴 수 없다. 세금계산서·현금영수증은 국세청으로 가고 취소·수정발행이 기록에 남는다.
• 접수(code 1)는 국세청 신고가 아니다. 팝빌이 받았다는 뜻이고, 전송 결과는 문서 상태로 따로 확정된다.
• 세액은 화면이 아니라 서버가 계산한다. 품목 합계와 어긋나면 보내지 않는다.
• 현금영수증 식별번호는 소득공제용=휴대전화 · 지출증빙용=사업자번호다. 바꿔 넣으면 쓸 수 없는 영수증이 된다.
• 세금계산서는 팝빌에 공동인증서가 먼저 등록되어야 발행된다.

눌러 볼 것

• 사업자번호 10자리를 넣으면 조회 버튼이 열리고 누르기 전에 금액이 뜬다
• 검증번호가 틀린 번호(예: 124-81-00999)를 넣어 보기
• 같은 번호를 다시 조회해 보기

이렇게 읽습니다

• 계속사업자는 초록, 폐업·미등록은 빨강. 국세청은 미등록 번호에도 status_code: OK 를 주므로 색과 문구로 가른다.
• 검증번호가 틀리면 버튼이 닫힌다 — 국세청에 묻지 않고 요금도 나가지 않는다.
• 재조회 무료 기간(관리자 설정, 현재 3일) 안이면 “저장된 결과입니다” 로 무과금. 최신이 필요하면 “다시 조회”.
• 거래상대가 회원이어도 상대의 정보는 보이지 않는다. 회원이라는 사실만 알려 준다.

눌러 볼 것

• 값을 바꿔 저장한 뒤 변경 이력에 줄이 쌓이는지
• 등급을 2~3단계로 줄이고 뒤를 비워도 되는지

이렇게 읽습니다

• 저장은 덮어쓰지 않고 새 줄로 쌓인다. “그때 얼마로 청구했나” 에 답할 수 있어야 하기 때문이다.
• 비운 칸은 저장하지 않는다. 0 원과 “아직 안 정함” 은 다르다.
• 재조회 무료 기간이 0 이면 누를 때마다 과금한다.

눌러 볼 것

• 각 단계에서 해당 화면으로 넘어가지는지

이렇게 읽습니다

• 처음 보는 사람에게 전체 그림을 보여 주는 화면이다. 여기서 시작해 각 화면으로 흩어지면 길을 잃지 않는다.

눌러 볼 것

• 숫자가 0 이 아닌지
• 각 칸의 링크가 해당 화면으로 가는지

이렇게 읽습니다

• 숫자가 모두 0 이면 로그인이 풀렸거나 승인 회원이 아니다. 화면 오른쪽 위 로그인 줄을 먼저 보라.

눌러 볼 것

• 오류 코드 표의 코드가 화면에 뜬 코드와 같은지
• 감사 F01~F16 표가 docs/AUDIT-RESPONSE-20260924.md 와 같은지

이렇게 읽습니다

• 환불은 지갑으로 되돌리는 내부 환불이다. 실제 카드 취소·송금은 하지 않는다.
• 증빙 재발행은 이전 문서번호를 팝빌에서 먼저 조회해 승계한다 — 두 번 내지 않는다.

정상 신호

• 상태 정상(configured)
• 콘솔 Issues 가 비어 있거나, 있어도 전부 “처리됨”

이러면 이런 뜻

같은 오류가 반복해서 쌓임

한 번 터지고 마는 것이 아니라 경로 자체가 깨져 있다. Issue 를 열어 어느 라우트인지와 몇 명에게 일어났는지를 본다.

Issues 가 계속 0 인데 화면은 오류를 보여 줌

Sentry 가 그 경로를 감싸지 않은 것이다. 브라우저 오류는 잡히지만 서버 라우트에서 삼킨 예외(catch 로 감춘 것)는 올라오지 않는다.

/api/error-test 를 눌러도 콘솔에 안 뜸

키가 안 붙었거나 전송이 막힌 것. 이 경로는 일부러 터뜨려 보는 시험용이다.

정상 신호

• synced_marker: true — 동기화를 한 적이 있다는 표식

이러면 이런 뜻

runtime 관련 값이 없음

정상이다. 앱은 Infisical 을 직접 부르지 않는다. /integrations 가 이것을 “확인이 필요한 것” 에 적는 것은 설명일 뿐 결함이 아니다.

Infisical 에서 값을 바꿨는데 앱이 옛 값을 씀

당연하다. Vercel 환경변수를 고치고 재배포해야 바뀐다. Infisical 만 고치면 앱은 모른다.

정상 신호

• health.status: OK
• 게시판에서 자연어를 한 줄 넣은 뒤 traces_24h 가 늘어난다

이러면 이런 뜻

ok: true 인데 traces_24h 가 0

키와 연결은 정상인데 계측이 안 붙은 것이다. 실제로 게시판 AI 라우트 5개가 누락돼 닷새간 추적이 0 건이었다. 계측은 라우트마다가 아니라 lib/llm.js 의 호출부에 붙인다.

Traces 는 있는데 전부 실패

Qwen 쪽 키·예산 한도를 본다. 성공·실패 양쪽을 남기므로 실패도 여기 뜬다.

listTraces(n) 의 개수를 “전체”로 읽음

n 건만 돌려준다. 반환 개수를 총계로 읽으면 안 된다.

정상 신호

• 다섯 노드가 모두 그려지고 onto_search 가 규칙·LLM 두 갈래를 모두 기다린다
• 실패 시 값이 “규칙 결과만 사용” 류 — LLM 이 죽어도 화면이 멈추지 않는다

이러면 이런 뜻

llm_intent 만 동작하고 rule_intent 가 비어 있음

규칙이 빠진 것. LLM 이 느리거나 죽으면 아무 답도 못 낸다. 규칙은 LLM 의 보조가 아니라 바닥이다.

캐시가 꺼져 있음

같은 문장을 다시 물을 때마다 돈이 나간다. TTL 값이 보이는지 확인.

unmapped 가 안 보이고 축이 늘 가득 참

환각을 의심하라. 못 맞춘 축은 비어 있어야 정상이다.

정상 신호

• signing_ready: true — 서명 키가 있다. 없으면 크론 경로는 503 으로 닫는다(유료 발송이 걸린 자리라 열어 두지 않는다)
• 스케줄이 모두 「동작」이고 마지막 결과가 「성공」이다 — 「동작」만으로는 일이 됐는지 모른다
• 예약 발송의 last 가 ok: true · worker_status: 200 이다. 보낼 예약이 없으면 claimed: 0 이 정상이다

이러면 이런 뜻

last.ok: false, worker_status: 403

스케줄은 도는데 일은 안 된 것이다. 2026-09-20 에 그랬다 — 크론이 회원 세션을 요구하는 경로를 두드려 매 실행이 403 이었는데 QStash 는 DELIVERED, 화면은 초록이었다. 09-28 부터는 워커를 서버 자격으로 직접 부른다. 이 값이 다시 보이면 같은 종류의 고장이다.

스케줄이 「멈춤」

끈 것이다. 켜고 끄는 것은 소유자가 정한다. 예약 발송이 멈춰 있는 동안 알림·문자 시험 화면의 예약은 그 화면의 「도달한 예약 발송 실행」 단추로만 나간다.

콘솔에서 스케줄이 안 보임

지역이 eu 다. us 로 조회하면 0 건이 나와 “사라졌다”고 오해한다.

DELIVERED 인데 아무 일도 안 일어남

QStash 는 우리 경로가 HTTP 200 을 주면 성공으로 센다. 그 안에서 실패했는지는 last(화면의 「마지막 결과」)를 봐야 안다.

정상 신호

• ok: true 와 응답 시간(ms)이 보인다
• 같은 검색을 두 번 하면 적중률이 오른다

이러면 이런 뜻

적중률 0% 인데 검색을 여러 번 함

캐시 키가 매번 달라 재사용이 안 되는 것. 돈과 시간이 그대로 나간다.

쓰기 실패 / 메모리 한도

가장 위험한 신호다. 멱등과 한도가 여기 얹혀 있어 막히면 실발송이 통째로 차단된다. eviction 이 켜져 있어야 한다.

발송했는데 “이미 처리된 요청” 이라고 나옴

같은 요청키가 이미 있는 것. 되돌려 보내지 않는 것이 정상이다 — 다시 보내지 말고 조회하라.

정상 신호

• 상태 online
• 개념 노드 수 · BROADER 관계 수 · 화물 노드 수가 0 이 아니다
• 아래 표에 Cargo -HAS-> Concept, Concept -BROADER-> Concept 두 줄이 보인다

이러면 이런 뜻

상태를 못 읽음 / 접속 실패

3일 미사용이면 AuraDB Free 가 자동 일시정지된다. 그래서 매일 03:00 KST 에 깨우기 질의를 돌린다. 이 값이 죽어 있으면 깨우기 스케줄부터 본다.

개념 수가 갑자기 늘어남

시드를 넓힌 것이다. 화물등록 LLM 프롬프트가 같이 넓어져 호출 비용이 는다 — Langfuse 에서 토큰 수를 같이 확인하라.

관계가 0 인데 노드는 많음

개념만 넣고 상하 관계를 안 넣은 것. 검색 확장이 동작하지 않는다.