/* @tier easy @module rc @transform reconciliation-online */ /* * rc_ol_0027.pgc - 대사율 조회 온라인 서비스 (RC_OL_0027) * * 요청 영업일(BIZDATE)에 대해 상태별 원장 건수를 집계하여 그날의 * 대사율(완료 비율)과 미대사율(잔여 비율)을 산출한다. * 상태별로 rc_rec_count 를 호출한다: * 접수('R'), 매입확정('M'), 불일치('U'), 정산완료('S'). * * 업무규칙: * - total = 접수 + 매입확정 + 불일치 + 정산완료 (0 방어) * - 대사율 RECRATE = (매입확정 + 정산완료) * 100 / total * - 미대사율 UNRECRATE = (접수 + 불일치) * 100 / total * * 응답: BIZDATE, TOTAL, CNTR, CNTM, CNTU, CNTS, RECRATE, UNRECRATE * * 비고: * - 원장(rc_ledger) 을 직접 순회하지 않고 상태별 집계 API 만 사용하므로 * 커서 없이 O(상태수) 회의 count 호출로 대사율을 계산한다 (읽기 전용). * - 백분율은 정수 나눗셈이라 절삭되며, RECRATE + UNRECRATE 가 100 미만이 * 될 수 있다. 이는 표시 목적의 근사치이며 감사에는 원건수를 사용한다. */ #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_0027, ctx) { char bizdate[16]; long cnt_r, cnt_m, cnt_u, cnt_s; long total; long recrate, unrecrate; long recdone; /* 대사완료 건수 (M + S) */ long recopen; /* 미대사 건수 (R + U) */ tx_log(TX_LOG_INFO, "[RC_OL_0027] 대사율 조회 서비스 진입"); /* --- 요청 필드 추출 및 검증 --- */ if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) { tx_log(TX_LOG_ERROR, "[RC_OL_0027] BIZDATE 누락"); tx_return(ctx, TX_EINVAL, ctx->out); return; } if (!date_is_valid(bizdate)) { tx_log(TX_LOG_WARN, "[RC_OL_0027] 영업일 형식 오류 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_0027] 건수 집계 실패 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; recdone = cnt_m + cnt_s; /* 매입확정 + 정산완료 = 대사완료 */ recopen = cnt_r + cnt_u; /* 접수 + 불일치 = 미대사 */ /* 상태별 내역을 감사 로그로 남겨 이후 대사 추적을 돕는다. */ tx_log(TX_LOG_INFO, "[RC_OL_0027] 상태내역 date=%s 접수=%ld 매입=%ld 불일치=%ld 정산=%ld", bizdate, cnt_r, cnt_m, cnt_u, cnt_s); /* --- 대사율/미대사율 산출 (0 나눗셈 방어) --- */ if (total > 0) { recrate = recdone * 100 / total; unrecrate = recopen * 100 / total; } else { recrate = 0; unrecrate = 0; tx_log(TX_LOG_WARN, "[RC_OL_0027] 대상 원장 없음 date=%s → 대사율 0%%", bizdate); } /* 대사율과 미대사율의 합은 정상적으로 100(잔차 제외) 이어야 한다. * 정수 나눗셈 절삭으로 100 미만이 될 수 있어 참고용으로만 기록한다. */ tx_log(TX_LOG_INFO, "[RC_OL_0027] date=%s 총=%ld 완료=%ld 잔여=%ld 대사율=%ld%% 미대사율=%ld%%", bizdate, total, recdone, recopen, recrate, unrecrate); /* --- 대사율 수준별 정성 등급을 로그로 남긴다 (응답에는 미포함) --- */ if (total == 0) tx_log(TX_LOG_INFO, "[RC_OL_0027] 등급=N/A (대상 없음)"); else if (recrate >= 100) tx_log(TX_LOG_INFO, "[RC_OL_0027] 등급=완전대사 (100%%)"); else if (recrate >= 90) tx_log(TX_LOG_INFO, "[RC_OL_0027] 등급=양호 (대사율 %ld%%)", recrate); else if (recrate >= 70) tx_log(TX_LOG_WARN, "[RC_OL_0027] 등급=주의 (대사율 %ld%%)", recrate); else tx_log(TX_LOG_WARN, "[RC_OL_0027] 등급=미흡 (대사율 %ld%%)", recrate); /* --- 응답 구성 --- */ tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "BIZDATE", bizdate); tx_buf_setlong(ctx->out, "TOTAL", total); tx_buf_setlong(ctx->out, "CNTR", cnt_r); tx_buf_setlong(ctx->out, "CNTM", cnt_m); tx_buf_setlong(ctx->out, "CNTU", cnt_u); tx_buf_setlong(ctx->out, "CNTS", cnt_s); tx_buf_setlong(ctx->out, "RECRATE", recrate); tx_buf_setlong(ctx->out, "UNRECRATE", unrecrate); /* 대사완료(M,S) 건수를 원장에서 직접 임베디드 SQL 로 집계 (DBRECDONE) */ { EXEC SQL BEGIN DECLARE SECTION; char h_r27_bd[9]; long h_r27_done; EXEC SQL END DECLARE SECTION; strncpy(h_r27_bd, bizdate, sizeof(h_r27_bd) - 1); h_r27_bd[sizeof(h_r27_bd) - 1] = '\0'; h_r27_done = 0; EXEC SQL SELECT COUNT(*) INTO :h_r27_done FROM rc_ledger WHERE biz_date = :h_r27_bd AND status IN ('M', 'S'); if (sqlca.sqlcode != TX_SQL_OK && sqlca.sqlcode != TX_SQL_NOTFOUND) { TX_DBIO_LOG_ERR("SELECT rc_ledger recdone"); h_r27_done = recdone; } tx_buf_setlong(ctx->out, "DBRECDONE", h_r27_done); } tx_log(TX_LOG_INFO, "[RC_OL_0027] 대사율 조회 서비스 정상 종료 date=%s", bizdate); tx_return(ctx, TX_OK, ctx->out); }