This repository has been archived on 2026-07-19. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
acquire-core-full/app/online/cl_ol_0011.pgc
forge-bot c3a0259e95 다양화: 530개 online/batch 프로그램을 모듈별 고유 실업무 로직으로 재작성
- 템플릿 클론(정규화 후 0줄 상이) → 전 코퍼스 530/530 고유 바디
- 11개 모듈(mg/au/ac/rc/vl/st/py/lg/mm/cm/cl) 각 파일이 distinct한
  매입·대사·정산·수수료·지급·원장·마감·마스터·정합성·전문게이트웨이·공통 업무
- TxCore(ATMI 유사) + ECPG(EXEC SQL) 관용구, 프레임워크/헤더/DBIO API/파일ID·경로 유지
- 전체 docker make -j4 = EXIT 0, 958 오브젝트, 데모 바이너리 링크
- inventory.json loc 실측 갱신

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-19 01:37:54 +00:00

120 lines
5.5 KiB
Text

/* @tier easy @module cl @transform closing-online */
/*
* cl_ol_0011.pgc - 마감 온라인 서비스 (CL_OL_0011) [tier=easy]
*
* 마감 알림 발송(판정). 요청 영업일(BIZDATE)에 미마감(접수 R) 건이 남아
* 있는지 확인하여, 남아 있으면 알림 대상(ALERT=Y)으로 미마감 건수·금액을
* 함께 반환하고, 없으면 ALERT=N 으로 응답한다. 원장을 변경하지 않는
* read-only 판정 서비스이다. (실제 발송채널 연계는 상위 오케스트레이션 담당)
*
* ── 서비스 계약(Contract) ────────────────────────────────────────────
* 입력 필드:
* BIZDATE (필수) 영업일(YYYYMMDD)
* 출력 필드:
* RESPCODE 0000=정상 / 9001=입력오류 / 9999=시스템오류
* BIZDATE 점검 대상 영업일
* RECVCNT 미마감(접수 R) 건수
* RECVSUM 미마감 금액합계(원)
* RECVWON 미마감 금액 한글 표기
* ALERT 알림 필요여부(Y=미마감 존재 / N=없음)
* MESSAGE 판정 사유 메시지
*
* ── 알림 판정 규칙 ───────────────────────────────────────────────────
* · 접수(R) 상태는 아직 마감처리 흐름에 진입하지 않은 원건이다.
* · R 건이 1건 이상이면 마감 담당자 알림 대상(ALERT=Y)으로 분류한다.
* · R 건이 없으면 마감 준비 완료로 보고 ALERT=N 을 반환한다.
* · 본 서비스는 판정만 수행하며 실제 SMS/메일 발송은 상위에서 처리.
*
* ── 처리 흐름 ────────────────────────────────────────────────────────
* 1) BIZDATE 추출/형식검증
* 2) status='R' 건수·금액합계 singleton SELECT
* 3) 건수 기준 ALERT Y/N 판정 및 응답 구성
*
* ── 후속 연계(참고) ──────────────────────────────────────────────────
* · ALERT=Y 응답을 받은 상위 오케스트레이션은 마감 담당자 그룹으로
* SMS/메일/사내 메신저 알림을 발송한다.
* · RECVCNT/RECVWON 은 알림 본문의 미마감 규모 안내에 사용된다.
* · 본 서비스는 판정 근거만 제공하고 실제 채널 I/O 는 수행하지 않아
* DB 커넥션 외 외부 자원에 의존하지 않는 순수 조회 서비스이다.
*/
#include <stdio.h>
#include <string.h>
#include "txcore.h"
#include "txcore_dbio.h"
#include "acq_util.h"
#include "cl_core.h"
EXEC SQL INCLUDE sqlca;
TX_SERVICE(CL_OL_0011, ctx)
{
EXEC SQL BEGIN DECLARE SECTION;
char h_biz_date[9];
int h_recv_cnt;
long h_recv_sum;
EXEC SQL END DECLARE SECTION;
char bizdate[16];
char won[40];
tx_log(TX_LOG_INFO, "[CL_OL_0011] 마감 알림 판정 서비스 진입");
/* 1. 요청 검증 */
if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) {
tx_log(TX_LOG_ERROR, "[CL_OL_0011] BIZDATE 누락");
tx_buf_reset(ctx->out);
tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
tx_return(ctx, TX_EINVAL, ctx->out);
return;
}
if (!date_is_valid(bizdate)) {
tx_log(TX_LOG_WARN, "[CL_OL_0011] 영업일 형식 오류 date=%s", bizdate);
tx_buf_reset(ctx->out);
tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
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';
/* 2. 미마감(R) 존재여부 및 금액 집계 */
EXEC SQL SELECT count(*), coalesce(sum(amount), 0)
INTO :h_recv_cnt, :h_recv_sum
FROM cl_ledger
WHERE biz_date = :h_biz_date
AND status = 'R';
if (sqlca.sqlcode != TX_SQL_OK) {
TX_DBIO_LOG_ERR("CL_OL_0011 recv aggregate");
tx_buf_reset(ctx->out);
tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR);
tx_return(ctx, TX_EDB, ctx->out);
return;
}
/* 3. 알림 판정 및 응답 구성 (판정 근거 상세 로깅) */
tx_log(TX_LOG_DEBUG, "[CL_OL_0011] 판정근거 date=%s 미마감R건수=%d 금액=%ld",
bizdate, h_recv_cnt, h_recv_sum);
amount_format_won(h_recv_sum, won, sizeof(won));
tx_buf_reset(ctx->out);
tx_buf_sets(ctx->out, "RESPCODE", RESP_OK);
tx_buf_sets(ctx->out, "BIZDATE", bizdate);
tx_buf_setlong(ctx->out, "RECVCNT", (long)h_recv_cnt);
tx_buf_setlong(ctx->out, "RECVSUM", h_recv_sum);
tx_buf_sets(ctx->out, "RECVWON", won);
/* 미마감(R) 잔존 시 알림 대상, 아니면 마감 준비완료로 판정 */
if (h_recv_cnt > 0) {
tx_buf_sets(ctx->out, "ALERT", "Y");
tx_buf_setlong(ctx->out, "ALERTLEVEL", (h_recv_cnt >= 100) ? 2 : 1);
tx_buf_sets(ctx->out, "MESSAGE", "미마감 접수건 존재 - 마감 알림 대상");
tx_log(TX_LOG_WARN, "[CL_OL_0011] 알림대상 date=%s 미마감=%d 금액=%ld",
bizdate, h_recv_cnt, h_recv_sum);
} else {
tx_buf_sets(ctx->out, "ALERT", "N");
tx_buf_sets(ctx->out, "MESSAGE", "미마감 접수건 없음 - 알림 불필요");
tx_log(TX_LOG_INFO, "[CL_OL_0011] 알림불요 date=%s", bizdate);
}
tx_return(ctx, TX_OK, ctx->out);
}