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

/* @tier medium @module lg @transform ledger-online */
/*
 * lg_ol_0025.pgc - 원장 온라인 서비스 (LG_OL_0025)  [tier=medium]
 *
 * 원장 상태정정: 요청된 KEY 와 NEWSTATUS 를 검증(R/M/U/S 만 허용)한 뒤
 * 상태를 UPDATE 하고, 정정 전 상태(구상태)와 정정 후 상태를 응답한다.
 */
#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;

static int lg_ol_0025_valid_status(const char *s)
{
    if (!s || !s[0] || s[1])
        return 0;
    return (s[0] == LG_ST_RECV[0] || s[0] == LG_ST_DONE[0] ||
            s[0] == LG_ST_FAIL[0] || s[0] == LG_ST_SETTLED[0]);
}

/*
 * [업무 개요]
 *   운영자가 특정 전표의 상태코드를 수동으로 정정할 때 사용한다. 잘못 전이된
 *   상태를 바로잡는 관리 기능이므로, 허용된 상태코드(R/M/U/S) 만 지정할 수
 *   있도록 엄격히 검증하고, 정정 전 상태를 감사(監査) 목적으로 함께 반환한다.
 *
 * [허용 상태코드]
 *   R(접수) / M(처리완료) / U(불일치) / S(정산완료)
 *   그 외 문자열은 RESP_INVALID 로 거부한다. (lg_ol_0025_valid_status)
 *
 * [처리 절차]
 *   1) KEY, NEWSTATUS 추출.
 *   2) NEWSTATUS 유효성 검증(1자리 + 허용집합).
 *   3) tx_begin 후 현재 상태(OLDSTATUS) 확보(없으면 RESP_NOMERCH).
 *   4) status 를 NEWSTATUS 로 UPDATE, tx_commit.
 *
 * [응답 필드]
 *   RESPCODE   처리결과코드   KEY 처리키(에코)
 *   OLDSTATUS  정정 전 상태   NEWSTATUS 정정 후 상태
 */
TX_SERVICE(LG_OL_0025, ctx)
{
    EXEC SQL BEGIN DECLARE SECTION;
    char h_key[16];
    char h_new_status[2];
    char h_old_status[2];
    EXEC SQL END DECLARE SECTION;

    char key[16], newstatus[8];

    tx_log(TX_LOG_INFO, "[LG_OL_0025] 원장 상태정정 진입");

    if (tx_buf_get(ctx->in, "KEY", key, sizeof(key)) != TX_OK ||
        tx_buf_get(ctx->in, "NEWSTATUS", newstatus, sizeof(newstatus)) != TX_OK) {
        tx_log(TX_LOG_ERROR, "[LG_OL_0025] 필수 필드 누락");
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    if (!lg_ol_0025_valid_status(newstatus)) {
        tx_log(TX_LOG_WARN, "[LG_OL_0025] 허용되지 않는 상태코드 status=%s", newstatus);
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    strncpy(h_key, key, sizeof(h_key) - 1);
    h_key[sizeof(h_key) - 1] = '\0';
    strncpy(h_new_status, newstatus, sizeof(h_new_status) - 1);
    h_new_status[sizeof(h_new_status) - 1] = '\0';

    if (tx_begin() != TX_OK) {
        tx_return(ctx, TX_FAIL, ctx->out);
        return;
    }

    /* 정정 전 상태 확보 */
    EXEC SQL SELECT status INTO :h_old_status
        FROM lg_ledger WHERE key = :h_key;
    if (sqlca.sqlcode == TX_SQL_NOTFOUND) {
        tx_log(TX_LOG_WARN, "[LG_OL_0025] 전표 없음 key=%s", key);
        tx_abort();
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_NOMERCH);
        tx_return(ctx, TX_ENOENT, ctx->out);
        return;
    }
    if (sqlca.sqlcode != TX_SQL_OK) {
        TX_DBIO_LOG_ERR("lg_ol_0025 select");
        tx_abort();
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR);
        tx_return(ctx, TX_EDB, ctx->out);
        return;
    }

    EXEC SQL UPDATE lg_ledger
        SET status = :h_new_status, upd_ts = now()
        WHERE key = :h_key;
    if (sqlca.sqlcode != TX_SQL_OK) {
        TX_DBIO_LOG_ERR("lg_ol_0025 update");
        tx_abort();
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR);
        tx_return(ctx, TX_EDB, ctx->out);
        return;
    }

    if (tx_commit() != TX_OK) {
        tx_abort();
        tx_return(ctx, TX_FAIL, ctx->out);
        return;
    }

    tx_buf_reset(ctx->out);
    tx_buf_sets(ctx->out, "RESPCODE", RESP_OK);
    tx_buf_sets(ctx->out, "KEY", key);
    tx_buf_sets(ctx->out, "OLDSTATUS", h_old_status);
    tx_buf_sets(ctx->out, "NEWSTATUS", h_new_status);
    tx_log(TX_LOG_INFO, "[LG_OL_0025] 상태정정 완료 key=%s %s→%s",
           key, h_old_status, h_new_status);
    tx_return(ctx, TX_OK, ctx->out);
}