동기화

2026-05-15 00:25:18 +09:00
parent 88e14edffd
commit d5ed642c80
69 changed files with 2634 additions and 26 deletions
@@ -44,8 +44,8 @@ V1~V17 마이그레이션 + 테스트 데이터(보험사 5 / 상품 20 / 설계
 `192.168.0.60:55432/trading_ai/ga` 스키마에 적용되어 있습니다.

 > **주의**: 운영 DB 에는 현재 V1~V17(또는 V22 까지)만 적용되어 있습니다.
-> V18~V55 는 ga-api 를 재시작하면 Flyway 가 자동으로 순서대로 적용합니다.
-> 재시작 전까지 P2~P4 신규 도메인 API 는 테이블이 없어 동작하지 않습니다.
+> V18~V61 은 ga-api 를 재시작하면 Flyway 가 자동으로 순서대로 적용합니다.
+> 재시작 전까지 P2~P5-W1 신규 도메인 API 는 테이블이 없어 동작하지 않습니다.

 #### 1) Backend (ga-api) 실행

@@ -111,6 +111,8 @@ PW  : admin1234!
 | 정산 결과 | `/settle` | 월 요약 + 확정/보류 |
 | 정산 배치 | `/settle/batch` | 배치 실행 + 진행률 폴링 |
 | 지급 관리 | `/payments` | 지급 상태 추적 |
+| 연말 사업소득 명세서 | `/settle/annual-income` | 설계사별 연간 사업소득 집계 + 재집계 (P5-W1) |
+| 분개장 | `/settle/accounting-journal` | 회계 자동분개 엔트리 + 마감 처리 (P5-W1) |
 | 사용자 관리 | `/system/users` | 비번 초기화/잠금 해제 |
 | 역할/권한 | `/system/roles` | 권한 매트릭스 (메뉴 × 6권한) |
 | 공통코드 | `/system/codes` | 그룹별 코드 조회 |
@@ -274,7 +276,23 @@ UPDATE ga.users SET password = '$2b$10$...' WHERE login_id = 'admin';
 - **첨부파일 (P4-B-8)**: attachment — 도메인 무관 공통 첨부 (소속/경로/타입)
 - **출금신청 (P4-B-9)**: withdraw_request — 결재 + 펌뱅킹 송신 + 결과 반영

-### 정산 배치 8 Step
+### P5 Wave 1 — 회계 진입점 (V63~V66)
+- **연말 사업소득 명세서** (`/settle/annual-income`): 설계사별 귀속연도 사업소득 집계, 재집계 버튼
+  - `GET /api/agent-annual-incomes` — 목록 조회 (settleYear/agentId/orgId 필터)
+  - `GET /api/agent-annual-incomes/{agentId}/{settleYear}` — 단건 상세
+  - `POST /api/agent-annual-incomes/regenerate?year=YYYY` — 연도 전체 재집계 (EXECUTE 권한)
+- **분개장** (`/settle/accounting-journal`): 수수료 지급 자동분개 엔트리, 마감(journalNo 채번) 기능
+  - `GET /api/accounting-entries` — 분개 목록 (settleMonth/journalNo/status 필터)
+  - `POST /api/accounting-entries/generate` — 정산월 기준 분개 자동생성 (settleMonth or paymentIds)
+  - `PUT /api/accounting-entries/close` — 분개 마감 처리 (entryIds + journalNo)
+- **계정코드 마스터** (공통 드롭다운용)
+  - `GET /api/common/account-codes?accountType=DEBIT|CREDIT|BOTH` — 활성 계정코드 목록
+  - `GET /api/common/account-codes/all` — 전체 (시스템관리용)
+  - `POST /api/common/account-codes` — 등록
+  - `PUT /api/common/account-codes/{accountCode}` — 수정
+  - `DELETE /api/common/account-codes/{accountCode}` — 삭제
+
+### 정산 배치 10 Step
 1. **receiveData** — 보험사별 DataReceiver → raw_commission_data 적재
 2. **transformData** — MappingEngine 으로 raw → 표준 원장 (TRIM/UPPER/DATE/DIVIDE/CODE_MAP)
 3. **reconcile** — 보험사 통보액 vs 시스템 계산액 대사
@@ -283,6 +301,8 @@ UPDATE ga.users SET password = '$2b$10$...' WHERE login_id = 'admin';
 6. **chargebackException** — 실효 계약 환수 자동생성
 7. **calcOverride** — 조직 트리 상향 탐색 → 상위 직급에 분배
 8. **aggregate** — 설계사별 통합 집계 → settle_master UPSERT (3.3% 세금)
+9. **accountingEntryGenerate** — recruit_ledger+maintain_ledger → contract_accounting_entry INSERT
+10. **yearEndIncomeAggregate** — 12월 마감 시만 실행: payment 합산 → agent_annual_income UPSERT

 ---

@@ -382,9 +402,25 @@ public class FooController {
 | V53 | 출금신청 — withdraw_request |
 | V54 | P4 메뉴 INSERT (P4-A + P4-B 14개 메뉴) |
 | V55 | P4 공통코드 추가 (approval_type, complaint_type, license_type 등) |
+| V56 | agent 세무 컬럼 보강 (tax_type/business_no/vat_type — V23 체크섬 충돌 보정) |
+| V57 | admin 계정 초기화 |
+| V58 | 1200%룰 메뉴 권한 |
+| V59 | 신규 메뉴 권한 |
+| V60 | statement 메뉴 권한 |
+| V61 | installment_plan 메뉴 권한 |
+| V62 | 추가 메뉴 권한 |
+| V63 | P5-W1: agent_annual_income 테이블 (설계사 연말 사업소득 집계) |
+| V64 | P5-W1: contract_accounting_entry 테이블 (회계 분개 엔트리) |
+| V65 | P5-W1: 테스트 데이터 + 메뉴 INSERT (ANNUAL_INCOME / ACCOUNTING_JOURNAL) |
+| V66 | P5-W1: account_code 마스터 + 초기 4건 (8350/2530/1130/4110) |
+| V67 | P5-W2: withholding_tax_report 테이블 (원천세 분기 신고) |
+| V68 | P5-W2: vat_report 테이블 (부가세 분기 신고) |
+| V69 | P5-W2: 테스트 데이터 + 메뉴 INSERT (원천세/부가세 신고) |
+| V70 | rule 도메인 감사 컬럼 보강 (commission_rate/payout_rule/override_rule 등) |
+| V71 | payment 세무 컬럼 보강 (income_tax_amount/local_tax_amount/vat_amount/net_amount) |

-> 운영 DB (192.168.0.60) 에는 현재 V17(또는 V22) 까지만 적용되어 있습니다.
-> **ga-api 재시작 시** Flyway 가 V18~V55 를 자동으로 순차 적용합니다.
+> 운영 DB (192.168.0.60) 현재 V71 까지 적용 완료.
+> **ga-api 재시작 시** Flyway 가 신규 마이그레이션을 자동으로 순차 적용합니다.

 ---

@@ -397,7 +433,7 @@ public class FooController {
 - [x] **ga-batch** — MonthlySettlementJob 8 Step (실제 동작 로직 포함)
 - [x] **Docker** — docker-compose + multi-stage Dockerfile + nginx
 - [x] **ga-frontend** — 50+ 페이지 (대시보드/설계사/계약/원장/정산/지급/배치/KPI/수수료/시스템관리)
- [x] **DB 마이그레이션** — V1~V55 (55개 파일, ga-common/src/main/resources/db/migration)
+- [x] **DB 마이그레이션** — V1~V71 (71개 파일, ga-common/src/main/resources/db/migration)
 - [x] **코드 품질** — Enum/DTO/MapStruct/readOnly 트랜잭션 일괄 정비
 - [x] **P0 세무·공제·명세서** — TaxCalculator / DeductionService / ExcelStatementGenerator
 - [x] **P1 1200%룰·분급·차등환수** — RegulatoryLimitChecker / InstallmentPlanGenerator / ChargebackCalculator
@@ -405,10 +441,12 @@ public class FooController {
 - [x] **P3 KPI 대시보드** — Materialized View 4종 + Service + 화면
 - [x] **P4-A 수수료 종류 보강** — commission_master 통합 / 수금 / 갱신 / 부활 / 유지보수수당 / 오버라이드원장
 - [x] **P4-B 운영 도메인** — 위촉계약 / 자격관리 / 보수교육 / 계약변경 / 민원 / 결재워크플로우 / 공지·알림 / 첨부파일 / 출금신청
- [x] **운영 DB** — 192.168.0.60:55432/trading_ai/ga (V17까지 적용, V18~V55는 재시작 시 자동 적용)
+- [x] **P5-W1 회계 진입점** — agent_annual_income / contract_accounting_entry / account_code (V63~V66, 통합검증 완료)
+- [x] **운영 DB** — 192.168.0.60:55432/trading_ai/ga (V71 까지 적용 완료)
 - [ ] **단위/통합 테스트** — 미작성 (SqlSessionFactory 환경 문제로 보류)
 - [ ] **MappingEngine 정밀화** — 일부 변환 규칙은 단순화된 형태
- [ ] **P5 회계/분석** — 전표 분개 / 원천세·부가세 신고 / 결산 / 이상치·예측 / 연말 지급명세서
+- [ ] **P5-W2 원천세·부가세 신고** — withholding_tax_report / vat_report (V67~V69 스키마 완료, Service+Controller 미완)
+- [ ] **P5-W3 결산 / 이상치 / 연말 지급명세서** — 미착수
 - [ ] **P6 외부 연동** — 펌뱅킹 실연동 / SMS·카카오 / 모바일 셀프 조회

 ---