# heejin-hwang/mobile-wedding-invitation architecture

> Architecture diagram of the GitHub repository heejin-hwang/mobile-wedding-invitation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/heejin-hwang/mobile-wedding-invitation
- Repository: https://github.com/heejin-hwang/mobile-wedding-invitation

## Overview

##### Main Components

A. Frontend Layer (Core Application)
- React/TypeScript Application (built with Vite)
- Component Structure
- Layout Management
- Asset Management

B. External Services Integration
- Firebase Integration (Optional)
- Naver Maps API
- Payment Integration (Kakao Pay/Toss)

C. State Management & Data Flow
- Local Data (data.json)
- Firebase Real-time Database (for likes and guestbook)

**[Frontend Application]**

- [Core Components]
- Button Components
- Text Components
- Wrapper Components

- [Layout Sections]
- Main Section
- Gallery Section
- Location Section
- Guestbook Section
- Account Section
- Contact Section

- [External Services]
- Firebase
- Authentication
- Real-time Database

- Naver Maps API

- Payment Integration
- Kakao Pay
- Toss

- [Asset Management]
- Images

##### Important Elements to Highlight

A. Component Architecture:
- Hierarchy from Container.tsx down to individual components
- Modular layout structure (Account, Contact, Gallery, etc.)

B. Integration Points:
- Firebase connection for guestbook and likes functionality
- Naver Maps integration in the Location section
- Payment service integration points

C. Data Flow:
- How data.json feeds into various components
- Firebase real-time updates
- Demonstrate user interaction flows

##### Implementation Notes

- Clear labels for all components and flows
- Version information for major dependencies

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend Application"
        App["App"]:::core
        Main["Main Entry"]:::core
        EnvConfig["Environment Config"]:::config
    end

    subgraph "Core Components"
        Button["Button Components"]:::component
        Text["Text Components"]:::component
        Wrapper["Wrapper Components"]:::component
        Accordion["Accordion"]:::component
    end

    subgraph "Layout Sections"
        Container["Main Container"]:::layout
        MainSection["Main Section"]:::layout
        GallerySection["Gallery Section"]:::layout
        LocationSection["Location Section"]:::layout
        GuestbookSection["Guestbook Section"]:::layout
        AccountSection["Account Section"]:::layout
        ContactSection["Contact Section"]:::layout
        FloatingBar["Floating Navigation"]:::layout
    end

    subgraph "External Services"
        Firebase["Firebase"]:::external
        NaverMaps["Naver Maps"]:::external
        subgraph "Payment Integration"
            KakaoPay["Kakao Pay"]:::external
            Toss["Toss"]:::external
        end
    end

    subgraph "Data Management"
        LocalData["Local Data Store"]:::data
        TypeDefs["Type Definitions"]:::data
        GuestbookForm["Guestbook Form"]:::component
    end

    subgraph "Asset Management"
        Icons["Icons"]:::asset
        Images["Images"]:::asset
        GalleryImages["Gallery Images"]:::asset
    end

    subgraph "Build Configuration"
        ViteConfig["Vite Config"]:::config
        TSConfig["TypeScript Config"]:::config
        PackageJSON["Package.json"]:::config
    end

    %% Relationships
    App --> Container
    Container --> MainSection
    Container --> GallerySection
    Container --> LocationSection
    Container --> GuestbookSection
    Container --> AccountSection
    Container --> ContactSection
    Container --> FloatingBar

    LocationSection --> NaverMaps
    GuestbookSection --> Firebase
    GuestbookSection --> GuestbookForm
    AccountSection --> KakaoPay
    AccountSection --> Toss

    MainSection --> LocalData
    GallerySection --> GalleryImages
    
    %% Click Events
    click App "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/App.tsx"
    click Main "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/main.tsx"
    click EnvConfig "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/.env.sample"
    click Button "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/components/Button.tsx"
    click Text "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/components/Text.tsx"
    click Wrapper "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/components/Wrapper.tsx"
    click Accordion "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/components/Accordion.tsx"
    click Container "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Container.tsx"
    click MainSection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Main/Main.tsx"
    click GallerySection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Gallery/PhotoGallery.tsx"
    click LocationSection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Location/Location.tsx"
    click GuestbookSection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Guestbook/Guestbook.tsx"
    click AccountSection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Account/Account.tsx"
    click ContactSection "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Contact/Host.tsx"
    click Firebase "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/firebase.ts"
    click NaverMaps "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Location/Map.tsx"
    click LocalData "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/data.json"
    click TypeDefs "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/types/data.ts"
    click GuestbookForm "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Guestbook/CommentForm.tsx"
    click Icons "https://github.com/heejin-hwang/mobile-wedding-invitation/tree/main/src/assets/icons"
    click Images "https://github.com/heejin-hwang/mobile-wedding-invitation/tree/main/src/assets/images"
    click GalleryImages "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/Gallery/Images.ts"
    click FloatingBar "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/src/layout/FloatingBar/FloatingBar.tsx"
    click ViteConfig "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/vite.config.ts"
    click TSConfig "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/tsconfig.json"
    click PackageJSON "https://github.com/heejin-hwang/mobile-wedding-invitation/blob/main/package.json"

    %% Styling
    classDef core fill:#2196F3,stroke:#1565C0,color:white
    classDef component fill:#42A5F5,stroke:#1E88E5,color:white
    classDef layout fill:#9C27B0,stroke:#7B1FA2,color:white
    classDef external fill:#4CAF50,stroke:#388E3C,color:white
    classDef data fill:#FF9800,stroke:#F57C00,color:white
    classDef asset fill:#9E9E9E,stroke:#757575,color:white
    classDef config fill:#607D8B,stroke:#455A64,color:white
```
