사용 설명서

Agency Management Platform 사용 가이드

빠른 시작 가이드

1

로그인

SUPER_ADMIN 계정으로 로그인

2

에이전시 등록

에이전시를 생성합니다

3

직원 등록

에이전시에 직원을 배정합니다

4

클라이언트 등록

관리할 병원/의원을 등록합니다

5

캠페인 & 리드

캠페인 생성 및 리드 추적

6

분석 & 청구

성과 분석 및 청구서 발행

목차

플랫폼 개요

에이전시 관리 플랫폼이란?

병원 마케팅 에이전시를 위한 멀티테넌트 통합 관리 플랫폼입니다. 여러 에이전시가 각자의 클라이언트(병원)와 고객(환자/리드)를 독립적으로 관리할 수 있습니다. 주요 기능: • 클라이언트(병원) 관리 • 마케팅 캠페인 운영 • 리드(환자) 추적 및 전환 관리 • 채널별 성과 분석 • 청구서 관리 • 콘텐츠 관리 • AI 자동화 (브리핑, 보고서, 콘텐츠 생성)

멀티테넌트 구조

플랫폼은 멀티테넌트 방식으로 운영됩니다. 각 에이전시는 자신의 데이터만 볼 수 있으며, 다른 에이전시의 데이터에는 접근할 수 없습니다. • 데이터 격리: 모든 데이터에 에이전시 ID가 자동 부여 • 자동 필터링: 로그인 시 JWT 토큰에 에이전시 정보가 포함되어 API 호출 시 자동으로 해당 에이전시 데이터만 반환 • SUPER_ADMIN: 전체 시스템을 관리하는 최상위 관리자로, 모든 에이전시의 데이터를 조회할 수 있음 • 공유 데이터: 마케팅 채널(22개)은 모든 에이전시가 공유
Tip
  • 에이전시 소속 사용자는 별도 설정 없이 자동으로 자기 에이전시 데이터만 보게 됩니다
  • SUPER_ADMIN은 에이전시에 소속되지 않으며, 모든 데이터를 관리할 수 있습니다

시스템 구성

• 프론트엔드: Next.js 기반 반응형 웹 애플리케이션 • 백엔드 API: NestJS REST API (JWT 인증) • 데이터베이스: PostgreSQL + Prisma ORM • 캐시: Redis • 파일 저장: MinIO (S3 호환) • 한국어/영어 다국어 지원 • AI: 3단계 LLM 폴백 체인 (STARIUM → Gemini → Groq)

사용자 역할

• SUPER_ADMIN: 전체 시스템 관리 (에이전시 생성/관리, 모든 데이터 접근) • ADMIN: 에이전시 관리자 (소속 에이전시의 사용자 관리, 설정 변경) • MANAGER: 매니저 (클라이언트/캠페인 관리) • MARKETER: 마케터 (캠페인/콘텐츠/리드 관리) • ANALYST: 분석가 (데이터 조회/분석/보고서) • VIEWER: 조회 전용 (클라이언트용 읽기 전용)
Tip
  • 최초 로그인 계정: admin@starium.site (SUPER_ADMIN)
  • 역할에 따라 접근 가능한 메뉴가 달라집니다
  • SUPER_ADMIN만 "에이전시 관리" 메뉴를 볼 수 있습니다