e834692abb
- 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>
73 lines
4.5 KiB
Markdown
73 lines
4.5 KiB
Markdown
# 아키텍처 — 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 |
|