S07 — 보고서 · 재무제표 · HTTP API

학습 목표

1. 보고서 원칙

보고서는 새 데이터를 만들지 않습니다. 그래서 서로 맞아야 합니다.

2. 얇은 API

HTTP 요청 ─▶ handle(conn, method, path, body, user) ─▶ ErpSession ─▶ 업무 모듈
                └ (status, JSON) 변환만                └ 권한·감사    └ 규칙

handle()은 네트워크 없이 테스트할 수 있는 순수한 함수입니다. 서버 코드(make_server)는 제공됩니다.

오류 매핑: 사용자 없음/미등록 → 401, PermissionDenied → 403, ErpError → 400, 없는 경로 → 404. 순서 주의: PermissionDenied 는 ErpError 의 하위 클래스이므로 먼저 잡아야 합니다.

3. LAB

workspace/erp/reports.py

함수요점
stock_status활성 품목 전체(재고 없는 품목 포함 → LEFT JOIN), 예약·가용·평균단가·상태
sales_by_customerSHIPPED 수주만, 공급가 내림차순
financial_statements시산표 행을 유형별로 합산 → 손익·재무상태·채권·채무·부가세

workspace/erp/api.py

함수요점
handledocstring의 라우트 표 그대로. 정규식 3개는 제공됨

4. 채점과 실행

python academy.py check S07
python academy.py serve

브라우저에서 http://127.0.0.1:8080 → 대시보드. API 호출 예:

curl -H "X-User: kim" -H "Content-Type: application/json" -d "{\"supplier\":\"SUP-HANBIT\",\"lines\":[[\"MASK-KF94\",10,18000]]}" http://127.0.0.1:8080/api/po

5. 심화 과제