S09 — 학습용 ERP에서 실서비스 ERP로

S00~S08로 만든 것은 업무 규칙이 정확한 코어입니다. 실서비스로 가려면 아래 축을 하나씩 바꿉니다. 각 단계는 "테스트 56개가 계속 통과한다"를 회귀 기준으로 삼습니다.

1. 확장 로드맵

순서축학습판실서비스바꿀 곳
1DBSQLite 파일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 컬럼 + 행 수준 보안모든 테이블·쿼리
6API 서버http.server프레임워크(FastAPI/axum) + OpenAPIapi.py 교체, handle 로직 재사용
7외부 연동없음쇼핑몰 재고 동기화(임시품절), 세금계산서, PG 입금integrations/ 어댑터
8운영로컬 실행컨테이너, 백업·복구, 모니터링, 감사로그 보존배포 파이프라인

2. 권장 PoC 순서

  1. PostgreSQL 이식 — db.py만 교체하고 테스트 전체 통과시키기 (업무 코드는 그대로여야 정상 설계)
  2. 동시 출고 경합 테스트 — 스레드 2개가 마지막 재고 1개를 동시에 확정할 때 하나만 성공해야 함
  3. 쇼핑몰 재고 연동 — stock_status 의 임시품절 을 외부 상품 상태로 반영하는 어댑터(드라이런 모드부터)

3. 다른 언어로 이식하기 (예: Rust)

코어가 작고 테스트가 명세 역할을 하므로 이식 연습에 적합합니다.

4. 설계 문서 템플릿 (S09 제출물)

1. 범위: 어떤 축을 바꾸는가
2. 데이터 모델 변경: 테이블/컬럼/인덱스, 마이그레이션 순서
3. 불변식: 이 변경 후에도 지켜야 하는 규칙과 그 검증 방법
4. 실패 시나리오: 동시성·부분 실패·외부 연동 장애
5. 롤백 계획
6. 테스트 계획: 기존 56개 + 신규