hgzero/develop/dev/package-structure.md

# 패키지 구조도

## 전체 프로젝트 구조

```
HGZero/
├── common/                          # 공통 모듈
├── user/                           # User Service (Layered)
├── meeting/                        # Meeting Service (Clean)
├── stt/                           # STT Service (Layered)
├── ai/                            # AI Service (Clean)
├── notification/                  # Notification Service (Layered)
├── settings.gradle                # Gradle 설정
└── build.gradle                   # 루트 build.gradle
```

## 1. Common 모듈

```
common/
└── src/main/java/com/unicorn/hgzero/common/
    ├── dto/
    │   ├── ApiResponse.java
    │   ├── JwtTokenDTO.java
    │   ├── JwtTokenRefreshDTO.java
    │   └── JwtTokenVerifyDTO.java
    ├── entity/
    │   └── BaseTimeEntity.java
    ├── config/
    │   └── JpaConfig.java
    ├── util/
    │   ├── DateUtil.java
    │   └── StringUtil.java
    ├── aop/
    │   └── LoggingAspect.java
    └── exception/
        ├── ErrorCode.java
        ├── BusinessException.java
        └── InfraException.java
```

## 2. User Service (Layered Architecture)

```
user/
└── src/main/java/com/unicorn/hgzero/user/
    ├── UserApplication.java
    ├── controller/
    │   └── UserController.java
    ├── dto/
    │   ├── LoginRequest.java
    │   ├── LoginResponse.java
    │   ├── RefreshTokenRequest.java
    │   ├── RefreshTokenResponse.java
    │   ├── LogoutRequest.java
    │   └── TokenValidateResponse.java
    ├── service/
    │   ├── UserService.java
    │   └── UserServiceImpl.java
    ├── domain/
    │   └── User.java
    ├── repository/
    │   ├── entity/
    │   │   └── UserEntity.java
    │   └── jpa/
    │       └── UserRepository.java
    └── config/
        ├── SecurityConfig.java
        ├── SwaggerConfig.java
        ├── LdapConfig.java
        └── jwt/
            ├── JwtAuthenticationFilter.java
            ├── JwtTokenProvider.java
            └── UserPrincipal.java
```

## 3. Meeting Service (Clean Architecture)

```
meeting/
└── src/main/java/com/unicorn/hgzero/meeting/
    ├── biz/
    │   ├── domain/
    │   │   ├── Meeting.java
    │   │   ├── Minutes.java
    │   │   ├── MinutesSection.java
    │   │   ├── Todo.java
    │   │   ├── Template.java
    │   │   └── Dashboard.java
    │   ├── dto/
    │   │   ├── MeetingDto.java
    │   │   ├── MinutesDto.java
    │   │   ├── TodoDto.java
    │   │   ├── TemplateDto.java
    │   │   ├── DashboardDto.java
    │   │   └── WebSocketMessageDto.java
    │   ├── usecase/
    │   │   ├── in/
    │   │   │   ├── CreateMeetingUseCase.java
    │   │   │   ├── SelectTemplateUseCase.java
    │   │   │   ├── StartMeetingUseCase.java
    │   │   │   ├── EndMeetingUseCase.java
    │   │   │   ├── GetMinutesListUseCase.java
    │   │   │   ├── GetMinutesDetailUseCase.java
    │   │   │   ├── UpdateMinutesUseCase.java
    │   │   │   ├── FinalizeMinutesUseCase.java
    │   │   │   ├── VerifySectionUseCase.java
    │   │   │   ├── LockSectionUseCase.java
    │   │   │   ├── UnlockSectionUseCase.java
    │   │   │   ├── CreateTodoUseCase.java
    │   │   │   ├── CompleteTodoUseCase.java
    │   │   │   ├── GetTemplateListUseCase.java
    │   │   │   ├── GetTemplateDetailUseCase.java
    │   │   │   └── GetDashboardUseCase.java
    │   │   └── out/
    │   │       ├── MeetingReader.java
    │   │       ├── MeetingWriter.java
    │   │       ├── MinutesReader.java
    │   │       ├── MinutesWriter.java
    │   │       ├── TodoReader.java
    │   │       ├── TodoWriter.java
    │   │       ├── TemplateReader.java
    │   │       ├── CacheManager.java
    │   │       └── EventPublisher.java
    │   └── service/
    │       ├── MeetingService.java
    │       ├── MinutesService.java
    │       ├── TodoService.java
    │       ├── TemplateService.java
    │       ├── DashboardService.java
    │       └── WebSocketService.java
    └── infra/
        ├── MeetingApplication.java
        ├── controller/
        │   ├── MeetingController.java
        │   ├── MinutesController.java
        │   ├── TodoController.java
        │   ├── TemplateController.java
        │   ├── DashboardController.java
        │   └── WebSocketController.java
        ├── gateway/
        │   ├── entity/
        │   │   ├── MeetingEntity.java
        │   │   ├── MinutesEntity.java
        │   │   ├── MinutesSectionEntity.java
        │   │   ├── TodoEntity.java
        │   │   └── TemplateEntity.java
        │   ├── repository/
        │   │   ├── MeetingJpaRepository.java
        │   │   ├── MinutesJpaRepository.java
        │   │   ├── TodoJpaRepository.java
        │   │   └── TemplateJpaRepository.java
        │   ├── MeetingGateway.java
        │   ├── MinutesGateway.java
        │   ├── TodoGateway.java
        │   ├── TemplateGateway.java
        │   ├── CacheGateway.java
        │   └── EventPublisherGateway.java
        └── config/
            ├── SecurityConfig.java
            ├── SwaggerConfig.java
            ├── WebSocketConfig.java
            ├── RedisConfig.java
            └── jwt/
                ├── JwtAuthenticationFilter.java
                ├── JwtTokenProvider.java
                └── UserPrincipal.java
```

## 4. STT Service (Layered Architecture)

```
stt/
└── src/main/java/com/unicorn/hgzero/stt/
    ├── SttApplication.java
    ├── controller/
    │   ├── RecordingController.java
    │   ├── TranscriptionController.java
    │   └── SpeakerController.java
    ├── dto/
    │   ├── RecordingDto.java
    │   ├── TranscriptionDto.java
    │   ├── SpeakerDto.java
    │   └── TranscriptSegmentDto.java
    ├── service/
    │   ├── RecordingService.java
    │   ├── RecordingServiceImpl.java
    │   ├── TranscriptionService.java
    │   ├── TranscriptionServiceImpl.java
    │   ├── SpeakerService.java
    │   └── SpeakerServiceImpl.java
    ├── domain/
    │   ├── Recording.java
    │   ├── Transcription.java
    │   ├── TranscriptSegment.java
    │   └── Speaker.java
    ├── repository/
    │   ├── entity/
    │   │   ├── RecordingEntity.java
    │   │   ├── TranscriptionEntity.java
    │   │   └── SpeakerEntity.java
    │   └── jpa/
    │       ├── RecordingRepository.java
    │       ├── TranscriptionRepository.java
    │       └── SpeakerRepository.java
    └── config/
        ├── SecurityConfig.java
        ├── SwaggerConfig.java
        ├── AzureSpeechConfig.java
        ├── AzureBlobConfig.java
        ├── WebSocketConfig.java
        └── jwt/
            ├── JwtAuthenticationFilter.java
            ├── JwtTokenProvider.java
            └── UserPrincipal.java
```

## 5. AI Service (Clean Architecture)

```
ai/
└── src/main/java/com/unicorn/hgzero/ai/
    ├── biz/
    │   ├── domain/
    │   │   ├── ProcessedTranscript.java
    │   │   ├── ExtractedTodo.java
    │   │   ├── RelatedMinutes.java
    │   │   ├── Term.java
    │   │   └── Suggestion.java
    │   ├── dto/
    │   │   ├── TranscriptDto.java
    │   │   ├── TodoDto.java
    │   │   ├── RelatedMinutesDto.java
    │   │   ├── TermDto.java
    │   │   └── SuggestionDto.java
    │   ├── usecase/
    │   │   ├── in/
    │   │   │   ├── ProcessTranscriptUseCase.java
    │   │   │   ├── ImproveTranscriptUseCase.java
    │   │   │   ├── ExtractTodoUseCase.java
    │   │   │   ├── GetRelatedMinutesUseCase.java
    │   │   │   ├── DetectTermsUseCase.java
    │   │   │   ├── ExplainTermUseCase.java
    │   │   │   ├── SuggestDiscussionUseCase.java
    │   │   │   └── SuggestDecisionUseCase.java
    │   │   └── out/
    │   │       ├── TranscriptReader.java
    │   │       ├── TranscriptWriter.java
    │   │       ├── TodoWriter.java
    │   │       ├── RelatedMinutesReader.java
    │   │       ├── TermReader.java
    │   │       ├── LlmClient.java
    │   │       ├── VectorSearchClient.java
    │   │       └── CacheManager.java
    │   └── service/
    │       ├── TranscriptService.java
    │       ├── TodoService.java
    │       ├── RelatedMinutesService.java
    │       ├── TermService.java
    │       └── SuggestionService.java
    └── infra/
        ├── AiApplication.java
        ├── controller/
        │   ├── TranscriptController.java
        │   ├── TodoController.java
        │   ├── TermController.java
        │   └── SuggestionController.java
        ├── gateway/
        │   ├── entity/
        │   │   ├── TranscriptEntity.java
        │   │   └── TermEntity.java
        │   ├── repository/
        │   │   ├── TranscriptJpaRepository.java
        │   │   └── TermJpaRepository.java
        │   ├── TranscriptGateway.java
        │   ├── TodoGateway.java
        │   ├── RelatedMinutesGateway.java
        │   ├── TermGateway.java
        │   ├── LlmGateway.java
        │   ├── VectorSearchGateway.java
        │   └── CacheGateway.java
        └── config/
            ├── SecurityConfig.java
            ├── SwaggerConfig.java
            ├── OpenAiConfig.java
            ├── AzureAiSearchConfig.java
            ├── RedisConfig.java
            └── jwt/
                ├── JwtAuthenticationFilter.java
                ├── JwtTokenProvider.java
                └── UserPrincipal.java
```

## 6. Notification Service (Layered Architecture)

```
notification/
└── src/main/java/com/unicorn/hgzero/notification/
    ├── NotificationApplication.java
    ├── controller/
    │   ├── NotificationController.java
    │   └── NotificationSettingsController.java
    ├── dto/
    │   ├── NotificationDto.java
    │   ├── NotificationSettingsDto.java
    │   ├── EmailTemplateDto.java
    │   └── InvitationNotificationDto.java
    ├── service/
    │   ├── NotificationService.java
    │   ├── NotificationServiceImpl.java
    │   ├── NotificationSettingsService.java
    │   ├── NotificationSettingsServiceImpl.java
    │   ├── EmailService.java
    │   └── EmailServiceImpl.java
    ├── domain/
    │   ├── Notification.java
    │   ├── NotificationSettings.java
    │   └── EmailTemplate.java
    ├── repository/
    │   ├── entity/
    │   │   ├── NotificationEntity.java
    │   │   └── NotificationSettingsEntity.java
    │   └── jpa/
    │       ├── NotificationRepository.java
    │       └── NotificationSettingsRepository.java
    └── config/
        ├── SecurityConfig.java
        ├── SwaggerConfig.java
        ├── EmailConfig.java
        ├── EventHubConfig.java
        └── jwt/
            ├── JwtAuthenticationFilter.java
            ├── JwtTokenProvider.java
            └── UserPrincipal.java
```

## 패키지 네이밍 규칙

### 공통
- **Base Package**: `com.unicorn.hgzero`

### Layered Architecture (User, STT, Notification)
- **Package**: `com.unicorn.hgzero.{service-name}`
- **구조**:
  - controller: REST API 컨트롤러
  - service: 비즈니스 로직
  - domain: 도메인 모델
  - dto: 데이터 전송 객체
  - repository: 데이터 액세스
    - entity: JPA 엔티티
    - jpa: JPA Repository
  - config: 설정 클래스

### Clean Architecture (Meeting, AI)
- **Base Package**: `com.unicorn.hgzero.{service-name}`
- **구조**:
  - biz: 비즈니스 레이어
    - domain: 도메인 모델
    - dto: 비즈니스 DTO
    - usecase: 유스케이스
      - in: 입력 포트 (인터페이스)
      - out: 출력 포트 (인터페이스)
    - service: 유스케이스 구현체
  - infra: 인프라스트럭처 레이어
    - controller: REST API 컨트롤러
    - gateway: 출력 포트 구현체
      - entity: JPA 엔티티
      - repository: JPA Repository
    - config: 설정 클래스

## 설정 파일 구조

```
각 서비스/
├── src/main/resources/
│   ├── application.yml           # 메인 설정
│   └── application-dev.yml       # 개발 환경 설정
└── build.gradle                  # Gradle 빌드 설정
```

## 공통 라이브러리 의존성 (루트 build.gradle에 정의)

- Spring Boot Starter Web
- Spring Boot Starter Data JPA
- Spring Boot Starter Security
- Spring Boot Starter Actuator
- Spring Boot Configuration Processor
- Lombok
- MapStruct
- Springdoc OpenAPI (Swagger)
- JWT (jjwt-api, jjwt-impl, jjwt-jackson)
- PostgreSQL Driver
- Redis (Lettuce)
- Apache Commons Lang3
- Apache Commons IO

## 서비스별 추가 의존성

### User Service
- Spring LDAP

### Meeting Service
- Spring WebSocket
- Spring Messaging

### STT Service
- Azure Speech SDK
- Azure Blob Storage SDK
- Spring WebSocket

### AI Service
- OpenAI Java Client
- Azure AI Search SDK
- Spring AI

### Notification Service
- Spring Mail
- Azure Event Hubs SDK
- Thymeleaf (Email Template)