← 포트폴리오 목록

마감다리 연동 운영 콘솔

급여전표 연동을 운영하는 관리자가 연동 상태와 마감 트리거, 계정과목·거래처 매핑 기준정보, 전송 이력과 실패 복구, 감사 로그를 한곳에서 다루는 확장 프로젝트입니다.

프로젝트 납품 요약

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

서비스 타입Web
업종데이터 분석
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaBullMQ(Redis)아마란스10·이어카운트·SAP 연동 어댑터
주요 기능
  • 연동 상태 대시보드와 마감 트리거
  • 계정과목·거래처 매핑 기준정보
  • 전송 이력과 실패 복구
  • 역할별 권한과 감사 로그

프로젝트 개요

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

급여전표 연동을 운영하는 관리자가 연동 상태와 마감 트리거, 계정과목·거래처 매핑 기준정보, 전송 이력과 실패 복구, 감사 로그를 한곳에서 다루는 확장 프로젝트입니다. 담당자와 관리자 역할에 따라 메뉴와 처리 권한이 달라지며, 실패 건과 매핑 누락을 대시보드에서 바로 찾아 처리하는 흐름을 구현합니다. 고객사 ERP 환경이 늘어나도 같은 기준정보와 이력 구조로 확장하는 방향을 제안합니다.

작업 범위

  • 연동 상태 대시보드와 마감 트리거: 아마란스10, 이어카운트, SAP 연동의 상태와 이번 달 마감 트리거 설정이 한 화면에 보입니다. 실패 건과 매핑 누락 건은 바로 해당 목록으로 이어집니다
  • 계정과목·거래처 매핑 기준정보: 아마란스 계정과목과 거래처 코드를 SAP·이어카운트 코드에 짝지어 등록하고 수정합니다. 매핑이 비어 있는 코드는 상단에 모아 보입니다
  • 전송 이력과 실패 복구: 전표 전송 이력을 대상 시스템과 상태로 걸러 보고, 실패 건의 요청·응답 내용을 확인한 뒤 다시 보냅니다. 다시 보내기는 되돌릴 수 없어 확인 대화상자를 거칩니다
  • 역할별 권한과 감사 로그: 경리 담당자와 연동 관리자 역할에 따라 보이는 메뉴와 처리 권한이 달라집니다. 연동 요청과 설정 변경은 감사 로그에 시각과 담당자와 함께 남습니다

주요 업무

  • 연동 상태 대시보드와 마감 트리거 화면: 연동 대상별 연결 상태와 마지막 성공 시각을 집계하고 마감 감지 방식(폴링 주기·웹훅)을 설정하는 화면을 구현합니다
  • 계정과목·거래처 매핑 기준정보 화면: 코드 매핑 테이블을 대상 시스템별로 관리하고 변경 이력을 남기며 전표 생성 시 최신 매핑을 적용합니다
  • 전송 이력과 실패 복구 화면: 전송 요청과 응답을 저장해 사유별로 분류하고 재시도 큐에 등록하며, 중복 전송 방지 키를 함께 보여 줍니다
  • 역할별 권한과 감사 로그 화면: 역할별 권한 매트릭스를 서버에서 검사하고 모든 변경을 감사 로그에 기록하며 실패 시 담당자에게 알림을 보냅니다
마감다리 연동 운영 콘솔
요구사항 정의

프로젝트 핵심 과제

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

운영 환경별 연동 방식이 달라 연결 점검 항목이 달라질 수

점검 항목을 설정 데이터로 두고 확장하는 방식으로 대응합니다

요청·응답 원문에 급여 정보가 포함될 수

저장 전 마스킹과 조회 권한 제한을 함께 적용합니다

매핑 변경이 이미 만든 전표와 충돌할 수

유효 기간 기반으로 적용 시점을 분리합니다

구현 내용

핵심 기능 상세

핵심 기능 1

연동 상태 대시보드와 마감 트리거

아마란스10, 이어카운트, SAP 연동의 상태와 이번 달 마감 트리거 설정이 한 화면에 보입니다. 실패 건과 매핑 누락 건은 바로 해당 목록으로 이어집니다.

  • 연동 대상별 상태 점검 결과를 주기 작업으로 저장해 대시보드에서 조회
  • 마감 감지 방식과 폴링 주기를 설정 테이블에 두고 변경 즉시 스케줄러에 반영
  • 실패·매핑 누락 건수를 한 쿼리로 집계해 목록 링크와 함께 표시

연결 상태 점검과 마감 트리거 설정을 한 화면에서 다뤄 운영자가 장애 원인과 조치를 같은 곳에서 찾도록 구조를 설계합니다.

연동 상태 대시보드와 마감 트리거
연동 상태 대시보드와 마감 트리거 실제 화면
핵심 기능 2

계정과목·거래처 매핑 기준정보

아마란스 계정과목과 거래처 코드를 SAP·이어카운트 코드에 짝지어 등록하고 수정합니다. 매핑이 비어 있는 코드는 상단에 모아 보입니다.

  • 대상 시스템별 매핑 테이블과 유효 기간 컬럼으로 변경 시점별 적용 구조 설계
  • 미매핑 코드를 전표 생성 시점에 수집해 관리 목록에 자동 등록
  • CSV 일괄 등록과 중복 코드 검사로 대량 입력 지원

매핑 변경을 유효 기간과 함께 저장해 이미 만들어진 전표는 유지하고 새 전표에만 변경이 적용되도록 설계합니다.

계정과목·거래처 매핑 기준정보
계정과목·거래처 매핑 기준정보 실제 화면
핵심 기능 3

전송 이력과 실패 복구

전표 전송 이력을 대상 시스템과 상태로 걸러 보고, 실패 건의 요청·응답 내용을 확인한 뒤 다시 보냅니다. 다시 보내기는 되돌릴 수 없어 확인 대화상자를 거칩니다.

  • 요청·응답 본문을 마스킹 처리해 저장하고 상세 화면에서 조회
  • 실패 사유 코드를 분류 테이블로 관리해 사유별 필터 제공
  • 재시도 요청은 멱등 키 검사를 거쳐 큐에 등록

요청과 응답 원문을 이력으로 남겨 실패 원인을 화면에서 바로 확인하고 같은 전표의 중복 전송을 서버에서 막도록 설계합니다.

전송 이력과 실패 복구
전송 이력과 실패 복구 실제 화면
핵심 기능 4

역할별 권한과 감사 로그

경리 담당자와 연동 관리자 역할에 따라 보이는 메뉴와 처리 권한이 달라집니다. 연동 요청과 설정 변경은 감사 로그에 시각과 담당자와 함께 남습니다.

  • 라우트와 API와 화면 요소 세 곳에서 역할 권한을 검사
  • 변경 전후 값을 JSON 차이로 저장하는 감사 로그 테이블 설계
  • 실패 알림을 이메일과 메신저 웹훅 채널로 분리해 발송

권한 검사를 서버 한 곳에서 정의하고 화면은 그 결과를 따르도록 해 역할이 늘어도 규칙이 어긋나지 않게 설계합니다.

역할별 권한과 감사 로그
역할별 권한과 감사 로그 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

운영 요건 정리와 DB 설계 · 2026.10

연동 설정·매핑·이력·감사 로그·권한 테이블 설계

STEP 2

운영 API 개발 · 2026.10

상태 점검, 매핑 관리, 이력 조회, 재시도와 알림 API 구현

STEP 3

관리 화면 개발 · 2026.10

대시보드, 기준정보, 전송 이력, 권한·감사 로그 화면 구현

STEP 4

권한 점검과 인수인계 · 2026.10

역할별 접근 점검, 백업 정책 정리와 운영 문서 작성

개발 결과

연동 상태 통합 대시보드 구현세 시스템의 연결 상태와 실패·매핑 누락 건을 한 화면에서 집계해 목록으로 이어지게 구현합니다
유효 기간형 매핑 기준정보 설계매핑 변경을 유효 기간과 함께 저장해 기존 전표는 유지하고 새 전표에만 적용되도록 설계합니다
요청·응답 이력 기반 복구 흐름 구축전송 원문을 마스킹해 저장하고 사유별 재시도로 이어지는 복구 흐름을 구축합니다
역할 기반 접근 제어와 감사 체계 적용라우트·API·화면 3중 권한 검사와 변경 전후 값 감사 로그를 적용합니다

기술적 주안점

  • 연결 상태 점검과 마감 트리거 설정을 한 화면에서 다뤄 운영자가 장애 원인과 조치를 같은 곳에서 찾도록 구조를 설계합니다
  • 매핑 변경을 유효 기간과 함께 저장해 이미 만들어진 전표는 유지하고 새 전표에만 변경이 적용되도록 설계합니다
  • 요청과 응답 원문을 이력으로 남겨 실패 원인을 화면에서 바로 확인하고 같은 전표의 중복 전송을 서버에서 막도록 설계합니다

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

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

프로젝트 문의