/* @tier medium @module rc @transform reconciliation-online */ /* * rc_ol_0031.pgc - 대사 진행률 조회 온라인 서비스 (RC_OL_0031) * * 요청 영업일(BIZDATE)에 대해 상태별 원장 건수를 집계하여 대사 처리의 * 진행률과 완료율, 잔여 미처리 건수를 산출한다. * 상태별로 rc_rec_count 를 호출한다: * 접수('R'), 매입확정('M'), 불일치('U'), 정산완료('S'). * * 업무규칙: * - total = 접수 + 매입확정 + 불일치 + 정산완료 (0 방어) * - 처리완료 PROCESSED = 매입확정 + 불일치 + 정산완료 (접수를 제외한 건) * - 진행률 PROGRESS = PROCESSED * 100 / total * - 최종완료율 COMPLETION = 정산완료 * 100 / total * - 잔여 PENDING = 접수('R') 건수 * * 응답: BIZDATE, TOTAL, PROCESSED, PROGRESS, COMPLETION, PENDING * * 비고: * - PROGRESS 는 "접수를 벗어난" 모든 건(매입/불일치/정산) 을 처리로 보고, * COMPLETION 은 최종 정산완료('S') 만을 완료로 본다. 따라서 항상 * COMPLETION <= PROGRESS 관계가 성립한다. * - 상태별 집계 API 만 사용하며 커서를 열지 않는다 (읽기 전용). */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "rc_core.h" EXEC SQL INCLUDE sqlca; TX_SERVICE(RC_OL_0031, ctx) { char bizdate[16]; long cnt_r, cnt_m, cnt_u, cnt_s; long total, processed; long progress; /* 처리 진행률 (%) */ long completion; /* 최종 완료율 (%) */ long pending; /* 잔여 접수 건수 */ tx_log(TX_LOG_INFO, "[RC_OL_0031] 대사 진행률 조회 서비스 진입"); if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) { tx_log(TX_LOG_ERROR, "[RC_OL_0031] BIZDATE 누락"); tx_return(ctx, TX_EINVAL, ctx->out); return; } if (!date_is_valid(bizdate)) { tx_log(TX_LOG_WARN, "[RC_OL_0031] 영업일 형식 오류 date=%s", bizdate); tx_return(ctx, TX_EINVAL, ctx->out); return; } cnt_r = rc_rec_count(bizdate, RC_ST_RECV); cnt_m = rc_rec_count(bizdate, RC_ST_DONE); cnt_u = rc_rec_count(bizdate, RC_ST_FAIL); cnt_s = rc_rec_count(bizdate, RC_ST_SETTLED); if (cnt_r < 0 || cnt_m < 0 || cnt_u < 0 || cnt_s < 0) { tx_log(TX_LOG_ERROR, "[RC_OL_0031] 건수 집계 실패 date=%s R=%ld M=%ld U=%ld S=%ld", bizdate, cnt_r, cnt_m, cnt_u, cnt_s); tx_return(ctx, TX_EDB, ctx->out); return; } total = cnt_r + cnt_m + cnt_u + cnt_s; processed = cnt_m + cnt_u + cnt_s; /* 접수를 제외한 처리 진행 건 */ pending = cnt_r; /* 상태 내역을 감사 로그로 남겨 진행 추이를 추적한다. */ tx_log(TX_LOG_INFO, "[RC_OL_0031] 상태내역 date=%s 접수=%ld 매입=%ld 불일치=%ld 정산=%ld", bizdate, cnt_r, cnt_m, cnt_u, cnt_s); /* --- 진행률/완료율 산출 (0 나눗셈 방어) --- */ if (total > 0) { progress = processed * 100 / total; completion = cnt_s * 100 / total; } else { progress = 0; completion = 0; tx_log(TX_LOG_WARN, "[RC_OL_0031] 대상 원장 없음 date=%s → 진행률 0%%", bizdate); } tx_log(TX_LOG_INFO, "[RC_OL_0031] date=%s 총=%ld 처리=%ld 진행률=%ld%% 완료율=%ld%% 잔여=%ld", bizdate, total, processed, progress, completion, pending); /* --- 진행 단계별 정성 상태를 로그로 남긴다 (응답에는 미포함) --- */ if (total == 0) tx_log(TX_LOG_INFO, "[RC_OL_0031] 단계=대상없음"); else if (pending == 0 && completion >= 100) tx_log(TX_LOG_INFO, "[RC_OL_0031] 단계=정산마감 (100%% 완료)"); else if (pending == 0) tx_log(TX_LOG_INFO, "[RC_OL_0031] 단계=대사완료 정산진행 (완료율 %ld%%)", completion); else if (progress >= 50) tx_log(TX_LOG_INFO, "[RC_OL_0031] 단계=진행중 (진행률 %ld%% 잔여 %ld건)", progress, pending); else tx_log(TX_LOG_WARN, "[RC_OL_0031] 단계=초기 (진행률 %ld%% 잔여 %ld건)", progress, pending); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "BIZDATE", bizdate); tx_buf_setlong(ctx->out, "TOTAL", total); tx_buf_setlong(ctx->out, "PROCESSED", processed); tx_buf_setlong(ctx->out, "PROGRESS", progress); tx_buf_setlong(ctx->out, "COMPLETION", completion); tx_buf_setlong(ctx->out, "PENDING", pending); /* 잔여 미처리(접수 'R') 건수를 원장에서 직접 임베디드 SQL 로 집계 (DBPENDING) */ { EXEC SQL BEGIN DECLARE SECTION; char h_r31_bd[9]; long h_r31_pend; EXEC SQL END DECLARE SECTION; strncpy(h_r31_bd, bizdate, sizeof(h_r31_bd) - 1); h_r31_bd[sizeof(h_r31_bd) - 1] = '\0'; h_r31_pend = 0; EXEC SQL SELECT COUNT(*) INTO :h_r31_pend FROM rc_ledger WHERE biz_date = :h_r31_bd AND status = 'R'; if (sqlca.sqlcode != TX_SQL_OK && sqlca.sqlcode != TX_SQL_NOTFOUND) { TX_DBIO_LOG_ERR("SELECT rc_ledger dbpending"); h_r31_pend = pending; } tx_buf_setlong(ctx->out, "DBPENDING", h_r31_pend); } tx_log(TX_LOG_INFO, "[RC_OL_0031] 대사 진행률 조회 서비스 정상 종료 date=%s", bizdate); tx_return(ctx, TX_OK, ctx->out); }