/* @tier hard @module lg @transform ledger-online */
/*
 * lg_ol_0022.pgc - 원장 온라인 서비스 (LG_OL_0022)  [tier=hard]
 *
 * 가맹점 잔액 조회: 특정 가맹점의 원장 순액(Σamount)과 수수료 합(Σfee),
 * 전표 건수를 단일 집계 SELECT 로 조회하여 잔액을 응답한다. (조회 전용)
 */
#include <stdio.h>
#include <string.h>

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

EXEC SQL INCLUDE sqlca;

/*
 * [업무 개요]
 *   가맹점 정산 담당자가 특정 가맹점의 현재 원장 잔액을 실시간으로 확인할 때
 *   호출한다. 원장(lg_ledger) 은 매출/취소/이월/정산 전표가 상태코드와 금액
 *   부호로 누적되므로, 단순 Σamount 는 "가맹점에 귀속되는 순거래액" 을 뜻한다.
 *
 * [잔액 산식]
 *   순거래액(NETAMT)  = Σ amount              (취소·역분개는 음수로 이미 반영)
 *   누적수수료(FEESUM) = Σ fee
 *   지급가능잔액(BALANCE) = NETAMT - FEESUM   (가맹점 실지급 기준액)
 *
 * [처리 절차]
 *   1) 요청 TXBUF 에서 MERCHID 를 추출/검증한다.
 *   2) lg_ledger 를 가맹점 단위로 단일 집계(SELECT) 하여 순액/수수료/건수를
 *      한 번에 조회한다. (singleton — 집계는 항상 1행)
 *   3) 건수가 0 이면 미등록 가맹점으로 보아 RESP_NOMERCH 로 응답한다.
 *   4) 지급가능잔액을 산출하고 원화 표기 문자열을 함께 구성한다.
 *
 * [응답 필드]
 *   RESPCODE   처리결과코드
 *   MERCHID    가맹점번호(에코)
 *   NETAMT     순거래액 합계
 *   FEESUM     누적 수수료 합계
 *   BALANCE    지급가능 잔액(순액-수수료)
 *   CNT        원장 전표 건수
 *   BALANCEWON 잔액 원화표기(예: 1,234,000원)
 *
 * [주의]
 *   본 서비스는 조회 전용이므로 tx_begin/tx_commit 을 사용하지 않는다.
 *   집계 결과가 없어도(NOTFOUND) coalesce 로 0 이 보장된다.
 *
 * [연계]
 *   가맹점 지급 배치(정산) 는 본 잔액을 사전 검증값으로 참조하며, 잔액이
 *   음수이면 미수(未收) 발생 가맹점으로 분류되어 별도 리스크 리포트에
 *   집계된다. 따라서 순액/수수료를 각각 분리 반환하여 상위 화면이 지급가능
 *   잔액과 수수료 부담을 구분 표기할 수 있도록 한다.
 */
TX_SERVICE(LG_OL_0022, ctx)
{
    EXEC SQL BEGIN DECLARE SECTION;
    char h_merch_id[16];
    long h_net;
    long h_fee_sum;
    long h_cnt;
    EXEC SQL END DECLARE SECTION;

    char merch[16];
    char wonbuf[32];
    long net_balance;

    tx_log(TX_LOG_INFO, "[LG_OL_0022] 가맹점 잔액 조회 진입");

    if (tx_buf_get(ctx->in, "MERCHID", merch, sizeof(merch)) != TX_OK ||
        merch[0] == '\0') {
        tx_log(TX_LOG_ERROR, "[LG_OL_0022] MERCHID 누락");
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    strncpy(h_merch_id, merch, sizeof(h_merch_id) - 1);
    h_merch_id[sizeof(h_merch_id) - 1] = '\0';

    /* 순액/수수료/건수 단일 집계 (singleton) */
    EXEC SQL SELECT coalesce(sum(amount), 0),
                    coalesce(sum(fee), 0),
                    count(*)
        INTO :h_net, :h_fee_sum, :h_cnt
        FROM lg_ledger
        WHERE merch_id = :h_merch_id;

    if (sqlca.sqlcode != TX_SQL_OK && sqlca.sqlcode != TX_SQL_NOTFOUND) {
        TX_DBIO_LOG_ERR("lg_ol_0022 balance");
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR);
        tx_return(ctx, TX_EDB, ctx->out);
        return;
    }

    if (h_cnt == 0) {
        tx_log(TX_LOG_WARN, "[LG_OL_0022] 가맹점 원장 없음 merch=%s", merch);
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_NOMERCH);
        tx_buf_sets(ctx->out, "MERCHID", merch);
        tx_buf_setlong(ctx->out, "BALANCE", 0);
        tx_return(ctx, TX_ENOENT, ctx->out);
        return;
    }

    /* 잔액 = 순거래액 - 누적 수수료 */
    net_balance = h_net - h_fee_sum;
    amount_format_won(net_balance, wonbuf, sizeof(wonbuf));

    tx_buf_reset(ctx->out);
    tx_buf_sets(ctx->out, "RESPCODE", RESP_OK);
    tx_buf_sets(ctx->out, "MERCHID", merch);
    tx_buf_setlong(ctx->out, "NETAMT", h_net);
    tx_buf_setlong(ctx->out, "FEESUM", h_fee_sum);
    tx_buf_setlong(ctx->out, "BALANCE", net_balance);
    tx_buf_setlong(ctx->out, "CNT", h_cnt);
    tx_buf_sets(ctx->out, "BALANCEWON", wonbuf);
    tx_log(TX_LOG_INFO, "[LG_OL_0022] 잔액조회 완료 merch=%s 잔액=%ld 건수=%ld",
           merch, net_balance, h_cnt);
    tx_return(ctx, TX_OK, ctx->out);
}