S07 — 보고서 · 재무제표 · HTTP API
학습 목표
- 원장을 집계해 재고현황·거래처별 매출·재무제표를 만든다.
- 업무 로직과 HTTP 계층을 분리한 "얇은 API"를 구현한다.
1. 보고서 원칙
보고서는 새 데이터를 만들지 않습니다. 그래서 서로 맞아야 합니다.
- 재고현황 금액 합계 = 원장 1300 잔액
- 재무상태표: 자산 = 부채 + 자본(자본금 + 당기순이익)
- 납부할 부가세 = 부가세예수금(2200) − 부가세대급금(1400) (음수면 환급)
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_customer | SHIPPED 수주만, 공급가 내림차순 |
financial_statements | 시산표 행을 유형별로 합산 → 손익·재무상태·채권·채무·부가세 |
workspace/erp/api.py
| 함수 | 요점 |
|---|---|
handle | docstring의 라우트 표 그대로. 정규식 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/po5. 심화 과제
GET /api/reports/stock?status=임시품절필터.- 쇼핑몰 연동용
GET /api/catalog— 판매가능 품목과 가용재고만 공개(원가 숨김). - 기간별 손익(
?from=&to=) — journals.jdate 조건.