# ducshntrong/socialmediaapp architecture

> Architecture diagram of the GitHub repository ducshntrong/socialmediaapp, 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/ducshntrong/socialmediaapp
- Repository: https://github.com/ducshntrong/socialmediaapp

## Overview

##### Project type and purpose
- This is a native Android social-media client application (“Social Media App”) built in Kotlin.
- It follows a full-stack mobile architecture with UI screens (Activities & Fragments), presentation logic (ViewModels), local/remote data sources (Firebase services + on-device ML), and background services (JobScheduler).
- Core purpose: allow users to sign up/log in, create posts and stories, follow other users, chat, comment, receive notifications, take notes, and perform AI-driven NSFW/sentiment moderation on content.

##### File structure
Top-level
- build.gradle, settings.gradle, Gradle wrapper → standard Android/Gradle setup
- app/ → single Android module
app/src/main/java/com/htduc/socialmediaapplication
- Activities/Fragments → UI layer
- Adapters → RecyclerView and ViewPager adapters
- Models → data representations (User, Post, Comment, Story, etc.)
- ViewModel & ViewModelFactories → MVVM presentation layer
- Moderation → NSFWDetector (tflite model in assets), UserModerationManager
- Service → NotificationService (FCM), DeleteStoryJobService (JobScheduler)
- MyApplication.kt → application class, DI / initialization
app/src/main/assets
- nsfw1.tflite → on-device model for NSFW detection
Configuration & resources
- Firebase config (google-services.json), proguard rules, layouts, drawables, fonts, XML menus

##### README insights
- Lists features (profile, follow, story/post creation, like/comment, chat, notifications, notes)
- Dependencies: Firebase (Auth, Firestore/Realtime DB, Storage, Cloud Messaging), third-party UI and image libs, on-device ML model, scheduler
- Mentions “AI nsfw and sentiment analysis” → local ML for content moderation

##### Detail & fidelity
- Every major Activity/Fragment as a UI node
- ViewModel-Factory injection where relevant
- On-device ML asset loading under the Data layer
- Firebase services separately (Auth, DB, Storage, FCM)
- Denote periodic cleanup via JobScheduler

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        AddNoteActivity["AddNoteActivity"]:::ui
        AddPostActivity["AddPostActivity"]:::ui
        ChangePassActivity["ChangePassActivity"]:::ui
        ChatActivity["ChatActivity"]:::ui
        CommentActivity["CommentActivity"]:::ui
        LoginActivity["LoginActivity"]:::ui
        MainActivity["MainActivity"]:::ui
        MessageActivity["MessageActivity"]:::ui
        NoteActivity["NoteActivity"]:::ui
        ProfileActivity["ProfileActivity"]:::ui
        SignUpActivity["SignUpActivity"]:::ui
        UpdatePostActivity["UpdatePostActivity"]:::ui
        UpdateProfileActivity["UpdateProfileActivity"]:::ui
        subgraph "Fragments"
            direction TB
            AddPostFragment["AddPostFragment"]:::ui
            HomeFragment["HomeFragment"]:::ui
            NotificationFragment["NotificationFragment"]:::ui
            Notification2Fragment["Notification2Fragment"]:::ui
            ProfileFragment["ProfileFragment"]:::ui
            RequestFragment["RequestFragment"]:::ui
            SearchFragment["SearchFragment"]:::ui
            StoryFragment["StoryFragment"]:::ui
        end
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        ChatViewModel["ChatViewModel"]:::vm
        CommentViewModel["CommentViewModel"]:::vm
        FragmentViewModel["FragmentViewModel"]:::vm
        ProfileViewModel["ProfileViewModel"]:::vm
        ChatViewModelFactory["ChatViewModelFactory"]:::vm
        CommentViewmodelFactory["CommentViewmodelFactory"]:::vm
        FragmentViewModelFactory["FragmentViewModelFactory"]:::vm
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Models["Models (User, Post, Comment, Story, etc.)"]:::data
        Moderation["UserModerationManager/NSFWDetector"]:::data
        asset["nsfw1.tflite"]:::external
    end

    %% Background Services
    subgraph "Background Services"
        direction TB
        NotificationService["NotificationService"]:::service
        DeleteStoryJobService["DeleteStoryJobService"]:::service
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Auth["Firebase Auth"]:::external
        DB["Firestore/RealtimeDB"]:::external
        Storage["Firebase Storage"]:::external
        FCM["FCM (Cloud Messaging)"]:::external
        TFLite["TFLite Runtime"]:::external
    end

    %% Application Init & Config
    MyApplication["MyApplication"]:::service
    Manifest["AndroidManifest.xml"]:::external
    FirebaseConfig["google-services.json"]:::external

    %% Data Flows
    UI -->|"userAction"| ChatViewModel
    UI -->|"userAction"| CommentViewModel
    UI -->|"userAction"| FragmentViewModel
    UI -->|"userAction"| ProfileViewModel

    ChatViewModel -->|"calls"| Models
    CommentViewModel -->|"calls"| Models
    FragmentViewModel -->|"calls"| Models
    ProfileViewModel -->|"calls"| Models

    Models -->|"read/write"| Auth
    Models -->|"read/write"| DB
    Models -->|"read/write"| Storage

    Models -->|"moderation"| Moderation
    Moderation -->|"inference"| TFLite
    Moderation -->|"uses model"| asset

    FCM -->|"push event"| NotificationService
    NotificationService -->|"notifies"| UI

    DeleteStoryJobService -->|"cleanup"| DB

    %% Initialization links
    MyApplication -->|init| ChatViewModelFactory
    MyApplication -->|init| CommentViewmodelFactory
    MyApplication -->|init| FragmentViewModelFactory
    MyApplication -->|loadConfig| FirebaseConfig
    MyApplication -->|register| Manifest

    %% Click Events - UI Activities
    click AddNoteActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/AddNoteActivity.kt"
    click AddPostActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/AddPostActivity.kt"
    click ChangePassActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/ChangePassActivity.kt"
    click ChatActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/ChatActivity.kt"
    click CommentActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/CommentActivity.kt"
    click LoginActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/LoginActivity.kt"
    click MainActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/MainActivity.kt"
    click MessageActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/MessageActivity.kt"
    click NoteActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/NoteActivity.kt"
    click ProfileActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/ProfileActivity.kt"
    click SignUpActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/SignUpActivity.kt"
    click UpdatePostActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/UpdatePostActivity.kt"
    click UpdateProfileActivity "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Activities/UpdateProfileActivity.kt"

    %% Click Events - Fragments
    click AddPostFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/AddPostFragment.kt"
    click HomeFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/HomeFragment.kt"
    click NotificationFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/NotificationFragment.kt"
    click Notification2Fragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/Notification2Fragment.kt"
    click ProfileFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/ProfileFragment.kt"
    click RequestFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/RequestFragment.kt"
    click SearchFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/SearchFragment.kt"
    click StoryFragment "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Fragments/StoryFragment.kt"

    %% Click Events - ViewModels & Factories
    click ChatViewModel "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewModel/ChatViewModel.kt"
    click CommentViewModel "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewModel/CommentViewModel.kt"
    click FragmentViewModel "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewModel/FragmentViewModel.kt"
    click ProfileViewModel "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewModel/ProfileViewModel.kt"
    click ChatViewModelFactory "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewmodelFactories/ChatViewModelFactory.kt"
    click CommentViewmodelFactory "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewmodelFactories/CommentViewmodelFactory.kt"
    click FragmentViewModelFactory "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/ViewmodelFactories/FragmentViewModelFactory.kt"

    %% Click Events - Moderation & ML
    click NSFWDetector "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Moderation/NSFWDetector.kt"
    click UserModerationManager "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Moderation/UserModerationManager.kt"
    click asset "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/assets/nsfw1.tflite"

    %% Click Events - Services & App Init
    click NotificationService "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Service/NotificationService.kt"
    click DeleteStoryJobService "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/Service/DeleteStoryJobService.kt"
    click MyApplication "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/java/com/htduc/socialmediaapplication/MyApplication.kt"
    click FirebaseConfig "https://github.com/ducshntrong/socialmediaapp/blob/main/app/google-services.json"
    click Manifest "https://github.com/ducshntrong/socialmediaapp/blob/main/app/src/main/AndroidManifest.xml"

    %% Styles
    classDef ui fill:#ffa500,stroke:#333,stroke-width:1px;
    classDef vm fill:#87CEFA,stroke:#333,stroke-width:1px;
    classDef data fill:#dda0dd,stroke:#333,stroke-width:1px;
    classDef service fill:#98fb98,stroke:#333,stroke-width:1px;
    classDef external fill:#f0e68c,stroke:#333,stroke-width:1px;
```
