# kenhtaymay/tinhtinh architecture

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

- Interactive diagram: https://gitdiagram.com/kenhtaymay/tinhtinh
- Repository: https://github.com/kenhtaymay/tinhtinh

## Overview

##### Project type and purpose
- This is an Android mobile application called “tinhtinh” that listens for incoming bank notifications, parses out transaction details (amount, date/time, description), and provides a custom user experience (e.g., visual confetti effects via the Konfetti libraries and presumably audio alerts).
- The README confirms it hooks into Android’s notification system (requires notification-read permission) and uses a regex in NotificationListener.kt to extract transaction data from MBBank messages.

##### File structure
- Top level:
- settings.gradle.kts & gradle/ wrapper: multi-module Gradle project
- app/: the primary Android application module
– src/main: UI (MainActivity), BroadcastReceivers (BootReceiver, NotificationListener), resources (layouts, drawables, raw MP3, XML rules)
– build.gradle.kts: module config
- app/konfetti: three library submodules under the app directory
– core/: business-logic/data structures for confetti (Particle, PartySystem, emitter configs) plus unit tests
– xml/: Android-View-based Konfetti integration
– compose/: Jetpack Compose–based Konfetti integration
- gradle/libs.versions.toml: dependency versions
- Patterns:
- Multi-module structure (app + three reusable libraries)
- Separation of concerns: core library for confetti business logic; two UI adapters (XML and Compose).

##### Key README insights
- Describes how to change the message-parsing pattern in NotificationListener.kt

##### Final advice
- Every module and resource as a separate component
- Review the end-to-end flow: from device boot → service registration → notification receipt → data extraction → UI update → confetti animation → optional audio alert

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Android Components
    subgraph "Android Components"
        OSNotif["Android OS\nNotification Service"]:::system
        BootReceiver["BroadcastReceiver\n(BootReceiver)"]:::system
        NotificationListenerService["NotificationListenerService\n(NotificationListener & Parser)"]:::system
    end

    OSNotif --> NotificationListenerService
    BootReceiver --> NotificationListenerService

    click BootReceiver "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/java/com/hs2t/tinhtinh/BootReceiver.kt"
    click NotificationListenerService "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/java/com/hs2t/tinhtinh/NotificationListener.kt"

    %% Application Module
    subgraph "App Module"
        MainActivity["MainActivity"]:::app
    end

    NotificationListenerService -->|"Parsed Data"| MainActivity
    click MainActivity "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/java/com/hs2t/tinhtinh/MainActivity.kt"

    %% Konfetti Libraries
    subgraph "Konfetti Libraries"
        Core["Konfetti Core Module"]:::library
        XMLAdapter["Konfetti XML Adapter"]:::library
        ComposeAdapter["Konfetti Compose Adapter"]:::library
    end

    MainActivity --> XMLAdapter
    MainActivity --> ComposeAdapter
    XMLAdapter --> Core
    ComposeAdapter --> Core

    click Core "https://github.com/kenhtaymay/tinhtinh/tree/main/app/konfetti/core/"
    click XMLAdapter "https://github.com/kenhtaymay/tinhtinh/tree/main/app/konfetti/xml/"
    click ComposeAdapter "https://github.com/kenhtaymay/tinhtinh/tree/main/app/konfetti/compose/"

    %% Resources
    subgraph "Resources"
        Layout["MainActivity Layout\n(activity_main.xml)"]:::resource
        Audio["Audio Alert\n(bel.mp3)"]:::resource
        BackupRules["Backup Rules\n(backup_rules.xml)"]:::resource
        DataRules["Data Extraction Rules\n(data_extraction_rules.xml)"]:::resource
        Manifest["AndroidManifest.xml"]:::resource
    end

    MainActivity --> Layout
    MainActivity --> Audio
    NotificationListenerService --> BackupRules
    NotificationListenerService --> DataRules
    subgraph dummy
        Manifest
    end

    click Layout "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/res/layout/activity_main.xml"
    click Audio "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/res/raw/bel.mp3"
    click BackupRules "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/res/xml/backup_rules.xml"
    click DataRules "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/res/xml/data_extraction_rules.xml"
    click Manifest "https://github.com/kenhtaymay/tinhtinh/blob/main/app/src/main/AndroidManifest.xml"

    %% Build & Tests
    subgraph "Build & Configuration"
        Gradle["Gradle Build System"]:::build
        Settings["settings.gradle.kts"]:::build
        ProjectBuild["build.gradle.kts"]:::build
        AppBuild["app/build.gradle.kts"]:::build
        Versions["gradle/libs.versions.toml"]:::build
    end

    Gradle --> Settings
    Gradle --> ProjectBuild
    Gradle --> AppBuild
    Gradle --> Versions

    click Settings "https://github.com/kenhtaymay/tinhtinh/blob/main/settings.gradle.kts"
    click ProjectBuild "https://github.com/kenhtaymay/tinhtinh/blob/main/build.gradle.kts"
    click AppBuild "https://github.com/kenhtaymay/tinhtinh/blob/main/app/build.gradle.kts"
    click Versions "https://github.com/kenhtaymay/tinhtinh/blob/main/gradle/libs.versions.toml"

    subgraph "Core Module Tests"
        UnitTests["PartySystemTest\n(and other tests)"]:::build
    end

    UnitTests --> Core
    click UnitTests "https://github.com/kenhtaymay/tinhtinh/blob/main/app/konfetti/core/src/test/java/nl/dionsegijn/konfetti/core/PartySystemTest.kt"

    %% Styles
    classDef system fill:#D0E6FF,stroke:#1E90FF,color:#000
    classDef app fill:#D6FFD6,stroke:#28A745,color:#000
    classDef library fill:#FFF5BA,stroke:#FFCC00,color:#000
    classDef resource fill:#E0E0E0,stroke:#A9A9A9,color:#000
    classDef build fill:#FFE6C7,stroke:#FF8C00,color:#000
```
