S09 — 학습용 ERP에서 실서비스 ERP로
S00~S08로 만든 것은 업무 규칙이 정확한 코어입니다. 실서비스로 가려면 아래 축을 하나씩 바꿉니다. 각 단계는 "테스트 56개가 계속 통과한다"를 회귀 기준으로 삼습니다.
1. 확장 로드맵
| 순서 | 축 | 학습판 | 실서비스 | 바꿀 곳 |
|---|---|---|---|---|
| 1 | DB | SQLite 파일 | PostgreSQL (트랜잭션 격리, 동시성) | db.py 연결·SAVEPOINT·UPSERT 문법 |
| 2 | 동시성 | 단일 프로세스 | 재고 출고 행 잠금(SELECT … FOR UPDATE) | post_move, confirm_so |
| 3 | 스키마 변경 | CREATE IF NOT EXISTS | 버전 관리 마이그레이션 | migrations/0001_*.sql |
| 4 | 인증 | X-User 헤더 | 로그인 + 세션/JWT, 비밀번호 해시 | api.py 앞단 |
| 5 | 멀티테넌트 | 단일 회사 | tenant_id 컬럼 + 행 수준 보안 | 모든 테이블·쿼리 |
| 6 | API 서버 | http.server | 프레임워크(FastAPI/axum) + OpenAPI | api.py 교체, handle 로직 재사용 |
| 7 | 외부 연동 | 없음 | 쇼핑몰 재고 동기화(임시품절), 세금계산서, PG 입금 | integrations/ 어댑터 |
| 8 | 운영 | 로컬 실행 | 컨테이너, 백업·복구, 모니터링, 감사로그 보존 | 배포 파이프라인 |
2. 권장 PoC 순서
- PostgreSQL 이식 —
db.py만 교체하고 테스트 전체 통과시키기 (업무 코드는 그대로여야 정상 설계) - 동시 출고 경합 테스트 — 스레드 2개가 마지막 재고 1개를 동시에 확정할 때 하나만 성공해야 함
- 쇼핑몰 재고 연동 —
stock_status의임시품절을 외부 상품 상태로 반영하는 어댑터(드라이런 모드부터)
3. 다른 언어로 이식하기 (예: Rust)
코어가 작고 테스트가 명세 역할을 하므로 이식 연습에 적합합니다.
- 모듈 경계 유지:
db / master / accounting / inventory / purchasing / sales / security / reports / api - 금액·수량은
i64, 오류는enum ErpError, 트랜잭션은sqlx::Transaction tests/*.py시나리오를 그대로 Rust 통합테스트로 옮겨 동일 결과 확인
4. 설계 문서 템플릿 (S09 제출물)
1. 범위: 어떤 축을 바꾸는가
2. 데이터 모델 변경: 테이블/컬럼/인덱스, 마이그레이션 순서
3. 불변식: 이 변경 후에도 지켜야 하는 규칙과 그 검증 방법
4. 실패 시나리오: 동시성·부분 실패·외부 연동 장애
5. 롤백 계획
6. 테스트 계획: 기존 56개 + 신규