AKC B2C 주차장 MSA 플랫폼 개발 중간보고서

프로젝트명: AKC B2C (Amano Korea Corporation Business-to-Consumer)
개발기간: 2025년 6월 ~ 현재 진행 중
보고일자: 2025년 9월 24일

📋 프로젝트 개요

AKC B2C는 아마노코리아의 B2C(Business-to-Consumer) 주차장 ### 6. PaymentService (결제 서비스) - 계획 중 50% 주요 기능:

🔄 결제 게이트웨이 연동
🔄 결제 이력 관리
🔄 환불 기능
🔄 정기결제 관리
🔄 결제 알림
🔄 정산 시스템

핵심 목표

확장성: 마이크로서비스 아키텍처를 통한 서비스별 독립적 확장
가용성: 컨테이너 기반 배포로 높은 가용성 보장
사용자 경험: 직관적이고 편리한 주차장 서비스 제공
통합성: 소셜 로그인, 외부 결제 시스템 등 다양한 서비스 통합

🏗️ 시스템 아키텍처

마이크로서비스 구성

현재 7개의 독립적인 마이크로서비스로 구성되어 있으며, 각 서비스는 특정 비즈니스 도메인을 담당합니다.

graph TD
    Frontend[Frontend<br/>React/TypeScript] 
    Admin[Admin Panel<br/>관리자]
    Nginx[Nginx<br/>Reverse Proxy]
    
    Auth[AuthService<br/>인증]
    Member[MemberService<br/>회원관리]
    AdminSvc[AdminService<br/>관리]
    Parking[ParkingService<br/>주차관리]
    Notification[NotificationService<br/>알림]
    Payment[PaymentService<br/>결제처리]
    Coupon[CouponService<br/>쿠폰관리]
    Common[CommonModule<br/>공통 라이브러리]
    
    Frontend --> Nginx
    Admin --> Nginx
    
    Nginx --> Auth
    Nginx --> Member
    Nginx --> AdminSvc
    Nginx --> Parking
    Nginx --> Notification
    Nginx --> Payment
    Nginx --> Coupon
    
    Auth -.-> Common
    Member -.-> Common
    AdminSvc -.-> Common
    Parking -.-> Common
    Notification -.-> Common
    Payment -.-> Common
    Coupon -.-> Common
    
    classDef frontend fill:#e1f5fe
    classDef gateway fill:#f3e5f5
    classDef service fill:#e8f5e8
    classDef common fill:#fff3e0
    
    class Frontend,Admin frontend
    class Nginx gateway
    class Auth,Member,AdminSvc,Parking,Notification,Payment,Coupon service
    class Common common

인프라 구성

컴포넌트	기술스택	용도	상태
API Gateway	Nginx	리버스 프록시, 로드밸런싱	✅ 완료
데이터베이스	MySQL 8.0	관계형 데이터 저장	✅ 완료
캐시	Redis 7	세션, 토큰 캐싱	✅ 완료
메시지큐	Apache Kafka	서비스 간 비동기 통신	✅ 완료
컨테이너화	Docker & Docker Compose	서비스 배포 관리	✅ 완료

🚀 서비스별 개발 현황

1. AuthService (인증 서비스) - 진행 중 80%

주요 기능:

✅ 이메일/비밀번호 로그인 및 회원가입
✅ JWT 토큰 관리 (생성, 검증, 갱신, 무효화)
✅ 소셜 로그인 (Google, Kakao, Naver)
🔄 비밀번호 재설정 및 회원 탈퇴
🔄 결제 이력 관리

2. MemberService (회원 관리 서비스) - 진행 중 70%

주요 기능:

✅ 회원 정보 관리 (CRUD)
✅ 회원 목록 조회 (페이징, 검색, 정렬)
✅ 회원 상태 관리 (활성, 비활성, 정지)
🔄 법인웹 회원 정보 관리
🔄 통계 데이터 및 관리자 대시보드

3. AdminService (관리자 서비스) - 진행 중 80%

주요 기능:

✅ 관리자 인증 및 권한 관리
✅ 관리자 계정 관리
🔄 시스템 모니터링
✅ 사용자 관리 기능

📸 관리자 관리 화면

📸 권한 관리 화면

4. ParkingService (주차장, 주차권 관리 서비스) - 진행 중 50%

주요 기능:

✅ 주차장 정보 관리
✅ 주차 공간 상태 관리
✅ 주차장 검색 및 조회
🔄 주차권 구매관리 기능
🔄 내부 주차권 검색 및 조회
✅ 내부주차장 검색 및 조회
✅ 이미지 및 메타데이터 관리
🔄 kakfa 연동 테스트

📸 주차장 관리 화면

📸 주차권 관리 화면

📸 정기권 관리 화면

5. NotificationService (공지,알림,배너,약관,버전 서비스) - 진행 중 90%

주요 기능:

✅ 공지사항 관리 기능
✅ 배너 관리 기능
✅ 약관 관리 기능
✅ 버전 관리 기능
🔄 이메일 알림
🔄 푸시 알림 (Firebase 연동)
🔄 Kafka 이벤트 기반 알림
✅ 알림 이력 관리
🔄 알림 연동 테스트

📸 공지 관리 화면

📸 배너 관리 화면

📸 알림 관리 화면

📸 FAQ 관리 화면

📸 약관 관리 화면

📸 버전 관리 화면