acquire-core-full/app/online/rc_ol_0018.pgc

/* @tier easy @module rc @transform reconciliation-online */
/*
 * rc_ol_0018.pgc - 대사 통계 조회 온라인 서비스 (RC_OL_0018)
 *
 * 지정 영업일(BIZDATE)의 원장 전체를 커서로 순회하며 대사 통계를 집계한다.
 *
 * [집계 항목]
 *   CNT       - 대상 건수
 *   MINAMT    - 최소 거래금액
 *   MAXAMT    - 최대 거래금액
 *   SUMAMT    - 거래금액 합계
 *   AVGAMT    - 평균 거래금액 (SUMAMT / CNT, 0 나눗셈 방지)
 *   MATCHRATE - 대사완료율 (matched * 100 / CNT)
 *
 * [대사완료 판정]
 *   상태가 매입확정('M') 또는 정산완료('S') 인 건을 대사완료로 본다.
 *   접수('R')/불일치('U') 는 미완료로 집계된다.
 *
 * 원장을 변경하지 않는 순수 조회(read-only) 서비스이며, 커서 기반이므로
 * txcore_dbio.h 의 TX_SQL_OK / TX_SQL_NOTFOUND / TX_DBIO_LOG_ERR 를 사용한다.
 */
#include <stdio.h>
#include <string.h>

#include "txcore.h"
#include "txcore_dbio.h"
#include "acq_util.h"
#include "rc_core.h"

EXEC SQL INCLUDE sqlca;

TX_SERVICE(RC_OL_0018, ctx)
{
    EXEC SQL BEGIN DECLARE SECTION;
    char h_biz_date[9];
    long h_amount;
    char h_status[2];
    EXEC SQL END DECLARE SECTION;

    char bizdate[9];
    long cnt = 0, matched = 0, unmatched = 0;
    long minamt = 0, maxamt = 0, sumamt = 0;
    long avgamt = 0, matchrate = 0;
    int  first = 1;

    tx_log(TX_LOG_INFO, "[RC_OL_0018] 대사 통계 조회 서비스 진입");

    /* 입력 검증: 영업일 필수 + 형식(YYYYMMDD) */
    if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) {
        tx_log(TX_LOG_ERROR, "[RC_OL_0018] BIZDATE 누락");
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }
    if (!date_is_valid(bizdate)) {
        tx_log(TX_LOG_WARN, "[RC_OL_0018] 영업일 형식 오류 date=%s", bizdate);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    strncpy(h_biz_date, bizdate, sizeof(h_biz_date) - 1);
    h_biz_date[sizeof(h_biz_date) - 1] = '\0';

    tx_log(TX_LOG_INFO, "[RC_OL_0018] 통계 집계 시작 date=%s", bizdate);

    EXEC SQL DECLARE cur_rc_ol_0018 CURSOR FOR
        SELECT amount, status
        FROM rc_ledger
        WHERE biz_date = :h_biz_date
        ORDER BY key;

    EXEC SQL OPEN cur_rc_ol_0018;
    if (sqlca.sqlcode != TX_SQL_OK) {
        TX_DBIO_LOG_ERR("OPEN cur_rc_ol_0018");
        tx_return(ctx, TX_EDB, ctx->out);
        return;
    }

    for (;;) {
        EXEC SQL FETCH cur_rc_ol_0018 INTO :h_amount, :h_status;

        if (sqlca.sqlcode == TX_SQL_NOTFOUND)
            break;
        if (sqlca.sqlcode != TX_SQL_OK) {
            TX_DBIO_LOG_ERR("FETCH cur_rc_ol_0018");
            EXEC SQL CLOSE cur_rc_ol_0018;
            tx_return(ctx, TX_EDB, ctx->out);
            return;
        }

        cnt++;
        sumamt += h_amount;

        /* 최소/최대: 첫 행에서 초기화 후 비교 */
        if (first) {
            minamt = maxamt = h_amount;
            first  = 0;
        } else {
            if (h_amount < minamt) minamt = h_amount;
            if (h_amount > maxamt) maxamt = h_amount;
        }

        /* 대사완료 = 매입확정('M') 또는 정산완료('S') */
        if (h_status[0] == RC_ST_DONE[0] || h_status[0] == RC_ST_SETTLED[0])
            matched++;
        else
            unmatched++;
    }

    EXEC SQL CLOSE cur_rc_ol_0018;

    /* 대상이 없으면 통계 산출 불가 */
    if (cnt == 0) {
        tx_log(TX_LOG_WARN, "[RC_OL_0018] 집계대상 없음 date=%s", bizdate);
        tx_return(ctx, TX_ENOENT, ctx->out);
        return;
    }

    /* 0 나눗셈 방지: cnt > 0 확인 후 평균/완료율 산출 */
    avgamt    = sumamt / cnt;
    matchrate = (matched * 100) / cnt;

    tx_buf_reset(ctx->out);
    tx_buf_sets(ctx->out, "BIZDATE", bizdate);
    tx_buf_setlong(ctx->out, "CNT", cnt);
    tx_buf_setlong(ctx->out, "MINAMT", minamt);
    tx_buf_setlong(ctx->out, "MAXAMT", maxamt);
    tx_buf_setlong(ctx->out, "AVGAMT", avgamt);
    tx_buf_setlong(ctx->out, "MATCHRATE", matchrate);
    tx_buf_setlong(ctx->out, "SUMAMT", sumamt);

    tx_log(TX_LOG_INFO,
           "[RC_OL_0018] 집계결과 date=%s 건수=%ld 완료=%ld 미완료=%ld",
           bizdate, cnt, matched, unmatched);
    tx_log(TX_LOG_INFO,
           "[RC_OL_0018] 통계완료 date=%s 최소=%ld 최대=%ld 평균=%ld 합계=%ld 완료율=%ld%%",
           bizdate, minamt, maxamt, avgamt, sumamt, matchrate);
    tx_return(ctx, TX_OK, ctx->out);
}