← 포트폴리오 목록
인스타그램 멀티계정 자동 게시 관제 시스템
인스타그램 멀티계정(10개) 자동 게시 요구사항을 기반으로, 콘텐츠 등록부터 예약·반복·동시 게시, 실시간 현황 모니터링까지 하나의 관제 콘솔로 구현하는 프로젝트입니다.
Bull Queue 기반 게시 스케줄링 엔진 구현delayed job과 지수 백오프 재시도로 10계정 동시 게시와 실패 복구를 처리하는 큐 아키텍처를 설계합니다.
토큰 암호화 및 자동 갱신 구조 설계AES-256 암호화 저장과 node-cron 기반 만료 감지로 다중 계정 OAuth 토큰을 안전하게 유지하는 구조를 구현합니다.
실시간 게시 상태 스트리밍 구현Socket.io와 Bull Queue 이벤트를 결합해 폴링 없이 게시 상태 변화를 즉시 반영하는 실시간 대시보드를 구축합니다.
Overview
프로젝트 개요
인스타그램 멀티계정(10개) 자동 게시 요구사항을 기반으로, 콘텐츠 등록부터 예약·반복·동시 게시, 실시간 현황 모니터링까지 하나의 관제 콘솔로 구현하는 프로젝트입니다. Instagram Graph API OAuth 인증과 토큰 자동 갱신 구조를 적용해 계정 확장에도 유연하게 대응하도록 설계합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
10개 계정 동시 게시 시 Instagram Graph API 호출 한도를 초과하지 않
계정별 레이트리밋 관리 전략이 필요합니다
게시 실패 원인(토큰 만료/정책 위반/네트워크 오류)을 구분해 재시도 여부를 다르게 판단하는 오류 분류 로직 설계가 필요합니다
카드뉴스(캐러셀)와 릴스 게시 유형별로 상이한 Graph API 컨테이너 생성 절차를 하나의 스케줄러 흐름으로 통합하는 설계가 필요합니다
예약 시각과 반복 규칙이 겹치는 경우 중복 게시를 방지하는 job 중복 검증 로직이 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
게시 현황 실시간 대시보드
예약·진행·완료·실패 상태를 계정별로 한눈에 파악하고, 실패 건은 재시도 큐로 즉시 전환할 수 있는 관제 화면입니다
핵심 기능 2
콘텐츠 등록 및 예약
이미지·영상 업로드, 캡션 입력, 게시 계정과 일시를 지정해 예약하는 콘텐츠 등록 화면입니다. Multer 기반 파일 업로드와 클라이언트·서버 이중 검증으로 정책 위반 콘텐츠를 사전 차단합니다
핵심 기능 3
인스타그램 멀티계정 연동
10개 인스타그램 비즈니스 계정을 OAuth로 연결하고 토큰 상태를 관리하는 계정 연동 화면입니다. Instagram Graph API OAuth 플로우와 토큰 암호화 저장, 만료 전 자동 갱신 로직을 적용합니다
핵심 기능 4
반복 게시 스케줄러
날짜·시간 지정 및 반복 규칙에 따라 10계정에 동시 게시하고 실패 시 자동 재시도하는 스케줄러입니다. Bull Queue delayed job과 반복 규칙 엔진으로 KST 기준 예약·반복 게시를 처리합니다
구현 과정
프로젝트 진행 단계
STEP 1
요구사항 분석 및 DB 스키마 설계
멀티계정·게시·캡션 템플릿 도메인 분석, PostgreSQL 테이블 및 관계 매핑 설계
STEP 2
Instagram Graph API 연동 및 인증 구현
OAuth 인증 플로우, 토큰 암호화 저장, 자동 갱신 로직 구현
STEP 3
게시 스케줄링 엔진 개발
Bull Queue 기반 예약·반복 게시, 지수 백오프 재시도 로직 구현
STEP 4
실시간 대시보드 UI 개발
React 기반 관제 대시보드, Socket.io 실시간 상태 연동 구현
STEP 5
통합 테스트 및 정책 검증 적용
이미지 정책 검증 로직 적용, API 통합 테스트 진행
프로젝트 성과
주요 성과
Bull Queue 기반 게시 스케줄링 엔진 구현delayed job과 지수 백오프 재시도로 10계정 동시 게시와 실패 복구를 처리하는 큐 아키텍처를 설계합니다.
토큰 암호화 및 자동 갱신 구조 설계AES-256 암호화 저장과 node-cron 기반 만료 감지로 다중 계정 OAuth 토큰을 안전하게 유지하는 구조를 구현합니다.
실시간 게시 상태 스트리밍 구현Socket.io와 Bull Queue 이벤트를 결합해 폴링 없이 게시 상태 변화를 즉시 반영하는 실시간 대시보드를 구축합니다.
정책 검증 사전 차단 로직 구현이미지 비율·용량·포맷 3가지 기준을 업로드 단계에서 검증해 게시 실패 콘텐츠를 사전에 걸러내는 로직을 설계합니다.
Review
기술적 주안점
- Bull Queue 이벤트와 WebSocket을 결합해 폴링 없이 게시 상태를 즉시 반영하는 실시간 관제 구조를 설계합니다
- 정책 검증 로직을 업로드 단계에 내장해 게시 실패로 이어질 콘텐츠를 사전에 걸러내는 구조를 구현합니다
- 토큰 암호화 저장과 만료 전 자동 갱신을 결합해 10개 계정을 안정적으로 유지하는 인증 구조를 설계합니다
