# hellochihai/quangbadulichvietnam_dart_flutter architecture

> Architecture diagram of the GitHub repository hellochihai/quangbadulichvietnam_dart_flutter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hellochihai/quangbadulichvietnam_dart_flutter
- Repository: https://github.com/hellochihai/quangbadulichvietnam_dart_flutter

## Overview

##### Project Type and Purpose
- This is a three‐tier full-stack application:
- Backend “Server” (Node.js + Express + Mongoose)
- Admin Flutter app (multi-platform UI for administrators)
- User Flutter app (multi-platform UI for end users)
- Purpose: Promote Vietnamese tourism by serving media-rich content (videos, images), enabling user actions (search/filter, comments, favorites) and admin CRUD operations.

##### File Structure
- Top level: README.md, Server/, SourceCode/, data/
- Server/
- server.js – Express entry point
- models/*.js – Mongoose schemas for Admin, Customer, Province, Region
- package.json – Node dependencies (express, mongoose, cors, etc.)
- SourceCode/Admin/appadminquangbadulich/ and SourceCode/User/userappquanbadulich/
- Standard Flutter project structure: lib/, android/, ios/, web/, linux/, macos/, windows/
- lib/ organized by features, each using the BLoC pattern (bloc/, screens/, widgets/)
- pubspec.yaml – Flutter dependencies (flutter_bloc, http, video_player, youtube_player_flutter, etc.)
- data/ contains JSON files for seeding or testing.

##### Extract Insights from README
- Architecture:
- Frontends communicate via HTTP REST to Server
- State management in frontends via flutter_bloc (MultiBlocProvider)
- Tech stack:
- Backend: Node.js, Express, MongoDB
- Frontend: Dart/Flutter, flutter_bloc, http, video_player, youtube_player_flutter
- Key features: CRUD for comments/accounts, media playback, search/filter, favorites.

##### Main Components
a. Frontend Tier
- Admin Flutter App
- UI Screens (login, home, add/edit/delete attractions, user management)
- BLoC Modules per feature (e.g., addTouristAttraction_bloc)
- User Flutter App
- UI Screens (login/signup, home, detail pages, favorites, comments)
- BLoC Modules per feature (e.g., comment_bloc, touristAttraction_bloc)
b. Backend Tier
- Express Server
- API Controllers/Routes (e.g., /admin, /customer, /province, /region, /touristAttraction)
- Models (Mongoose schemas)
- Services (database access, business logic)
c. Data Tier
- MongoDB database (collections: admins, customers, provinces, regions, comments, attractions, history, culture, specialDishes)
d. External Services
- YouTube Data/API (via youtube_player_flutter)
- Video playback library in app (video_player)

##### Relationships and Interactions
- Admin/User Apps → HTTP(S) REST calls → Express Server → MongoDB
- BLoC Modules emit Events → UI updates on State changes
- Server uses Mongoose ORM to map schema → database collections
- External video content played via Flutter plugins (no extra server calls)

##### Architectural Patterns and Design Principles
- Three-tier architecture: presentation (Flutter), API (Express), persistence (MongoDB)
- Frontend: BLoC (Business Logic Component) pattern to separate UI from state & logic
- Backend: MVC-like separation (Routes → Controllers/Services → Models)
- RESTful API design: clear resource endpoints, HTTP verbs
- Configuration files: package.json, pubspec.yaml, build.gradle, etc. for build/deploy

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Tier
    subgraph "Frontend Tier"
        direction TB
        subgraph "Admin Flutter App\n(Dart/Flutter)" 
            direction TB
            AdminUI["UI Screens"]:::frontend
            AdminBloc["BLoC Modules"]:::frontend
            AdminUI --> AdminBloc
        end
        subgraph "User Flutter App\n(Dart/Flutter)"
            direction TB
            UserUI["UI Screens"]:::frontend
            UserBloc["BLoC Modules"]:::frontend
            UserUI --> UserBloc
        end
    end

    %% Backend Tier
    subgraph "Backend Tier"
        direction TB
        ExpressServer["Express API Server\n(Node.js, Express)"]:::api
        subgraph "Models & Services"
            direction TB
            AdminModel["Admin Schema"]:::api
            CustomerModel["Customer Schema"]:::api
            ProvinceModel["Province Schema"]:::api
            RegionModel["Region Schema"]:::api
        end
        ExpressServer -->|"uses"| AdminModel
        ExpressServer -->|"uses"| CustomerModel
        ExpressServer -->|"uses"| ProvinceModel
        ExpressServer -->|"uses"| RegionModel
    end

    %% Data Tier
    subgraph "Data Tier"
        direction TB
        MongoDB["MongoDB\n(Collections)"]:::db
        subgraph "Seed/Test Data"
            direction TB
            AdminData["DACN_APP_DuLich.Admin.json"]:::db
            CustomerData["DACN_APP_DuLich.Customer.json"]:::db
            ProvinceData["DACN_APP_DuLich.Province.json"]:::db
            RegionData["DACN_APP_DuLich.Region.json"]:::db
        end
        ExpressServer -->|"Mongoose CRUD"| MongoDB
        AdminData -->|seed| MongoDB
        CustomerData -->|seed| MongoDB
        ProvinceData -->|seed| MongoDB
        RegionData -->|seed| MongoDB
    end

    %% External Services
    ExternalMedia["External Media API\n(YouTube)"]:::external

    %% Connections
    AdminBloc -->|"HTTP REST"| ExpressServer
    UserBloc -->|"HTTP REST"| ExpressServer
    AdminUI -->|"YouTube API / video_player"| ExternalMedia
    UserUI -->|"YouTube API / video_player"| ExternalMedia

    %% Click Events - Backend
    click ExpressServer "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/Server/server.js"
    click AdminModel "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/Server/models/admin.js"
    click CustomerModel "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/Server/models/customer.js"
    click ProvinceModel "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/Server/models/province.js"
    click RegionModel "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/Server/models/region.js"
    click AdminData "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/data/DACN_APP_DuLich.Admin.json"
    click CustomerData "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/data/DACN_APP_DuLich.Customer.json"
    click ProvinceData "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/data/DACN_APP_DuLich.Province.json"
    click RegionData "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/data/DACN_APP_DuLich.Region.json"

    %% Click Events - Admin App
    click AdminUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/tree/master/SourceCode/Admin/appadminquangbadulich"
    click AdminBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/addTouristAttraction/bloc/addTouristAttraction_bloc.dart"
    click AdminBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/comment/bloc/comment_bloc.dart"
    click AdminBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/touristAttraction/bloc/touristAttraction_bloc.dart"
    click AdminUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/addTouristAttraction/screens/addTouristAttraction_page.dart"
    click AdminUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/comment/screens/comment_page.dart"
    click AdminUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/homeAdmin/screens/homeAdmin_page.dart"
    click AdminBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/repositories/adminRepository.dart"
    click AdminUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/Admin/appadminquangbadulich/lib/model/touristAttractionModel.dart"

    %% Click Events - User App
    click UserUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/tree/master/SourceCode/User/userappquanbadulich"
    click UserBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/comment/bloc/comment_bloc.dart"
    click UserBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/addTouristAttractionToFavoritesList/bloc/addTouristToList_bloc.dart"
    click UserBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/touristAttraction/bloc/touristAttraction_bloc.dart"
    click UserUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/comment/screens/comment_page.dart"
    click UserUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/listFavoriteTouristAttraction/screens/listFavoriteTouristAttraction_page.dart"
    click UserUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/home/screens/home_page.dart"
    click UserBloc "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/repositories/repositories.dart"
    click UserUI "https://github.com/hellochihai/quangbadulichvietnam_dart_flutter/blob/master/SourceCode/User/userappquanbadulich/lib/model/touristAttractionModel.dart"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#333,stroke-width:1px;
    classDef api fill:#D0FFD0,stroke:#333,stroke-width:1px;
    classDef db fill:#FFDDA0,stroke:#333,stroke-width:1px;
    classDef external fill:#EEEEEE,stroke:#333,stroke-width:1px;
```
