feat: MappingEngine + Override 실제 로직 + 프론트 주요 화면

Backend:
- MappingEngine: company_field_mapping 기반 동적 변환 구현
  - raw_content(JSON) → 표준 원장 (TRIM/UPPER/LOWER/DATE/DIVIDE/MULTIPLY/CODE_MAP)
  - policy_no 로 contract 매칭 → contract_id/agent_id 자동
  - 실패 시 parse_error_log 자동 적재
- Recruit/Maintain Mapper.sumByAgentMonth 추가
- OrganizationMapper.selectAncestorIds (CTE 재귀 상향) 추가
- CalcOverrideStep 실제 동작:
  * lower agent 의 모집+유지 합계를 base 로 사용
  * 자기 조직 → 상위 조직 순으로 to_grade 직급 ACTIVE 설계사 탐색
  * (lowerOrgId, toGrade) 캐싱

Frontend (주요 화면):
- 공통 컴포넌트:
  * CodeSelect (공통코드 드롭다운, React Query 캐시)
  * CodeBadge (상태 색상 자동 매핑)
  * MoneyText (천단위 콤마, 음수 빨강, 부호 옵션)
  * PermissionButton (권한 없으면 미렌더)
  * SearchForm (조건 배열 → 자동 폼)
  * ExcelExportButton (blob 다운로드)
  * PageContainer
- 훅: useCommonCodes, usePermission (메뉴별 boolean)
- API 모듈: agent, contract, ledger, settle, code
- 페이지: AgentList, ContractList, RecruitLedger, SettleList
  * SettleList: 월 요약 카드 + 확정/보류 액션 + 권한 체크
- 라우터: /org/agents, /contracts, /ledger/recruit, /settle

V16 fix:
- PAYMENT 메뉴는 V12 에서 level1 directory 로 생성됨 → V16 에서 PAGE 로 UPDATE 후 권한 매트릭스 적용 (자식으로 또 만들면 unique 충돌)
This commit is contained in:
GA Pro
2026-05-09 22:38:10 +09:00
parent d4433a8e46
commit 98eb231950
28 changed files with 1165 additions and 39 deletions
+112
View File
@@ -0,0 +1,112 @@
import { useState } from 'react';
import { Card, Col, Row, Statistic, Table, message, Modal, Input, Space } from 'antd';
import { useQuery, useQueryClient } from '@tanstack/react-query';
import PageContainer from '@/components/common/PageContainer';
import SearchForm from '@/components/common/SearchForm';
import CodeBadge from '@/components/common/CodeBadge';
import MoneyText from '@/components/common/MoneyText';
import PermissionButton from '@/components/common/PermissionButton';
import { settleApi, SettleResp, SettleSearchParam } from '@/api/settle';
export default function SettleList() {
const qc = useQueryClient();
const [param, setParam] = useState<SettleSearchParam>({ pageNum: 1, pageSize: 30 });
const { data, isLoading } = useQuery({
queryKey: ['settle', 'list', param],
queryFn: () => settleApi.list(param),
});
const { data: summary } = useQuery({
queryKey: ['settle', 'summary', param.settleMonth],
queryFn: () => settleApi.summary(param.settleMonth!),
enabled: !!param.settleMonth,
});
const refresh = () => qc.invalidateQueries({ queryKey: ['settle'] });
const onConfirm = (id: number) =>
Modal.confirm({
title: '정산 확정', content: '확정 후에는 변경할 수 없습니다. 진행하시겠습니까?',
onOk: async () => { await settleApi.confirm(id); message.success('확정 완료'); refresh(); },
});
const onHold = (id: number) => {
let reason = '';
Modal.confirm({
title: '정산 보류',
content: <Input placeholder="보류 사유" onChange={(e) => { reason = e.target.value; }} />,
onOk: async () => { await settleApi.hold(id, reason); message.success('보류 처리'); refresh(); },
});
};
return (
<PageContainer title="정산 결과">
<SearchForm
conditions={[
{ type: 'month', name: 'settleMonth', label: '정산월' },
{ type: 'code', name: 'status', label: '상태', groupCode: 'SETTLE_STATUS' },
]}
onSearch={(v) => setParam({ ...param, ...v, pageNum: 1 })}
onReset={() => setParam({ pageNum: 1, pageSize: 30 })}
/>
{summary && (
<Row gutter={16} style={{ marginBottom: 16 }}>
<Col span={6}><Card><Statistic title="대상 설계사" value={Number(summary.agentCount ?? 0)} suffix="명" /></Card></Col>
<Col span={6}><Card><Statistic title="총 지급액(net)" value={Number(summary.netAmount ?? 0)} /></Card></Col>
<Col span={6}><Card><Statistic title="총 세액" value={Number(summary.taxAmount ?? 0)} valueStyle={{ color: '#cf1322' }} /></Card></Col>
<Col span={6}><Card><Statistic title="확정 건수" value={Number(summary.confirmedCount ?? 0)} suffix="건" /></Card></Col>
</Row>
)}
<Table<SettleResp>
rowKey="settleId"
loading={isLoading}
dataSource={data?.list}
size="small"
scroll={{ x: 1600 }}
pagination={{
current: param.pageNum, pageSize: param.pageSize, total: data?.total, showSizeChanger: true,
onChange: (p, s) => setParam({ ...param, pageNum: p, pageSize: s }),
}}
columns={[
{ title: '정산월', dataIndex: 'settleMonth', width: 90, fixed: 'left' },
{ title: '설계사', dataIndex: 'agentName', width: 100, fixed: 'left' },
{ title: '소속', dataIndex: 'orgName', width: 160 },
{ title: '직급', dataIndex: 'gradeName', width: 80 },
{ title: '모집', dataIndex: 'recruitTotal', width: 110, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '유지', dataIndex: 'maintainTotal', width: 110, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '예외(+)', dataIndex: 'exceptionPlus', width: 100, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '예외(-)', dataIndex: 'exceptionMinus', width: 100, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '오버라이드', dataIndex: 'overrideTotal', width: 110, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '환수', dataIndex: 'chargebackTotal', width: 100, align: 'right',
render: (v) => <MoneyText value={v ? -Math.abs(Number(v)) : 0} /> },
{ title: '총액', dataIndex: 'grossAmount', width: 120, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '세액', dataIndex: 'taxAmount', width: 100, align: 'right', render: (v) => <MoneyText value={v} /> },
{ title: '실지급', dataIndex: 'netAmount', width: 130, align: 'right',
render: (v) => <strong><MoneyText value={v} /></strong> },
{ title: '상태', dataIndex: 'status', width: 100, fixed: 'right',
render: (v) => <CodeBadge groupCode="SETTLE_STATUS" value={v} /> },
{
title: '액션', dataIndex: 'settleId', width: 200, fixed: 'right',
render: (id, r) => (
<Space>
<PermissionButton menuCode="SETTLE_LIST" permCode="APPROVE" size="small"
type="primary" onClick={() => onConfirm(id)}
disabled={r.status === 'CONFIRMED' || r.status === 'PAID'}>
</PermissionButton>
<PermissionButton menuCode="SETTLE_LIST" permCode="APPROVE" size="small"
danger onClick={() => onHold(id)}
disabled={r.status === 'PAID'}>
</PermissionButton>
</Space>
),
},
]}
/>
</PageContainer>
);
}