# vennisabarfi/culturalconnect architecture

> Architecture diagram of the GitHub repository vennisabarfi/culturalconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vennisabarfi/culturalconnect
- Repository: https://github.com/vennisabarfi/culturalconnect

## Overview

##### Main Components

A. Frontend Layer (React Application)
- As a top-level component with these sub-components:
- Page Components (Home, Events, Business, Media, Resource, Search)
- Shared Components (NavigationBar, Footer)
- Routing System (implied by the structure)
- Use Vite as the build tool (indicated by vite.config.js)

B. Backend Layer (Go Application)
- Controllers Layer (showing all distinct controllers)
- Business Controller
- Events Controller
- Home Controller
- Media Controller
- Resources Controller
- User Authentication Controller
- Database Layer (SQL Database, indicated by migrations)
- Users Table
- Resources Table
- Events Table
- Media Table
- Businesses Table

- [Client Tier (React)] → [Application Tier (Go)] → [Data Tier (SQL Database)]

##### Component Relationships

- API calls from frontend to backend controllers
- Data flow between controllers and database
- Component dependencies within frontend
- Authentication flow through the system

##### Specific Elements

A. Frontend Section:
- Main pages as individual components
- Shared components
- Build process (Vite)
- Static asset handling

B. Backend Section:
- Controllers with their responsibilities
- Middleware layers (especially auth)
- API routes structure
- Database migration system

C. Database Section:
- Tables with key relationships
- Migration management
- Data flow patterns

##### Technical Details to Highlight

- Frontend:
- React + Vite stack
- CSS modules usage
- Route management
- State management

- Backend:
- Go services architecture
- Database connectivity
- API endpoint structure
- Authentication flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        direction TB
        Entry["Frontend Entry"]:::frontend
        App["App Component"]:::frontend
        
        subgraph Pages
            direction TB
            Home["Home Page"]:::frontend
            Events["Events Page"]:::frontend
            Business["Business Page"]:::frontend
            Media["Media Page"]:::frontend
            Resource["Resource Page"]:::frontend
            Search["Search Page"]:::frontend
        end
        
        subgraph SharedComponents
            direction TB
            Nav["Navigation Bar"]:::frontend
            Footer["Footer"]:::frontend
        end
        
        BuildSystem["Vite Build System"]:::frontend
    end
    
    subgraph Backend
        direction TB
        ServerEntry["Backend Server"]:::backend
        
        subgraph Controllers
            direction TB
            BusinessCtrl["Business Controller"]:::controller
            EventsCtrl["Events Controller"]:::controller
            HomeCtrl["Home Controller"]:::controller
            MediaCtrl["Media Controller"]:::controller
            ResourcesCtrl["Resources Controller"]:::controller
            AuthCtrl["User Auth Controller"]:::controller
        end
    end
    
    subgraph Database
        direction TB
        UsersDB[(Users Table)]:::database
        ResourcesDB[(Resources Table)]:::database
        EventsDB[(Events Table)]:::database
        MediaDB[(Media Table)]:::database
        BusinessesDB[(Businesses Table)]:::database
    end
    
    %% Frontend Relationships
    Entry --> App
    App --> Pages
    App --> SharedComponents
    BuildSystem --> Entry
    
    %% Backend API Calls
    Pages --> Controllers
    Controllers --> Database
    
    %% Database Relationships
    AuthCtrl --> UsersDB
    BusinessCtrl --> BusinessesDB
    EventsCtrl --> EventsDB
    MediaCtrl --> MediaDB
    ResourcesCtrl --> ResourcesDB
    
    %% Style Definitions
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef controller fill:#27ae60,stroke:#219a52,color:white
    classDef database fill:#f1c40f,stroke:#f39c12,color:white
    
    %% Click Events
    click Entry "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/main.jsx"
    click App "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/App.jsx"
    click Home "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/homePage/Home.jsx"
    click Events "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/eventsPage/Events.jsx"
    click Business "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/businessPage/Business.jsx"
    click Media "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/mediaPage/Media.jsx"
    click Resource "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/resourcePage/Resource.jsx"
    click Search "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/searchPage/Search.jsx"
    click Nav "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/components/NavigationBar.jsx"
    click Footer "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/src/components/Footer.jsx"
    click BuildSystem "https://github.com/vennisabarfi/CulturalConnect/blob/main/frontend/vite.config.js"
    click BusinessCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/business.go"
    click EventsCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/events.go"
    click HomeCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/home.go"
    click MediaCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/media.go"
    click ResourcesCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/resources.go"
    click AuthCtrl "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/controllers/user_auth.go"
    click UsersDB "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/migrations/20240820161927_create_users_table.sql"
    click ResourcesDB "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/migrations/20240826162349_create_resources_table.sql"
    click EventsDB "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/migrations/20240828163839_create_events_table.sql"
    click MediaDB "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/migrations/20240904235823_create_media_table.sql"
    click BusinessesDB "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/migrations/20240906154456_create_businesses_table.sql"
    click ServerEntry "https://github.com/vennisabarfi/CulturalConnect/blob/main/backend/main.go"
```
