← 포트폴리오 목록

집단소송 플랫폼 관리자 및 이관 콘솔

소송 정보 등록·수정·상태 변경, 참여·문의 접수함, 변경 이력 로그, 기존 데이터 이관 콘솔과 사용 가이드북을 포함한 비개발자 운영용 관리자 프로젝트입니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종플랫폼
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 소송 관리
  • 참여·문의 접수함
  • 데이터 이관
  • 사용 가이드

프로젝트 개요

범위: 개발, 디자인, 기획

소송 정보 등록·수정·상태 변경, 참여·문의 접수함, 변경 이력 로그, 기존 데이터 이관 콘솔과 사용 가이드북을 포함한 비개발자 운영용 관리자 프로젝트입니다. P1 공개 사이트와 같은 Node.js·PostgreSQL 스택에 알림 큐 인프라를 더해 확장하는 구조로 설계합니다.

작업 범위

  • 소송 관리: 소송 목록과 선택한 소송의 상세·상태 변경·공개 여부를 한 화면에서 편집하는 관리자 화면을 구성합니다
  • 참여·문의 접수함: 소송별 참여 신청과 일반 문의를 목록으로 조회하고 처리 상태와 담당자 메모를 관리합니다
  • 데이터 이관: 기존 홈페이지의 게시물·고객 정보·문의 기록을 새 시스템으로 옮기는 이관 작업을 단계별로 점검합니다
  • 사용 가이드: 비개발자 직원을 위한 관리자 사용 매뉴얼과 운영 절차, 문제 해결 가이드를 관리자 안에서 바로 열람합니다

주요 업무

  • 소송 관리 화면: 좌측 목록 레일과 우측 상세 편집 패널, 상태 변경 이력 기록을 구현합니다
  • 참여·문의 접수함 화면: 필터·검색 목록, 신청자 상세 패널, 담당 변호사 지정, CSV 내보내기를 구현합니다
  • 데이터 이관 화면: 원본 파일 업로드, 필드 매핑, 검증 리포트, 단계별 실행 화면을 구현합니다
  • 사용 가이드 화면: 트리 목차, 블록 기반 문서 뷰, 화면 연결 링크를 구현합니다
집단소송 플랫폼 관리자 및 이관 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

소송 상태 전이 규칙이 법무 절차 변경에 따라 달라질 수 있어

코드가 아닌 규칙 테이블로 관리하는 구조 설계가 필요하며 관리 화면에서 편집하도록 대응합니다

법률 상담 접수 정보의 열람 통제를 위해 마스킹과 열람 로그 범위를 정해야 하며

역할별 열람 권한 매트릭스로 대응합니다

기존 홈페이지 데이터의 형식 불일치와 중복 고객 정보를 이관하는 매핑 기준 설계가 필요하며

드라이런 리포트와 배치 롤백으로 대응합니다

비개발자 담당자가 혼자 운영할 수 있도록 가이드 문서와 화면 도움말을 동기화하는 구조 설계가 필요하며

딥링크 기반 문서 트리로 대응합니다

구현 내용

핵심 기능 상세

핵심 기능 1

소송 관리

소송 목록과 선택한 소송의 상세·상태 변경·공개 여부를 한 화면에서 편집하는 관리자 화면을 구성합니다. 좌측 목록 레일과 우측 상세 편집 패널, 상태 변경 이력 기록을 구현합니다.

  • 소송 CRUD와 상태 변경을 트랜잭션으로 묶어 변경 전후 값을 이력 테이블에 기록
  • react-hook-form과 Zod 기반 상세 편집 폼으로 섹션 블록 편집 UI 구성
  • 상태 전이 규칙을 상태 머신 테이블로 정의하여 허용되지 않는 전환을 서버에서 차단

소송 상태 전이를 규칙 테이블로 정의하고 모든 변경을 감사 이력으로 남겨, 비개발자 담당자도 안전하게 상태를 바꿀 수 있는 관리 구조를 구현합니다.

소송 관리
소송 관리 실제 화면
핵심 기능 2

참여·문의 접수함

소송별 참여 신청과 일반 문의를 목록으로 조회하고 처리 상태와 담당자 메모를 관리합니다. 필터·검색 목록, 신청자 상세 패널, 담당 변호사 지정, CSV 내보내기를 구현합니다.

  • 소송·상태·접수일 복합 필터와 커서 기반 페이지네이션으로 접수 목록 조회 설계
  • 개인정보 열람 시 마스킹 해제와 열람 로그 기록 구조 구현
  • Bull Queue와 Redis로 접수 알림 이메일·SMS 재시도 큐 구성

접수 데이터를 기본 마스킹 상태로 보여주고 열람 시점마다 로그를 남겨, 법률 상담 정보의 접근 통제를 관리 화면 수준에서 구현합니다.

참여·문의 접수함
참여·문의 접수함 실제 화면
핵심 기능 3

데이터 이관

기존 홈페이지의 게시물·고객 정보·문의 기록을 새 시스템으로 옮기는 이관 작업을 단계별로 점검합니다. 원본 파일 업로드, 필드 매핑, 검증 리포트, 단계별 실행 화면을 구현합니다.

  • CSV·JSON 원본을 스트림으로 읽어 필드 매핑 규칙에 따라 변환하는 이관 스크립트 설계
  • 건별 검증 결과를 성공·경고·실패로 분류하는 드라이런 리포트 구현
  • 이관 배치 단위 롤백을 위해 배치 ID 컬럼과 보관 테이블을 함께 설계

본 이관 전에 드라이런으로 매핑 오류를 리포트하고 배치 단위로 되돌릴 수 있는 이관 절차를 화면과 스크립트로 구현합니다.

데이터 이관
데이터 이관 실제 화면
핵심 기능 4

사용 가이드

비개발자 직원을 위한 관리자 사용 매뉴얼과 운영 절차, 문제 해결 가이드를 관리자 안에서 바로 열람합니다. 트리 목차, 블록 기반 문서 뷰, 화면 연결 링크를 구현합니다.

  • 마크다운 문서를 블록 컴포넌트로 렌더링하는 문서 뷰어와 트리 목차 구성
  • 관리자 각 화면의 도움말 아이콘에서 해당 가이드 항목으로 연결되는 딥링크 구조 설계
  • 문서 내 키워드 검색과 최근 열람 항목 표시 기능 구현

가이드북을 별도 파일이 아니라 관리자 안의 문서 트리로 구성하고 각 화면에서 해당 항목으로 바로 연결하여, 인수인계 문서가 실제 사용 흐름과 맞물리는 구조를 구현합니다.

사용 가이드
사용 가이드 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

관리 권한·감사 이력 모델 설계 · 2026.10

관리자 역할 3단계와 상태 전이 규칙 테이블, 변경 이력·열람 로그 스키마 설계

STEP 2

소송 편집·상태 변경 화면 구현 · 2026.10

목록 레일과 상세 편집 패널, 섹션 블록 편집기, 상태 전이 검증 API 구현

STEP 3

접수함·알림 큐 구축 · 2026.10

접수 목록 필터, 개인정보 마스킹, Redis 기반 알림 재시도 큐와 CSV 내보내기 구현

STEP 4

이관 콘솔 및 가이드북 구성 · 2026.10

필드 매핑 이관 스크립트, 드라이런 리포트 화면, 트리형 사용 가이드 문서 뷰 구성

개발 결과

소송 상태 전이 규칙 테이블 설계허용 전이를 규칙 테이블로 정의하고 서버에서 검증하여 비개발자도 안전하게 상태를 바꾸는 구조 설계
감사 이력 및 열람 로그 체계 구축변경 전후 값을 JSON 이력으로 저장하고 개인정보 열람 시점을 별도 로그로 남기는 이중 기록 구조 구축
배치 단위 롤백 가능한 이관 절차 구현배치 ID 기반 이관 기록과 드라이런 리포트로 본 이관 전 검증과 되돌리기를 지원하는 스크립트 구현
화면 연동형 가이드 문서 구조 설계관리자 화면별 도움말 아이콘을 문서 트리 항목에 딥링크로 연결하는 가이드북 구조 설계

기술적 주안점

  • 소송 상태 전이를 규칙 테이블로 정의하고 모든 변경을 감사 이력으로 남겨, 비개발자 담당자도 안전하게 상태를 바꿀 수 있는 관리 구조를 구현합니다
  • 접수 데이터를 기본 마스킹 상태로 보여주고 열람 시점마다 로그를 남겨, 법률 상담 정보의 접근 통제를 관리 화면 수준에서 구현합니다
  • 본 이관 전에 드라이런으로 매핑 오류를 리포트하고 배치 단위로 되돌릴 수 있는 이관 절차를 화면과 스크립트로 구현합니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의