← 포트폴리오 목록

협동조합 운영 관리 플랫폼

1차 홈페이지 운영을 지탱하는 관리자 백오피스를 마스터-디테일 구조로 구현하여, 신청 내역·콘텐츠·커뮤니티·회원을 한 화면 흐름에서 처리할 수 있도록 설계합니다.

마스터-디테일 상태 동기화 구조 구현React Query와 URL 쿼리 동기화로 리스트-상세 패널 간 상태를 일관되게 유지하는 구조를 설계합니다.
콘텐츠 CMS 프리사인드 업로드 구현AWS S3 Presigned URL 업로드 방식을 적용해 서버를 거치지 않는 이미지 업로드 파이프라인을 구축합니다.
통합 감사 로그 테이블 설계게시판·Q&A·회원 관리 액션을 단일 감사 로그 테이블에 기록하는 구조로 설계해 처리 이력을 추적합니다.
서비스 타입Web
업종플랫폼
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisAWS S3
주요 기능
  • 신청 내역 마스터-디테일 관리
  • 콘텐츠·교육과정 관리
  • 커뮤니티·회원 관리
  • 확장 운영 대시보드
Overview

프로젝트 개요

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

1차 홈페이지 운영을 지탱하는 관리자 백오피스를 마스터-디테일 구조로 구현하여, 신청 내역·콘텐츠·커뮤니티·회원을 한 화면 흐름에서 처리할 수 있도록 설계합니다. 2차 확장(수강신청·결제·대관예약·AI챗봇)을 위한 슬롯형 로드맵 대시보드까지 포함하는 확장 프로젝트입니다.

작업 범위

  • 신청 내역 마스터-디테일 관리: 컨설팅·사업 신청 내역을 좌측 리스트에서 선택하면 우측 패널에 신청자 정보, 처리 상태, 담당자 메모가 즉시 표시되는 관리자 화면입니다
  • 콘텐츠·교육과정 관리: 조합소개, 사업소개, 교육과정 등 홈페이지 소개 콘텐츠를 코드 수정 없이 관리자가 직접 등록·수정할 수 있는 CMS 화면입니다
  • 커뮤니티·회원 관리: 게시판 글·댓글, Q&A 문의, 회원 계정을 한 화면에서 모니터링하고 신고·삭제·권한 변경을 처리하는 관리 화면입니다
  • 확장 운영 대시보드: 신청·게시판·회원 현황을 슬림 상태바로 요약하고, 2차 확장 예정 기능(수강신청·결제·대관예약·AI챗봇) 자리를 준비 슬롯으로 안내하는 화면입니다

주요 업무

  • 신청 내역 마스터-디테일 관리 화면: 리스트는 신청유형·상태별 필터와 검색을 제공하고, 상세 패널에서 상태 변경·담당자 배정·메모 작성을 화면 전환 없이 인라인으로 처리합니다
  • 콘텐츠·교육과정 관리 화면: 섹션별 리치 텍스트 편집기와 이미지 업로드를 제공하고, 저장 시 홈페이지(맞춤 구현 데모) 콘텐츠 스키마에 바로 반영되도록 연동합니다
  • 커뮤니티·회원 관리 화면: 게시글/댓글/Q&A를 유형 탭으로 구분하고, 회원 목록에서는 계정 상태(정상/정지)와 활동 이력을 함께 표시합니다
  • 확장 운영 대시보드 화면: 현재 구현 범위의 요약 지표는 인라인 상태바로 표시하고, 2차 확장 항목은 '확장 예정' 라벨의 비활성 카드로 구분해 로드맵을 시각화합니다
협동조합 운영 관리 플랫폼
요구사항 정의

프로젝트 핵심 과제

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

신청 리스트-상세 패널 간 상태를 URL과 동기화하면서도 필터·페이지네이션 상태를 함께 유지하는 구조 설계

게시판·Q&A·회원 세 도메인의 서로 다른 관리 액션을 단일 감사 로그 스키마로 통합하는 데이터 모델 설계

콘텐츠 CMS에서 수정한 내용이 홈페이지 소개 콘텐츠 스키마와 즉시 일치하

유지하는 동기화 구조 필요

2차 확장 기능(수강신청·결제·대관예약·AI챗봇)을 실제 구현 없이도 향후 연결 가능한 슬롯 구조로 설계할

구현 내용

핵심 기능 상세

핵심 기능 1

신청 내역 마스터-디테일 관리

컨설팅·사업 신청 내역을 좌측 리스트에서 선택하면 우측 패널에 신청자 정보, 처리 상태, 담당자 메모가 즉시 표시되는 관리자 화면입니다.

  • React Query로 리스트·상세 패널 데이터를 동기화해 리스트 갱신 시 상세 패널도 함께 최신화
  • PostgreSQL 인덱스와 커서 페이지네이션으로 신청유형·상태 복합 필터 조회 최적화
  • 상태 변경 이력을 별도 로그 테이블에 적재해 처리 과정을 추적할 수 있도록 설계

리스트-상세 패널 간 선택 상태를 URL 쿼리와 동기화하여, 특정 신청 건의 상세 화면을 URL 하나로 공유하고 재접속해도 그대로 복원되는 구조를 구현합니다.

신청 내역 마스터-디테일 관리
신청 내역 마스터-디테일 관리 실제 화면
핵심 기능 2

콘텐츠·교육과정 관리

조합소개, 사업소개, 교육과정 등 홈페이지 소개 콘텐츠를 코드 수정 없이 관리자가 직접 등록·수정할 수 있는 CMS 화면입니다.

  • 리치 텍스트 에디터로 소개 콘텐츠 섹션별 편집 UI 구현
  • AWS S3 presigned URL 업로드로 이미지 파일을 클라이언트에서 스토리지로 직접 전송
  • 교육과정 등록 폼에 모집상태(모집중/마감) 토글과 정렬 순서 필드 추가

소개 콘텐츠를 코드 배포 없이 관리자 화면에서 직접 수정할 수 있는 구조로 설계하여, 콘텐츠 변경 요청마다 별도 개발 작업이 필요하지 않도록 합니다.

콘텐츠·교육과정 관리
콘텐츠·교육과정 관리 실제 화면
핵심 기능 3

커뮤니티·회원 관리

게시판 글·댓글, Q&A 문의, 회원 계정을 한 화면에서 모니터링하고 신고·삭제·권한 변경을 처리하는 관리 화면입니다.

  • 관리자 전용 삭제·정지 API에 역할 기반 접근 제어(RBAC) 미들웨어 적용
  • Redis에 최근 신고된 게시글 캐시를 두어 반복 조회 부하를 줄이는 구조 설계
  • 회원 활동 이력(게시글수/댓글수/문의수) 집계를 위한 PostgreSQL 뷰 정의

게시판·Q&A·회원 세 도메인의 관리 액션(삭제/정지/답변)을 단일 감사 로그 테이블에 기록하는 구조로 설계하여, 처리 이력을 한 화면에서 추적할 수 있습니다.

커뮤니티·회원 관리
커뮤니티·회원 관리 실제 화면
핵심 기능 4

확장 운영 대시보드

신청·게시판·회원 현황을 슬림 상태바로 요약하고, 2차 확장 예정 기능(수강신청·결제·대관예약·AI챗봇) 자리를 준비 슬롯으로 안내하는 화면입니다.

  • PostgreSQL 집계 쿼리로 신청건수·게시글수·미답변 문의수를 상태바에 조회
  • 2차 확장 기능 카드에 라우트만 예약해두고 실제 화면은 비활성 상태로 렌더링하는 슬롯 패턴 적용
  • Recharts로 최근 신청 추이를 라인 차트로 시각화

2차 확장 기능(수강신청/결제/대관예약/AI챗봇)을 실제 구현 없이 슬롯 컴포넌트로 미리 배치하여, 추가 예산이 확정되면 해당 슬롯에 기능을 바로 연결할 수 있는 확장 구조를 설계합니다.

확장 운영 대시보드
확장 운영 대시보드 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

관리자 DB 스키마 및 감사 로그 설계 · 2026.09

신청·콘텐츠·게시판·회원 관리용 PostgreSQL 테이블 및 통합 감사 로그 테이블 설계

STEP 2

마스터-디테일 관리 API 개발 · 2026.09

신청 내역 리스트·상세 조회, 상태 변경, 담당자 배정 API 18~20개 구현

STEP 3

CMS 및 커뮤니티 관리 UI 개발 · 2026.09

React 기반 콘텐츠 CMS, 커뮤니티·회원 관리 화면, S3 업로드 연동 구현

STEP 4

확장 슬롯 및 운영 대시보드 구현 · 2026.09

2차 확장 슬롯 컴포넌트와 상태바형 운영 대시보드 구현, 통합 테스트 진행

프로젝트 성과

주요 성과

마스터-디테일 상태 동기화 구조 구현React Query와 URL 쿼리 동기화로 리스트-상세 패널 간 상태를 일관되게 유지하는 구조를 설계합니다.
콘텐츠 CMS 프리사인드 업로드 구현AWS S3 Presigned URL 업로드 방식을 적용해 서버를 거치지 않는 이미지 업로드 파이프라인을 구축합니다.
통합 감사 로그 테이블 설계게시판·Q&A·회원 관리 액션을 단일 감사 로그 테이블에 기록하는 구조로 설계해 처리 이력을 추적합니다.
2차 확장 슬롯 아키텍처 설계수강신청·결제·대관예약·AI챗봇 라우트를 사전 예약한 슬롯 컴포넌트로 확장 구조를 구현합니다.
Highlights

기술적 주안점

  • 리스트-상세 패널 간 선택 상태를 URL 쿼리와 동기화하여, 특정 신청 건의 상세 화면을 URL 하나로 공유하고 재접속해도 그대로 복원되는 구조를 구현합니다
  • 소개 콘텐츠를 코드 배포 없이 관리자 화면에서 직접 수정할 수 있는 구조로 설계하여, 콘텐츠 변경 요청마다 별도 개발 작업이 필요하지 않도록 합니다
  • 게시판·Q&A·회원 세 도메인의 관리 액션(삭제/정지/답변)을 단일 감사 로그 테이블에 기록하는 구조로 설계하여, 처리 이력을 한 화면에서 추적할 수 있습니다

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

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기