청약자 5명·4단계 파이프라인 — 문의→상담→청약→계약체결을 한 클릭 「조합원 전환」으로

지역주택조합 분양은 「청약자 → 조합원」 전환의 깔때기다. 잠재 청약자가 100명 들어오면, 그중 80명이 상담을 받고, 50명이 청약을 신청하고, 결국 30명이 계약을 체결한다. 현장관리 ERP의 청약자 모듈은 이 깔때기 4단계를 색상 Tag로 시각화하고, 마지막 단계에서 「조합원 번호 부여 + 계약일」 한 번의 클릭으로 청약자를 조합원 테이블로 자동 마이그레이션한다.

① 청약자 목록 — 4단계 Tag + 청약번호·연락처·희망평형 한 줄로

「청약자 목록」 탭을 열면 첫 화면이 검색·필터 + 단계별 카운트 Tag + 청약자 매트릭스로 답한다.

• 3가지 검색 키 통합: 「이름 / 연락처 / 청약번호」 한 검색창에서 모두 검색 — 「강민호」 또는 「010-1234」 또는 「A-2026-001」 모두 동일하게 1초
• 단계 필터 드롭다운: 「청약신청만 보기 / 상담완료만」 1초 격리
• 4단계 카운트 Tag: 화면 상단에 「문의 1 · 상담완료 2 · 청약신청 2 · 계약체결 0」 — 한눈에 깔때기 진척도 파악
• 8컬럼 매트릭스: 청약번호 / 성명(클릭→수정) / 연락처 / 단계(색상 Tag) / 희망평형 / 청약일 / 전환(대기/전환완료) / 관리
• 관리 컬럼 3개 액션: 수정(연필) / 조합원 전환(파란 Swap 아이콘 — 미전환자만) / 삭제(휴지통)
• 「엑셀 일괄등록」 버튼: 1,000명 청약자를 엑셀 한 장으로 등록 — 컬럼 매핑 모달로 자동 매칭

② 청약자 등록 모달 — 11필드 + 주소 검색 + 소개 대행사·직원까지 한 폼

「청약자 등록」 버튼을 클릭하면 11필드 폼이 한 모달에 펼쳐진다 — 청약자 한 명의 모든 정보가 같은 폼에 모임.

• 청약번호 + 성명(필수): 사업장에서 자체 부여하는 「A-2026-001」 형식 청약번호 + 본인 확인용 성명
• 연락처 + 보조 연락처 + 이메일: 분양 안내 SMS·문자 발송용 3채널 연락 정보
• 청약 단계 + 청약일(DatePicker): 진입 단계 즉시 지정 — 「문의」 또는 「상담완료」
• 희망 평형: 「74C」, 「59B」 같은 평형명 — 향후 동호수 배정 우선순위 결정
• 소개 대행사 + 담당 직원: 어느 대행사 어느 직원이 끌어온 청약자인지 추적 → 대행사 수수료 매칭의 원천 데이터
• 주소 검색 (Daum/Kakao): 우편번호 자동 채움 → 등기우편 발송 자동 매칭
• 메모 textarea: 「74C 1순위 희망」, 「소형 평형 우선」, 「계약 임박」 같은 운영 메모 자유 기록

③ 조합원 전환 모달 — 1클릭으로 청약자 → 조합원 마이그레이션

이 모듈의 가장 중요한 액션은 「조합원 전환」이다. 청약신청 단계에서 계약체결로 넘어갈 때, 운영자는 단 2필드만 입력하면 된다 — 조합원 번호 부여 + 계약일.

• 한 번의 POST: POST /applicants/{id}/convert?member_number=...&contract_date=... 한 호출로 백엔드가 처리
• 자동 마이그레이션: 청약자 테이블의 모든 정보(이름·연락처·이메일·주소·소개대행사·담당직원·메모)가 조합원 테이블로 자동 복사
• 청약자 is_converted=true 마킹: 원본 청약자 레코드는 보존되며 「전환완료」 Tag로 표시 → 깔때기 완료 통계 유지
• 새 조합원 자동 생성: 조합원 번호로 새 Member 레코드가 즉시 생성 → 분담금 회차·동호수 배정·문서 발송 모듈에서 즉시 사용 가능
• 중복 방지: 같은 청약자를 두 번 전환 시도하면 「이미 전환됨」 에러로 거절 → 조합원 중복 방지

④ 단계 관리 탭 — 4단계 파이프라인을 임원이 직접 정의

「단계 관리」 탭에서는 분양 깔때기의 단계 정의 자체를 임원이 직접 편집한다 — 사업장마다 다른 분양 프로세스에 맞춰 자유 커스터마이징.

• 4컬럼 단계 테이블: 순서 / 단계명(색상 Tag) / 전환단계(전환/일반) / 관리(수정·삭제)
• 색상 8가지 팔레트: 파랑 #1890ff / 초록 #52c41a / 노랑 #faad14 / 빨강 #f5222d / 보라 #722ed1 / 청록 #13c2c2 / 핑크 #eb2f96 / 주황 #fa8c16 — 단계별 시각 구분
• 「조합원 전환 단계」 플래그: is_final=true인 단계는 1개만 — 그 단계에 있는 청약자만 「조합원 전환」 버튼이 노출
• 순서 정렬: order 필드로 단계 표시 순서 자유 조정 — 「상담완료가 청약신청보다 먼저 와야 한다」 같은 사업장 룰 즉시 반영
• 우측 폼으로 즉시 추가: 단계명·순서·색상·플래그 4필드 — 「가계약」, 「본계약」 같은 사업장 고유 단계도 1초에 추가
• 편집·삭제 라이프사이클: 기존 단계도 수정·삭제 가능 → 사업 진행 중에 분양 프로세스 재설계 대응

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

분리 관리 시 문제	발생 비용	현장관리 ERP의 해결
청약자 명단을 분양사무실 엑셀로 별도 보존	조합원 전환 시 정보 재입력 → 오타·누락 발생	「조합원 전환」 1클릭 — 11필드 자동 마이그레이션
단계별 청약자 카운트를 매주 수기 집계	「상담완료 N명」, 「청약신청 M명」 매주 1시간	단계별 카운트 Tag 자동 갱신 — 0초
분양 프로세스 단계명을 코드에 하드코딩	사업장마다 다른 단계 → 개발 의뢰·배포 필요	단계 관리 탭 — 임원이 직접 추가/수정/삭제
소개 대행사·직원을 별도 메모로 추적	대행사 수수료 매칭 시 청약자 정보 재조회 필요	청약 등록 시 referral_agency_id·staff 필드 동시 입력

마무리 — "청약자는 미래의 조합원이다, 데이터부터 미래에 맞게 쌓아야 한다"

지역주택조합 분양 단계의 가장 큰 함정은 「청약자 데이터」와 「조합원 데이터」가 분리된 두 시스템에 있다는 것이다. 분양사무실은 엑셀로 청약자를 관리하고, 조합 본부는 ERP로 조합원을 관리한다. 그러다 청약자가 계약을 체결하는 순간, 누군가가 손으로 정보를 옮겨 적는다 — 그 과정에서 오타·누락·중복이 발생한다.

현장관리 ERP의 청약자 모듈은 그 단절을 없앤다. 청약 입력 → 단계 진행 → 조합원 전환이 한 데이터베이스 한 모듈 안에서 일어난다. 청약자가 조합원이 되는 순간, 11필드가 자동 복사되고, 분담금·동호수·문서·통계 모듈이 즉시 그 새 조합원을 인식한다. 청약자 5명에서 조합원 5명으로 가는 데이터 여정이 1클릭으로 끝난다.

📌 본 포스트의 모든 데이터(청약번호·성명·청약일·단계명)는 실제 운영 중인 조합 시스템의 익명화된 화면입니다.