ERP Academy 커리큘럼 설계서
1. 목표
수료하면 다음을 코드로 증명할 수 있다.
- ERP의 기본 구조(기준정보 → 거래 → 원장 → 보고서)를 설명하고 테이블로 설계한다.
- 구매·판매·재고·회계가 하나의 트랜잭션 안에서 동시에 움직이는 업무 처리를 구현한다.
- 복식부기 분개를 자동 생성하고, 시산표·재무상태표 등식이 항상 맞도록 만든다.
- 권한·직무분리·감사로그로 내부통제를 구현한다.
- 업무 로직을 HTTP API로 노출하고, 운영 DB/배포로 확장하는 경로를 안다.
2. 대상과 전제
- Python 기초 문법(함수, dict/list, 예외, with 문)을 아는 개발자 또는 기획자
- SQL은 SELECT/INSERT/UPDATE 정도만 알면 시작 가능 (교재에서 필요한 만큼 설명)
- 회계 지식은 필요 없음 — S02에서 개발자 관점으로 복식부기를 처음부터 다룸
3. 교수 설계 원칙
| 원칙 | 적용 방식 |
|---|---|
| 만들면서 배운다 | 교재는 개념 → 데이터 모델 → LAB 명세 순. 실습이 학습 시간의 70% |
| 명세 = 테스트 | LAB docstring이 요구사항이고, tests/ 가 인수 기준. 통과 = 완료 |
| 누적 구조 | 단계 N은 0~N-1의 코드를 실제로 호출. 앞 단계의 실수가 뒤에서 드러남 |
| 실무 도메인 | 약국 MRO 유통(마스크·에탄올·거즈, 약국 고객, 면세 품목, 유통기한) |
| 불변식 중심 | "재고금액 = 원장 1300", "차변 = 대변", "자산 = 부채 + 자본"을 매 단계 검사 |
| 막히면 정답 참고 | reference/ 공개. 단, 먼저 30분 고민 → 그다음 비교 |
| 건너뛰기 허용 | init --upto S0N 으로 관심 단계부터 시작 가능 |
4. 주차 계획 (주 6~8시간 기준, 총 10주)
| 주 | 단계 | 학습 내용 | 산출물 / 통과 기준 |
|---|---|---|---|
| 1 | S00 | ERP 개념, 모듈 지도, 스키마 읽기, 트랜잭션·SAVEPOINT | check S00 6/6 |
| 2 | S01 | 기준정보 설계, 코드 정규화, 체크섬 검증, soft delete | check S01 10/10 |
| 3 | S02 | 복식부기, 계정 유형과 정상잔액, 시산표, 역분개, 부가세 | check S02 6/6 |
| 4 | S03 | 수불원장, 이동평균원가, 반올림 잔차 제거, 실사조정 분개 | check S03 8/8 |
| 5 | S04 | 상태머신, 발주·승인·분할입고, 매입 분개 | check S04 5/5 |
| 6 | S05 | 가용재고·할당, 출고, 매출/매출원가 분개, 임시품절 | check S05 5/5 + demo 정상 |
| 7 | S06 | RBAC, 직무분리, 감사로그, 세션 객체 | check S06 6/6 |
| 8 | S07 | 보고서, 재무제표, HTTP API, 대시보드 | check S07 5/5 + serve 동작 |
| 9 | S08 | 캡스톤: 로트/FEFO + 확장 과제 1개 이상 | check S08 5/5 + 확장 테스트 직접 작성 |
| 10 | S09 | 실개발 확장 설계: 운영 DB·인증·배포·이식 계획 | 설계 문서 1부 + PoC 1건 |
5. 평가
| 항목 | 비중 | 기준 |
|---|---|---|
| 자동 채점 (S00~S08) | 60% | python academy.py status 9/9 |
| 확장 과제 | 20% | 각 교재의 "심화 과제" 중 3개 이상 구현 + 직접 쓴 테스트 |
| 캡스톤 설계 | 20% | S09 설계 문서: 데이터 모델 변경, 마이그레이션, 리스크 |
6. 데이터 모델 전체도
items ─┬─< po_lines >── purchase_orders >── partners(SUPPLIER)
├─< so_lines >── sales_orders >── partners(CUSTOMER)
├─< stock_moves >── warehouses (이력: 진실)
├─< stock_balances (집계: 캐시)
└─< lots (유통기한)
accounts ─< journal_lines >── journals ──(reversal_of)──> journals
users ── audit_log (append-only)7. 업무 흐름과 자동 분개
| 사건 | 재고 | 분개 |
|---|---|---|
| 자본 납입 | — | (차)1100 현금 / (대)3100 자본금 |
| 매입 입고 | +수량, +금액 | (차)1300 상품 + 1400 부가세대급금 / (대)2100 외상매입금 |
| 매출 출고 | −수량, −원가 | (차)1200 외상매출금 / (대)4100 매출 + 2200 부가세예수금 |
| (차)5100 매출원가 / (대)1300 상품 | ||
| 실사 감모 | −수량 | (차)5200 재고감모손실 / (대)1300 상품 |
| 오류 정정 | — | 역분개 (원 분개 차/대 반전) |