hyeongwoo e834692abb 문서: README 전면 개편 + 상세 ARCHITECTURE.md 신규 (산출물)

- README.md: 전체 현황 반영 개편 — 실측 지표(4,661파일·33만LOC·1,478svc·506배치·
  101테이블·1,173만행·패리티≈89%), 스택·Oracle계보, 빠른시작(빌드/거래/ISO왕복/
  클리어링파일), 포털 7화면(#해시), 저장소 구조, 문서 인덱스, 핵심 설계제약.
- docs/ARCHITECTURE.md: 상세 아키텍처 — 런타임 토폴로지(모듈서버 패턴·tmsrv/XA),
  11 도메인 분해표, 6단 XA 체인·브랜치 격리 규율, 데이터모델(정합성 불변식),
  외부연동 ISO8583 전문처리 다이어그램, 빌드시스템, Oracle 계보 3단, 관측·검증.
- 구 architecture.md → ARCHITECTURE.md 로 대체(원문 architecture.legacy.md 보존).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-23 15:06:00 +09:00

4.5 KiB

Raw Permalink Blame History

아키텍처 — acquire-core-x

1. 런타임 토폴로지

              ┌──────────────────────────── app 컨테이너 (Enduro/X) ────────────────────────────┐
  acqdrv  ──▶ │  ndrxd (TP 모니터)                                                              │
 (client)     │    ├─ tmsrv (RM1 = PostgreSQL, XA 조율: prepare/commit/rollback)                │
   tpbegin    │    ├─ cconfsrv / tpevsrv / cpmsrv (시스템)                                       │
   tpcall ───▶│    ├─ acq_online  : ACQUIRE, CANCEL, CORRECT …   (매입 온라인 tpservice)         │
   tpcommit   │    ├─ rc_online   : RECONCILE, REMATCH …          (대사)                         │
              │    ├─ st_online   : SETTLE, FEECALC …             (정산·수수료)                  │
              │    └─ *_batch     : 커서 배치 (마감/집계)                                         │
              │        │ EXEC SQL (ECPG, XA 스위치 libndrxxaecpg)                                 │
              └────────┼──────────────────────────────────────────────────────────────────────┘
                       ▼
                 PostgreSQL (db 컨테이너, max_prepared_transactions=100)
                 merchant / purchase / approval / settlement / ledger …

2. 트랜잭션 모델 (핵심 — 진짜 XA 2PC)

클라이언트가 tpbegin()으로 글로벌 트랜잭션 시작 → tpcall("ACQUIRE") → ACQUIRE 서비스가 EXEC SQL INSERT purchase (자동으로 XA xa_start로 글로벌 tx에 편입) → 같은 tx 안에서 tpcall("RECONCILE") → tpcall("SETTLE") → 클라이언트 tpcommit() → tmsrv가 xa_prepare → xa_commit (2단계 커밋)으로 모든 서비스의 DB 작업을 원자적으로 확정. tpabort() 시 전부 롤백 → DB에 아무것도 남지 않음.

이것이 레거시 Tuxedo/ProFrame 시스템의 표준 패턴이며, 마이그레이션 도구가 실제로 마주할 idiom이다.

3. 모듈 (11) — acquire-core-full 도메인 계승

코드	모듈	대표 서비스/배치
ac	매입(acquiring)	ACQUIRE, DDC, EDI청구, 취소/정정, 부분/할부/해외, 미매입추출
au	승인/한도	AUTH중계, 한도차감/복원, 대행승인, 이상거래탐지
rc	대사(reconcile)	RECONCILE(승인-매입-입금 3-way), tolerance, 재대사, 반송
st	정산/수수료	SETTLE, MDR/VAN수수료, netting, 원천징수, T+n
py	지급(payment)	지급파일생성, 결과반영, 재처리, 이체연계
lg	원장(ledger)	복식전표, 잔액검증, 전기, 역분개, 마감연계
cl	마감(closing)	일/월/분기 마감, 스냅샷, 재마감
mm	마스터	가맹점/수수료율/BIN/한도 마스터
vl	정합성검증	매출/카드/한도/금액 정합성, 이상탐지
mg	전문게이트웨이	전문 수/송신, ISO8583 파싱, STAN채번, 라우팅
cm	공통	공통코드, 영업일, 금액유틸, 채번, Luhn/CRC

4. 파일 아키타입 (2000본 구성 근거)

아키타입	형식	개수(목표)	성격
online service	`.pgc` (`tpservice` + EXEC SQL)	~350	tpcall 진입점, XA
dbio	`.pgc` (EXEC SQL 함수)	~300	서비스가 호출하는 DB 접근 계층
batch	`.pgc`/`.c` (`main`, 커서)	~180	마감/집계, XA
common util	`.c`	~120	leaf 유틸
copybook/header	`.h`, UBF 필드테이블 `.fd`	~600	구조체·FML 필드
config	ndrxconfig.xml, app.ini, UBFTAB, XA RM	~50	TP/서버/RM 설정
shell/run	`.sh`	~180	기동/배치 스크립트
schema/seed	`.sql`	~50	스키마·시드
합계		~2,030

5. 마이그레이션 타깃 매핑 (포지 → Spring Boot)

레거시 (Enduro/X)	Spring Boot
`tpservice`/`tpadvertise`	`@Service` 빈 + 메서드
`tpcall(SVC)`	빈 주입 호출 (동기)
UBF `Bget/Bchg` (전문버퍼)	DTO/record
`tpbegin/tpcommit` (XA)	`@Transactional` (JTA/단일DB)
`EXEC SQL` / ECPG dbio	MyBatis/JPA repository
커서 배치	Spring Batch
고정길이 전문	코덱(fixed-length)
ndrxconfig 서비스 등록	컴포넌트 스캔/라우팅
`schema.sql`	Flyway

4.5 KiB Raw Permalink Blame History