# ablink4/personaljournal architecture

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

- Interactive diagram: https://gitdiagram.com/ablink4/personaljournal
- Repository: https://github.com/ablink4/personaljournal

## Overview

##### Project Type Analysis
This is a desktop application built with Electron, featuring a SQLite database for local storage. It's a standalone application with a GUI interface and local data persistence.

##### Main Components

A. User Interface Layer:
- Main Window (index.html)
- Browse Window (browse.html)
- Search Window (search.html)
- Styling (style.css)

B. Application Logic:
- Main Process (main.js)
- Renderer Processes:
- app.js (main window logic)
- browse.js (browse functionality)
- search.js (search functionality)

C. Data Layer:
- SQLite Database
- Local File System (for database storage)

**[UI Layer]**
- ↕
**[Application Logic]**
- ↕
**[Data Layer]**

##### Specific Elements

**[Electron Runtime Environment]**

- [Main Process (main.js)]

- [Window Management]
- [IPC Handlers]
- [Database Connection]

- [Renderer Processes]

- [Main Window]
- [Entry Editor]
- [Navigation Controls]

- [Browse Window]
- [Entry List View]

- [Search Window]
- [Search Results]

##### Important Flows to Highlight

a) Entry Creation Flow:
**User Input → Main Window → IPC → Main Process → SQLite → Confirmation**

b) Browse Flow:
**Browse Request → Browse Window → IPC → Main Process → SQLite → Entry List → Display**

c) Search Flow:
**Search Query → Search Window → IPC → Main Process → SQLite → Results → Display**

##### Technical Details

- Electron's main and renderer process separation
- SQLite database connections and operations
- HTML/CSS/JavaScript frontend components
- IPC communication channels
- File system interactions for database storage

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Electron["Electron Runtime Environment"]
        direction TB
        MainProc["Main Process"]:::process
        click MainProc "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/main.js"
        
        subgraph UI["User Interface Layer"]
            direction TB
            MainWin["Main Window"]:::ui
            click MainWin "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/index.html"
            BrowseWin["Browse Window"]:::ui
            click BrowseWin "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/browse.html"
            SearchWin["Search Window"]:::ui
            click SearchWin "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/search.html"
            Styling["UI Styling"]:::ui
            click Styling "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/style.css"
        end

        subgraph Logic["Application Logic"]
            direction TB
            AppLogic["Main Window Logic"]:::logic
            click AppLogic "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/app.js"
            BrowseLogic["Browse Logic"]:::logic
            click BrowseLogic "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/browse.js"
            SearchLogic["Search Logic"]:::logic
            click SearchLogic "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/resources/app/search.js"
        end

        subgraph Data["Data Layer"]
            direction TB
            DB[(SQLite Database)]:::storage
            FS["Local File System"]:::storage
        end

        subgraph Support["Support Components"]
            direction TB
            Locales["Localization"]:::support
            click Locales "https://github.com/ablink4/PersonalJournal/tree/master/PersonalJournal-win32-x64/locales/"
            Resources["Resources"]:::support
            click Resources "https://github.com/ablink4/PersonalJournal/tree/master/PersonalJournal-win32-x64/resources/"
            Entry["Application Entry"]:::support
            click Entry "https://github.com/ablink4/PersonalJournal/blob/master/PersonalJournal-win32-x64/PersonalJournal.exe"
        end
    end

    %% Connections
    MainProc <--> AppLogic
    MainProc <--> BrowseLogic
    MainProc <--> SearchLogic
    
    AppLogic <--> MainWin
    BrowseLogic <--> BrowseWin
    SearchLogic <--> SearchWin
    
    Styling --> MainWin
    Styling --> BrowseWin
    Styling --> SearchWin
    
    MainProc <--> DB
    DB --- FS
    
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef logic fill:#2ecc71,stroke:#27ae60,color:white
    classDef storage fill:#f1c40f,stroke:#f39c12,color:black
    classDef process fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef support fill:#e74c3c,stroke:#c0392b,color:white

    %% Legend
    subgraph Legend
        direction TB
        UI_L["UI Component"]:::ui
        Logic_L["Logic Component"]:::logic
        Storage_L["Storage Component"]:::storage
        Process_L["Process Component"]:::process
        Support_L["Support Component"]:::support
    end
```
