acquire-core-full/app/batch/vl_bt_0013.pgc

/* @tier medium @module vl @transform validation-batch */
/*
 * vl_bt_0013.pgc - 이상금액 탐지 배치 (VL_BT_0013)  [tier=medium]
 *
 * 지정 영업일 원장(vl_ledger) 을 가맹점 평균거래액(vl_merch_avg) 과
 * 조인하여, 거래금액이 가맹점 평균의 임계배수(THRESHOLD) 를 초과하는
 * 이상거래를 커서로 탐지한다. 의심건은 의심거래 테이블(vl_suspect) 에
 * INSERT 하고 집계한다(상태전이 없음, FDS 후속검토용). main 포함.
 *
 * 실행:  vl_bt_0013 <YYYYMMDD> [db@host]
 */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

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

EXEC SQL INCLUDE sqlca;

#define VL_BT_0013_THRESHOLD  5L   /* 평균 대비 임계배수 */

static int run_vl_bt_0013(const char *biz_date)
{
    EXEC SQL BEGIN DECLARE SECTION;
    char h_biz_date[9];
    char h_key[16];
    char h_merch_id[16];
    long h_amount;
    long h_avg_amount;
    long h_ratio;
    EXEC SQL END DECLARE SECTION;

    long total = 0, suspect = 0, inserted = 0, errcnt = 0;
    long suspect_sum = 0;
    int  rc;

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

    EXEC SQL DECLARE cur_vl_bt_0013 CURSOR FOR
        SELECT l.key, l.merch_id, l.amount, a.avg_amount
        FROM vl_ledger l
        JOIN vl_merch_avg a ON a.merch_id = l.merch_id
        WHERE l.biz_date = :h_biz_date
          AND l.status   = 'R'
          AND a.avg_amount > 0
        ORDER BY l.key;

    EXEC SQL OPEN cur_vl_bt_0013;
    if (sqlca.sqlcode != TX_SQL_OK) {
        TX_DBIO_LOG_ERR("OPEN cur_vl_bt_0013");
        return TX_EDB;
    }

    if (tx_begin() != TX_OK)
        tx_log(TX_LOG_WARN, "[vl_bt_0013] tx_begin 경고");

    for (;;) {
        EXEC SQL FETCH cur_vl_bt_0013
            INTO :h_key, :h_merch_id, :h_amount, :h_avg_amount;

        if (sqlca.sqlcode == TX_SQL_NOTFOUND)
            break;
        if (sqlca.sqlcode != TX_SQL_OK) {
            TX_DBIO_LOG_ERR("FETCH cur_vl_bt_0013");
            errcnt++;
            break;
        }

        total++;

        /* 임계 판정: 거래금액이 평균의 THRESHOLD 배 초과이면 이상거래 */
        if (h_amount <= h_avg_amount * VL_BT_0013_THRESHOLD)
            continue;

        suspect++;
        suspect_sum += h_amount;
        h_ratio = h_amount / h_avg_amount;   /* 평균 대비 배수(정수) */

        tx_log(TX_LOG_WARN,
               "[vl_bt_0013] 이상금액 key=%s merch=%s 금액=%ld 평균=%ld 배수=%ld",
               h_key, h_merch_id, h_amount, h_avg_amount, h_ratio);

        /* 의심거래 등록 (FDS 후속검토 대상) */
        EXEC SQL INSERT INTO vl_suspect
                 (susp_key, merch_id, amount, avg_amount, ratio, biz_date, susp_reason)
                 VALUES
                 (:h_key, :h_merch_id, :h_amount, :h_avg_amount, :h_ratio,
                  :h_biz_date, 'AMOUNT_OUTLIER');

        if (sqlca.sqlcode != TX_SQL_OK) {
            TX_DBIO_LOG_ERR("INSERT vl_suspect");
            errcnt++;
        } else {
            inserted++;
        }
    }

    EXEC SQL CLOSE cur_vl_bt_0013;

    if (errcnt == 0)
        tx_commit();
    else
        tx_abort();

    tx_log(TX_LOG_INFO,
           "[vl_bt_0013] 요약 date=%s 대상=%ld 의심=%ld 등록=%ld 오류=%ld",
           biz_date, total, suspect, inserted, errcnt);

    printf("========== 이상금액 탐지 배치 [vl_bt_0013] ==========\n");
    printf("  영업일        : %s\n", biz_date);
    printf("  임계배수      : %ld\n", VL_BT_0013_THRESHOLD);
    printf("  검사 건수     : %ld\n", total);
    printf("  의심 건수     : %ld\n", suspect);
    printf("  의심금액 합계 : %ld\n", suspect_sum);
    printf("  vl_suspect 등록: %ld\n", inserted);
    printf("  오류 건수     : %ld\n", errcnt);
    printf("=================================================\n");

    return (errcnt == 0) ? TX_OK : TX_FAIL;
}

int main(int argc, char **argv)
{
    const char *biz_date;
    const char *target;
    int rc;

    tx_set_loglevel(TX_LOG_INFO);

    if (argc < 2) {
        fprintf(stderr, "사용법: %s <YYYYMMDD> [db@host]\n", argv[0]);
        return 2;
    }
    biz_date = argv[1];
    target   = (argc >= 3) ? argv[2] : NULL;

    if (!date_is_valid(biz_date)) {
        fprintf(stderr, "오류: 유효하지 않은 영업일 '%s'\n", biz_date);
        return 2;
    }

    tx_log(TX_LOG_INFO, "[vl_bt_0013] 배치 시작 date=%s", biz_date);

    rc = vl_dbio_connect(target);
    if (rc != TX_OK) {
        tx_log(TX_LOG_ERROR, "[vl_bt_0013] DB 접속 실패 rc=%d", rc);
        return 1;
    }

    rc = run_vl_bt_0013(biz_date);

    vl_dbio_disconnect();

    tx_log(TX_LOG_INFO, "[vl_bt_0013] 배치 종료 rc=%d(%s)", rc, tx_strerror(rc));
    return (rc == TX_OK) ? 0 : 1;
}