계약위반 17건을 0초에 자동감지 — 납부연체·서류미제출까지 한 모듈로 추적

지역주택조합 운영의 가장 골치 아픈 영역은 "누가 약속을 어겼는지"를 매일 추적하는 일이다. 분담금 회차가 지나면 자동으로 연체 명단이 쌓이고, 가입계약서·인감증명·신탁동의서 같은 서류 미제출자도 끊임없이 발생한다. 현장관리 ERP의 계약위반 모듈은 280명 × 9회차 매트릭스를 0초에 스캔해 17건의 신규 위반을 자동 감지하고, 감지→통보→처리중→해결완료까지 5단계 라이프사이클을 한 화면에서 추적한다.

① 4개 통계 + 위반 목록 — 17건의 납부연체를 한 줄로

계약위반 페이지를 열면 첫 화면이 4개 통계 카드 + 위반 목록 테이블로 답한다.

• 전체 위반 17건 (AlertOutlined 아이콘) — 모든 상태(감지됨·통보완료·처리중·해결완료·취소)의 합계
• 이달 신규 17건 (빨간 강조) — 이번 달에 새로 감지된 건수, 운영 부담 즉시 가시화
• 처리중 0건 (파란 강조) — 통보 후 처리 진행 중인 건수
• 해결완료 0건 (초록 강조) — 납부·서류제출 등으로 처리 완료된 건수 → 이달 KPI

그 아래 테이블은 감지일·조합원명·조합원번호·위반종류·내용·상태·처리일·관리 8개 컬럼으로 한 줄 진단이 가능하다. 「상태」 컬럼은 인라인 Select로 박혀 있어 테이블에서 바로 「감지됨 → 통보완료 → 처리중 → 해결완료」를 1클릭으로 변경 — 모달 열 필요 없음.

• 위반종류 색상 코딩: 납부연체(빨강) / 서류미제출(주황) / 계약위반(volcano) / 기타(회색) — 한눈에 종류 분류
• 상태 5단계 Badge: 감지됨(error) / 통보완료(warning) / 처리중(processing) / 해결완료(success) / 취소(default)
• 위반 종류·상태 필터: 「납부연체 + 처리중만 보기」 같은 조합 필터 1초
• 조합원명 클릭: 위반 상세 드로어 즉시 오픈 (행 클릭으로도 동일 동작)
• 관리 컬럼 2개 액션: 수정(EditOutlined) / 삭제(DeleteOutlined + Popconfirm)

② 자동감지 — 280명 × 2회차를 한 번에 스캔, 17건 즉시 등록

「자동감지」 탭으로 전환하면 한 버튼으로 전체 매트릭스 스캔이 가능한 화면이 펼쳐진다. 매주 임원이 직접 엑셀로 연체 명단을 만들 필요가 없다.

• 연체 자동감지 실행 버튼 (빨간 danger): 1클릭으로 POST /violations/detect/ 호출 → 오늘 날짜 기준 납부기한이 지난 회차 중 납부기록이 없는 정상 조합원을 백엔드에서 모두 스캔
• 중복 방지 로직: 같은 회차에 이미 위반이 등록된 조합원은 제외 → 「이미 감지됨」으로 분류
• 감지 결과 4지표: 신규 위반 감지(빨강 if >0) / 기존 위반(노랑) / 스캔 조합원(280명) / 스캔 납부회차(2개) — 한 번의 스캔으로 280×2=560 셀 검증
• 마지막 실행 시각 표시: 「2026-04-17 05:55:58」 — 자동감지 운영 주기 추적
• 경고 알림 자동 등장: 신규 위반 >0이면 「신규 N건의 납부연체 위반이 감지되어 등록되었습니다. 위반 목록에서 확인 후 조합원에게 통보하세요.」 배너 출력
• 토스트 메시지: 「신규 위반 17건 감지됨」 (success) / 「신규 위반 없음」 (info) — 운영자 즉시 인지

③ 위반 상세 드로어 — 6필드 정보 + 상태·메모를 한 폼으로

조합원명 또는 행을 클릭하면 우측 드로어가 슬라이드해 그 위반의 모든 정보를 한 화면에 펼친다.

• 6개 정보 필드 (Descriptions): 조합원(이정희 #276) / 감지일(2026-04-17 05:55) / 통보일 / 해결일 / 제목(가입계약서 상 중도금 2차 납부 연체) / 자동감지(자동/수동 Tag)
• 「자동」/「수동」 구분 Tag: 백엔드 자동감지로 등록된 건과 운영자가 수동 등록한 건을 즉시 구분 → 감사 추적성
• 상태·메모 수정 폼: 처리 상태(Select 5옵션) + 상세 내용(textarea) + 처리 메모(「처리 내용·조치사항 등 메모」) — 한 폼으로 모든 후속 작업
• 드로어에서 즉시 저장: 「저장」 버튼 1클릭으로 PUT /violations/{id} → 목록 자동 새로고침 → 드로어 자동 닫힘
• 처리 메모의 운영 가치: 「2026-04-17 등기우편 발송」, 「2026-04-20 본인 통화 - 4/30까지 납부 약속」 같은 액션 로그가 한 곳에 누적

④ 위반 라이프사이클 — 5단계로 분리해 운영 책임 명확화

현장관리 ERP의 위반은 단순 「있다/없다」 boolean이 아니라 5단계 상태 머신으로 추적된다.

상태	의미	전이 트리거
● 감지됨	자동감지·수동등록 직후 초기 상태	자동감지 실행 / 수동 등록 폼 제출
● 통보완료	조합원에게 등기·문자·전화로 통보 완료	운영자가 인라인 Select로 변경 → notified_at 자동 기록
● 처리중	납부·서류제출 등 후속 작업이 진행 중	조합원 응답 후 운영자가 수동 변경
● 해결완료	납부 / 서류제출 / 조치 완료된 종결 상태	resolved_at 자동 기록 → KPI 카드 +1
● 취소	오감지·중복 등으로 무효 처리	메모에 취소 사유 기록 후 상태 변경

⑤ 왜 한 모듈이어야 하는가 — 계약위반 분리 관리의 4가지 비용

분리 관리 시 문제	발생 비용	현장관리 ERP의 해결
연체 명단을 매주 엑셀로 수기 정리	280×9 매트릭스 VLOOKUP 작업, 매주 3시간	1버튼 자동감지 — 0초에 17건 검출 + 중복 제외
위반 통보 이력을 종이 결의서로만 보존	「언제 통보했나」 검증에 박스 검색 1주	5단계 상태 + 통보일/해결일 자동 타임스탬프
서류미제출·계약위반을 분담금과 별도 관리	3개 시스템(엑셀·캘린더·이메일) 동기화 부담	위반종류 4분류로 통합, 한 테이블에 모두 누적
처리 메모를 담당자 개인 카톡·메모장에 보관	담당자 퇴사 시 인수인계 불가, 분쟁 시 증거 부재	위반별 상세 드로어에 처리 메모 영구 저장

마무리 — "위반은 막을 수 없다, 그러나 5단계로 추적할 수는 있다"

계약위반은 280명 조합 운영의 필연이다. 9회차 분담금 중 어느 한 번도 연체 없이 끝나는 조합은 없고, 서류 한 장 빠진 조합원은 매주 새로 발견된다. 그래서 계약위반 모듈의 가치는 「위반을 0으로 만드는 것」이 아니라 「위반을 0초에 감지하고, 5단계로 추적하고, 처리 이력을 영구 보존하는 것」이다.

현장관리 ERP의 계약위반 모듈은 자동감지 1버튼 + 4개 통계 카드 + 5단계 라이프사이클 + 위반별 처리 메모를 한 데이터 모델에 묶어, "오늘 신규 위반 몇 건?", "이 조합원 통보했나?", "지난 분기 해결율?", "이 건 어떻게 처리됐나?" 라는 네 질문에 0초로 답한다. 그게 매주 엑셀 작업 3시간을 1클릭 0초로 줄이는 방법이다.

📌 본 포스트의 모든 데이터(조합원명·위반 건수·감지일)는 실제 운영 중인 조합 시스템의 익명화된 화면입니다.