집단소송 플랫폼 관리자 및 이관 콘솔
소송 정보 등록·수정·상태 변경, 참여·문의 접수함, 변경 이력 로그, 기존 데이터 이관 콘솔과 사용 가이드북을 포함한 비개발자 운영용 관리자 프로젝트입니다.
프로젝트 개요
소송 정보 등록·수정·상태 변경, 참여·문의 접수함, 변경 이력 로그, 기존 데이터 이관 콘솔과 사용 가이드북을 포함한 비개발자 운영용 관리자 프로젝트입니다. P1 공개 사이트와 같은 Node.js·PostgreSQL 스택에 알림 큐 인프라를 더해 확장하는 구조로 설계합니다.
작업 범위
- 소송 관리: 소송 목록과 선택한 소송의 상세·상태 변경·공개 여부를 한 화면에서 편집하는 관리자 화면을 구성합니다
- 참여·문의 접수함: 소송별 참여 신청과 일반 문의를 목록으로 조회하고 처리 상태와 담당자 메모를 관리합니다
- 데이터 이관: 기존 홈페이지의 게시물·고객 정보·문의 기록을 새 시스템으로 옮기는 이관 작업을 단계별로 점검합니다
- 사용 가이드: 비개발자 직원을 위한 관리자 사용 매뉴얼과 운영 절차, 문제 해결 가이드를 관리자 안에서 바로 열람합니다
주요 업무
- 소송 관리 화면: 좌측 목록 레일과 우측 상세 편집 패널, 상태 변경 이력 기록을 구현합니다
- 참여·문의 접수함 화면: 필터·검색 목록, 신청자 상세 패널, 담당 변호사 지정, CSV 내보내기를 구현합니다
- 데이터 이관 화면: 원본 파일 업로드, 필드 매핑, 검증 리포트, 단계별 실행 화면을 구현합니다
- 사용 가이드 화면: 트리 목차, 블록 기반 문서 뷰, 화면 연결 링크를 구현합니다




프로젝트 핵심 과제
소송 상태 전이 규칙이 법무 절차 변경에 따라 달라질 수 있어
코드가 아닌 규칙 테이블로 관리하는 구조 설계가 필요하며 관리 화면에서 편집하도록 대응합니다
법률 상담 접수 정보의 열람 통제를 위해 마스킹과 열람 로그 범위를 정해야 하며
역할별 열람 권한 매트릭스로 대응합니다
기존 홈페이지 데이터의 형식 불일치와 중복 고객 정보를 이관하는 매핑 기준 설계가 필요하며
드라이런 리포트와 배치 롤백으로 대응합니다
비개발자 담당자가 혼자 운영할 수 있도록 가이드 문서와 화면 도움말을 동기화하는 구조 설계가 필요하며
딥링크 기반 문서 트리로 대응합니다
핵심 기능 상세
소송 관리
소송 목록과 선택한 소송의 상세·상태 변경·공개 여부를 한 화면에서 편집하는 관리자 화면을 구성합니다. 좌측 목록 레일과 우측 상세 편집 패널, 상태 변경 이력 기록을 구현합니다.
- 소송 CRUD와 상태 변경을 트랜잭션으로 묶어 변경 전후 값을 이력 테이블에 기록
- react-hook-form과 Zod 기반 상세 편집 폼으로 섹션 블록 편집 UI 구성
- 상태 전이 규칙을 상태 머신 테이블로 정의하여 허용되지 않는 전환을 서버에서 차단
소송 상태 전이를 규칙 테이블로 정의하고 모든 변경을 감사 이력으로 남겨, 비개발자 담당자도 안전하게 상태를 바꿀 수 있는 관리 구조를 구현합니다.


참여·문의 접수함
소송별 참여 신청과 일반 문의를 목록으로 조회하고 처리 상태와 담당자 메모를 관리합니다. 필터·검색 목록, 신청자 상세 패널, 담당 변호사 지정, CSV 내보내기를 구현합니다.
- 소송·상태·접수일 복합 필터와 커서 기반 페이지네이션으로 접수 목록 조회 설계
- 개인정보 열람 시 마스킹 해제와 열람 로그 기록 구조 구현
- Bull Queue와 Redis로 접수 알림 이메일·SMS 재시도 큐 구성
접수 데이터를 기본 마스킹 상태로 보여주고 열람 시점마다 로그를 남겨, 법률 상담 정보의 접근 통제를 관리 화면 수준에서 구현합니다.


데이터 이관
기존 홈페이지의 게시물·고객 정보·문의 기록을 새 시스템으로 옮기는 이관 작업을 단계별로 점검합니다. 원본 파일 업로드, 필드 매핑, 검증 리포트, 단계별 실행 화면을 구현합니다.
- CSV·JSON 원본을 스트림으로 읽어 필드 매핑 규칙에 따라 변환하는 이관 스크립트 설계
- 건별 검증 결과를 성공·경고·실패로 분류하는 드라이런 리포트 구현
- 이관 배치 단위 롤백을 위해 배치 ID 컬럼과 보관 테이블을 함께 설계
본 이관 전에 드라이런으로 매핑 오류를 리포트하고 배치 단위로 되돌릴 수 있는 이관 절차를 화면과 스크립트로 구현합니다.


사용 가이드
비개발자 직원을 위한 관리자 사용 매뉴얼과 운영 절차, 문제 해결 가이드를 관리자 안에서 바로 열람합니다. 트리 목차, 블록 기반 문서 뷰, 화면 연결 링크를 구현합니다.
- 마크다운 문서를 블록 컴포넌트로 렌더링하는 문서 뷰어와 트리 목차 구성
- 관리자 각 화면의 도움말 아이콘에서 해당 가이드 항목으로 연결되는 딥링크 구조 설계
- 문서 내 키워드 검색과 최근 열람 항목 표시 기능 구현
가이드북을 별도 파일이 아니라 관리자 안의 문서 트리로 구성하고 각 화면에서 해당 항목으로 바로 연결하여, 인수인계 문서가 실제 사용 흐름과 맞물리는 구조를 구현합니다.


프로젝트 진행 단계
관리 권한·감사 이력 모델 설계 · 2026.10
관리자 역할 3단계와 상태 전이 규칙 테이블, 변경 이력·열람 로그 스키마 설계
소송 편집·상태 변경 화면 구현 · 2026.10
목록 레일과 상세 편집 패널, 섹션 블록 편집기, 상태 전이 검증 API 구현
접수함·알림 큐 구축 · 2026.10
접수 목록 필터, 개인정보 마스킹, Redis 기반 알림 재시도 큐와 CSV 내보내기 구현
이관 콘솔 및 가이드북 구성 · 2026.10
필드 매핑 이관 스크립트, 드라이런 리포트 화면, 트리형 사용 가이드 문서 뷰 구성
개발 결과
기술적 주안점
- 소송 상태 전이를 규칙 테이블로 정의하고 모든 변경을 감사 이력으로 남겨, 비개발자 담당자도 안전하게 상태를 바꿀 수 있는 관리 구조를 구현합니다
- 접수 데이터를 기본 마스킹 상태로 보여주고 열람 시점마다 로그를 남겨, 법률 상담 정보의 접근 통제를 관리 화면 수준에서 구현합니다
- 본 이관 전에 드라이런으로 매핑 오류를 리포트하고 배치 단위로 되돌릴 수 있는 이관 절차를 화면과 스크립트로 구현합니다