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 충돌)
2026-05-09 22:38:10 +09:00
parent d4433a8e46
commit 98eb231950
28 changed files with 1165 additions and 39 deletions
@@ -0,0 +1,66 @@
+import { useState } from 'react';
+import { Table } from 'antd';
+import { useQuery } 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 { contractApi, ContractResp, ContractSearchParam } from '@/api/contract';
+
+export default function ContractList() {
+  const [param, setParam] = useState<ContractSearchParam>({ pageNum: 1, pageSize: 20 });
+
+  const { data, isLoading } = useQuery({
+    queryKey: ['contract', 'list', param],
+    queryFn: () => contractApi.list(param),
+  });
+
+  return (
+    <PageContainer title="계약 관리">
+      <SearchForm
+        conditions={[
+          { type: 'text', name: 'searchKeyword', label: '계약자/증권번호' },
+          { type: 'code', name: 'insuranceType', label: '보험종류', groupCode: 'INSURANCE_TYPE' },
+          { type: 'code', name: 'status', label: '상태', groupCode: 'CONTRACT_STATUS' },
+          { type: 'dateRange', name: 'dateRange', label: '계약일' },
+        ]}
+        onSearch={(v) => setParam({ ...param, ...v, pageNum: 1 })}
+        onReset={() => setParam({ pageNum: 1, pageSize: 20 })}
+      />
+
+      <Table<ContractResp>
+        rowKey="contractId"
+        loading={isLoading}
+        dataSource={data?.list}
+        pagination={{
+          current: param.pageNum, pageSize: param.pageSize, total: data?.total, showSizeChanger: true,
+          onChange: (p, s) => setParam({ ...param, pageNum: p, pageSize: s }),
+        }}
+        columns={[
+          { title: '증권번호',  dataIndex: 'policyNo',       width: 140 },
+          { title: '계약자',    dataIndex: 'contractorName', width: 100 },
+          { title: '설계사',    dataIndex: 'agentName',      width: 100 },
+          { title: '보험사',    dataIndex: 'companyName',    width: 120 },
+          { title: '상품',      dataIndex: 'productName',    width: 220 },
+          {
+            title: '보험종류', dataIndex: 'insuranceType',  width: 100,
+            render: (v) => <CodeBadge groupCode="INSURANCE_TYPE" value={v} />,
+          },
+          {
+            title: '보험료', dataIndex: 'premium', width: 120, align: 'right',
+            render: (v) => <MoneyText value={v} />,
+          },
+          {
+            title: '납입주기', dataIndex: 'payCycle', width: 90,
+            render: (v) => <CodeBadge groupCode="PAY_CYCLE" value={v} />,
+          },
+          {
+            title: '상태', dataIndex: 'status', width: 90,
+            render: (v) => <CodeBadge groupCode="CONTRACT_STATUS" value={v} />,
+          },
+          { title: '계약일', dataIndex: 'contractDate', width: 110 },
+        ]}
+      />
+    </PageContainer>
+  );
+}