FastAPI와 동적 라벨링 설계 기반의 Multi-tenant SaaS 구축

Context

기존 Excel 기반 관리로 인한 결제 누락 및 데이터 불일치 문제 해결 필요. 다양한 업종(콘도미니엄, 학교, 체육관)을 하나의 플랫폼으로 수용해야 하는 다형성 요구사항 존재.

Technical Solution

• API와 Frontend의 완전한 분리를 통한 확장성 확보를 위해 FastAPI와 Vue 3 조합 채택
• 데이터베이스 내 rubros 테이블을 설계하여 업종별 맞춤형 라벨(Label)을 동적으로 관리하는 Metadata-driven UI 구조 구현
• Pinia Store를 활용한 클라이언트 사이드 어휘집(Vocabulary) 매핑으로 코드 중복 없이 다중 도메인 대응
• Async SQLAlchemy 및 FastAPI의 native async 기능을 통한 동시 쿼리 처리 효율화
• Docker Compose 기반의 Nginx Reverse Proxy 설계를 통한 내부 네트워크 격리 및 보안 강화
• public_token 기반의 인증 시스템 구축으로 계정 생성 없는 외부 결제 포털 접근 구현