# acquire-core-x — 카드 매입·정산 시스템 (실동작 Enduro/X)

실제 **Enduro/X**(오픈소스 Tuxedo/ATMI TP 모니터) + **ECPG/PostgreSQL** 위에서
**실제로 기동·트랜잭션 처리되는** 카드 매입·정산 레거시 시스템. 포지(Klaro Forge)
자율 마이그레이션 도구의 대형 전환 대상 픽스처 — 이 C/ATMI 시스템을 Java Spring Boot로
전환한다.

> 앞서의 `acquire-core-full`(자체 TxCore 셔임, 컴파일만 되는 픽스처)과 달리, 이 프로젝트는
> **진짜 TP 미들웨어에서 tpcall·XA 트랜잭션이 실제로 동작**한다. (사용자 요구 = B방식)

## 스택

| 계층 | 실체 |
|---|---|
| TP 모니터 | Enduro/X 7.0.12 (오픈 Tuxedo/ATMI: `tpservice`/`tpcall`/`tpadvertise`/`tpbegin`) — 소스빌드 |
| 전문 버퍼 | UBF (≈FML32): `Bget`/`Bchg`, 필드테이블 `mkfldhdr` |
| DB 접근 | ECPG (`EXEC SQL`) → PostgreSQL 15 |
| 분산 트랜잭션 | XA 2PC — `libndrxxaecpg.so` ECPG XA 스위치, `tmsrv`가 조율 |
| 오케스트레이션 | `ndrxd` + `ndrxconfig.xml` + `app.ini`(CCONFIG) |

## 실행 (docker-compose)

```bash
docker compose -f docker/docker-compose.yml up -d --build   # postgres + endurox app
```

### 필수 런타임 요건 (없으면 ndrxd 부팅 실패 — 실측으로 규명됨)
POSIX 큐/세마포어 한도 때문에 app 컨테이너에 반드시 필요:
```yaml
sysctls:
  fs.mqueue.msg_max:     "512"
  fs.mqueue.msgsize_max: "65536"
ulimits:
  msgqueue: 536870912      # 큐 1개 = msg_max×msgsize_max ≈ 5.6MB, 기본 RLIMIT_MSGQUEUE(800KB) 초과
  nofile:   65536
```
PostgreSQL는 XA(2단계 커밋) 위해 `-c max_prepared_transactions=100`.

## 구성

- `docker/` — `endurox.Dockerfile`(Enduro/X 소스빌드, `-DENABLE_POSTGRES=ON`), `docker-compose.yml`
- `db/` — `schema.sql`(merchant/purchase/approval/settlement/ledger …)
- `app/` — `conf/`(ndrxconfig.xml, app.ini, 환경), `ubftab/`(UBF 필드테이블),
  서비스 `.pgc`/`.c`, `entrypoint.sh`
- `docs/` — `architecture.md`, `service-catalog.md`
- `ref/` — Enduro/X upstream PostgreSQL 통합테스트(참고용, .gitignore)
- `slice/` — 최초 검증용 non-DB ATMI 슬라이스(부팅+tpcall 증명 완료)

## 검증 상태

- [x] Enduro/X 소스빌드 (PostgreSQL XA 포함) → 이미지 `acquire-x/endurox:7.0.12`
- [x] `ndrxd` 부팅 (10 프로세스 runok)
- [x] 커스텀 `tpservice` advertise + **실제 `tpcall` 왕복** (ACQUIRE: fee=2500 net=997500)
- [x] ECPG XA 서비스 체인(매입→대사→정산) + 커밋 row psql 검증 + 롤백 검증 ✅
- [x] 2000본+ 실동작 시스템 (2,052 파일 / .pgc 1,015본, 전 모듈 dbio40·batch22)
- [ ] 포지 마이그레이션 → Spring Boot (Phase 3)