# 청구스 앱

> 청구·수금·미수 자동화 서비스 청구스 입니다. 견적서 → 청구서 → 세금계산서 → 수납까지 한 곳에서 처리합니다.
> 로그인이 필요한 웹 앱입니다. 이 파일은 앱의 화면 지도와 작업 규칙을 담고 있습니다.

## 시작 전에
- 주소 구조: https://app.chungoose.ai/orgs/{org}/teams/{team}/... — {org}=조직, {team}=팀.
- {org}와 {team}은 로그인한 뒤에만 현재 탭 URL에서 읽을 수 있습니다. 아래 순서를 따릅니다.
  1. 로그인 화면이면 자동 로그인을 기다리거나, 사용자에게 로그인을 요청합니다.
  2. 로그인하면 앱이 자동으로 이동합니다. 팀이 하나면 팀 홈(/orgs/{org}/teams/{team}), 여러 개면 조직
     홈(/orgs/{org})입니다.
  3. 현재 URL에서 {org}와 {team}을 읽습니다. {team}이 없으면 짐작하지 말고 사용자에게 어느 팀에서 작업할지
     묻습니다. 팀 목록은 조직 홈과 사이드바 상단 전환 메뉴에 있습니다.
- 사용자가 말한 조직·팀이 현재 URL과 다르면 사이드바 상단 전환 메뉴에서 바꿉니다. 문서는 팀별로 나뉩니다.
- URL의 문서 ID는 암호화된 값입니다. 추측해서 조합하지 말고 목록·검색에서 찾아 엽니다.
- 하위 메뉴 안에 있는 화면이나 filter가 걸린 목록은 아래 경로를 직접 열면 클릭 단계를 줄일 수 있습니다.

## 화면 지도
- 대시보드: /orgs/{org}/teams/{team}/dashboard
- 견적서: /orgs/{org}/teams/{team}/quotations
  - 새로 만들기: /orgs/{org}/teams/{team}/quotations/new
- 청구서: /orgs/{org}/teams/{team}/invoices
  - 연체: /orgs/{org}/teams/{team}/invoices?category=is_overdue
  - 미수: /orgs/{org}/teams/{team}/invoices?category=is_outstanding
  - 예약·대기: /orgs/{org}/teams/{team}/invoices?category=is_pre
  - 수납 완료: /orgs/{org}/teams/{team}/invoices?category=is_settled
  - 새로 만들기: /orgs/{org}/teams/{team}/invoices/new
  - 대량등록: /orgs/{org}/teams/{team}/invoices/bulk_new
- 반복 청구: /orgs/{org}/teams/{team}/recurring_invoices
  - 새로 만들기: /orgs/{org}/teams/{team}/recurring_invoices/new
- 세금계산서 > 매출: /orgs/{org}/teams/{team}/tax_invoices/sale
  - 새 세금계산서 발급: /orgs/{org}/teams/{team}/tax_invoices/sale/new
  - 대량등록: /orgs/{org}/teams/{team}/tax_invoices/sale/bulk_new
- 세금계산서 > 매입: /orgs/{org}/teams/{team}/tax_invoices/purchase
- 계약서: /orgs/{org}/teams/{team}/contracts
  - 새로 만들기: /orgs/{org}/teams/{team}/contracts/new
- 고객: /orgs/{org}/teams/{team}/customers
  - 사업자 고객 등록: /orgs/{org}/teams/{team}/customers/new/corp
  - 개인 고객 등록: /orgs/{org}/teams/{team}/customers/new/ind
  - 대량등록: /orgs/{org}/teams/{team}/customers/bulk_new
- 품목: /orgs/{org}/teams/{team}/products
  - 새로 만들기: /orgs/{org}/teams/{team}/products/new
- 입출금: /orgs/{org}/teams/{team}/deposits
- AI 입금 매칭: /orgs/{org}/teams/{team}/deposits/ai_matching_review
- 수납 내역: /orgs/{org}/teams/{team}/pmts
- 대량등록: /orgs/{org}/teams/{team}/bulk_regs
- 알림 발송 내역: /orgs/{org}/teams/{team}/deliveries
- 견적 · 청구 설정: /orgs/{org}/teams/{team}/team_config/edit
- 팀 구성원: /orgs/{org}/teams/{team}/members
- 구성원 관리: /orgs/{org}/members
- 사업자: /orgs/{org}/vendors

## 용어
- 청구서: 고객에게 결제를 요청하는 문서입니다. 청구서마다 청구 프로세스를 하나 고릅니다.
- 청구 프로세스: 청구서의 진행 방식입니다(세금계산서, 현금영수증, 카드, CMS 자동이체, 단순청구).
  세금계산서 발급·청구 알림·입금 확인·연체 알림을 어떤 순서로 진행할지 정합니다.
- 자동화: 청구 프로세스의 단계를 조건(청구일 도래, 전액 수납 등)에 맞춰 자동으로 실행하는 기능입니다. 청구서
  상세의 "청구 프로세스" 카드에서 켜고 끕니다.
- 청구 세금계산서 / 영수 세금계산서: 입금 전에 발급하면 청구, 입금을 확인한 뒤 발급하면 영수입니다.
- 입금: 연동한 은행 계좌에 들어온 거래 내역입니다. 청구서에 연결해야 수납이 됩니다.
- 수납: 청구서에 받은 돈을 등록한 기록입니다. 입금·카드·CMS·현금 등으로 생깁니다.
- 자동 수납 / AI 입금 매칭: 입금의 금액과 적요가 청구서와 정확히 맞으면 자동으로 수납됩니다. 비슷하기만 하면
  AI 입금 매칭에 추천으로만 올라오고, 담당자가 확인해 수납합니다.
- 사업자 고객 / 개인 고객: 고객 유형입니다. 세금계산서를 발급하려면 고객의 사업자등록번호와 대표자명이
  있어야 합니다.
- 공급측 담당자 / 고객측 담당자: 우리 회사 쪽 담당자와 고객 쪽 담당자입니다. 청구서는 고객측 담당자의
  이메일·휴대폰번호로 발송됩니다.

## 자주 하는 작업
- 고객·품목 고르기: 청구서 작성과 세금계산서 발급 화면에서는 등록된 고객과 품목을 검색해 고를 수 있습니다.
  찾는 고객이나 품목이 없으면 새로 입력합니다.
- 청구서 만들기: 새 청구서에서 고객·청구 프로세스·품목을 입력합니다. 청구 프로세스가 세금계산서나
  현금영수증이면 [다음]을 눌러 증빙 내용을 확인합니다. 마지막에 [저장] 또는 [저장 및 자동화]를 누릅니다.
  - [저장]: 청구서만 저장하고 아무것도 보내지 않습니다.
  - [저장 및 자동화]: 저장과 함께 자동화를 시작합니다. 청구일이 오늘이면 세금계산서 발급·청구 알림이 바로
    진행되고, 미래 날짜면 그날 진행됩니다.
- 저장한 청구서 진행하기: 청구서 상세의 "청구 프로세스" 카드에서 [자동화 시작]을 누릅니다. 특정 단계의
  알림만 지금 보내려면 그 단계의 [직접 발송]을 씁니다. 받는 사람을 "나에게"로 고르면 내용만 확인할 수
  있습니다.
- 견적서를 청구서로 전환: 견적서 상세의 [작업] > [청구서로 전환]을 누르면 고객·품목·금액이 채워진 청구서 작성
  화면이 열립니다.
- 세금계산서 발급
  - 청구서에 딸린 세금계산서: 청구 프로세스 카드의 해당 단계에서 [발급하기]를 누릅니다.
  - 청구서 없이 세금계산서만: 매출 세금계산서의 [새 세금계산서 발급]에서 입력하고 [발행하기]를 누릅니다.
    입금 확인·연체 알림은 진행되지 않습니다.
- 입금 수납: AI 입금 매칭에서 청구서별 추천 입금과 근거 배지를 확인하고 [수납]을 누릅니다. 맞지 않는 추천은
  [추천 제외]를 누릅니다. 추천에 없는 입금은 청구서 상세의 수납 내역에서 [수납] > [직접 선택]으로 고릅니다.
- 여러 건 등록: 대량등록 화면에서 [대량 등록 양식 다운로드]로 양식을 받아 채운 뒤 올립니다. 올리면 검증
  결과만 보이고, [저장] 또는 [등록 및 자동화]를 눌러야 등록됩니다. 결과는 대량등록 등록 내역에서 확인합니다.

## 되돌릴 수 없는 동작
아래 동작은 되돌릴 수 없거나 고객에게 바로 전달됩니다. 실행 전에 대상과 내용을 사용자와 확인하세요.
- 세금계산서 발급([발급하기], [발행하기], 세금계산서가 포함된 [저장 및 자동화]): 국세청에 전송됩니다. 삭제할
  수 없고 수정은 수정세금계산서로만 합니다.
- [저장 및 자동화], [자동화 시작], [등록 및 자동화], 받는 사람이 "고객에게"인 [직접 발송]: 고객에게
  이메일·알림톡이 나갑니다.
- 카드·CMS 결제 청구, 수납 처리
- 구성원 초대·권한 변경, 결제수단 삭제

## 막히면
- 사이드바의 "상담 문의하기"를 누르면 AI 매니저 연희와 상담할 수 있습니다.
- [사용 설명서](https://guide.chungoose.kr/)
- [사용 설명서 llms.txt](https://guide.chungoose.kr/llms.txt)

## 개발자용
- [GraphQL API 문서](https://app.chungoose.ai/graphql/docs)
- [GraphQL SDL](https://app.chungoose.ai/graphql/schema)
- API key 발급: /orgs/{org}/developer/api