# argha-sarkar-2006/projects architecture

> Architecture diagram of the GitHub repository argha-sarkar-2006/projects, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/argha-sarkar-2006/projects
- Repository: https://github.com/argha-sarkar-2006/projects

## Overview

##### Project type and purpose
- From the README, this is a standalone folder-organization tool (“Programme”) whose job is to scan a target directory, categorize its files (e.g. by extension or user rules), rename them according to a scheme, and move them into a clean, well-structured folder layout.
- Although the file tree currently shows only HTML pages (likely leftover portfolio files), the core functionality described is a CLI or script-based file sorter.

##### (implied) file structure
- Top-level entry point (e.g. `main.py`, `index.js`, or similar CLI script).
- A configuration module or file (e.g. `config.yaml` or JSON) that lists category rules (mapping extensions → target folders or renaming patterns).
- Core service modules:
- Scanner: walks the filesystem, lists files.
- Categorizer (Rule Engine): applies extension‐to‐category or pattern‐matching logic.
- Renamer: computes new filenames based on timestamp, category, user pattern.
- Mover (Folder Manager): creates target folders if missing, moves/renames files.
- Utility modules: logging, error‐handling, CLI argument parser, unit tests.

##### README for additional insights
- Describes sorting and renaming rules, “clean folder” creation.
- No mention of a GUI; therefore treat as a console tool that integrates with the host OS filesystem API.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interface
    subgraph "User Interface"
        CLI["CLI Interface"]:::core
    end

    %% Configuration
    subgraph "Configuration & Plugins"
        DB[(Config Store)]:::config
        ConfigMgr["Configuration Manager"]:::config
    end

    %% Core Pipeline
    subgraph "Core Pipeline"
        Scanner["File Scanner Service"]:::core
        RuleEngine["Rule Engine"]:::core
        PluginHook["Plugin Hook"]:::config
        Renamer["File Renamer Service"]:::core
        Mover["Folder Manager"]:::core
    end

    %% Utilities
    subgraph "Utilities"
        Logger["Logger / Error Handler"]:::util
    end

    %% External Systems
    subgraph "External System"
        OS["OS File System API"]:::external
    end

    %% Documentation
    Documentation["Documentation / Overview"]:::util

    %% Flow
    CLI -->|"load rules"| ConfigMgr
    ConfigMgr --> DB
    CLI -->|"start scan"| Scanner
    Scanner -->|"file list"| RuleEngine
    RuleEngine --> PluginHook
    PluginHook --> RuleEngine
    RuleEngine -->|"category"| Renamer
    Renamer -->|"new filename"| Mover
    Mover -->|"move/rename"| OS
    Scanner --> Logger
    RuleEngine --> Logger
    Renamer --> Logger
    Mover --> Logger
    CLI -->|"summary report"| Logger
    CLI -->|"view docs"| Documentation

    %% Click Events
    click Documentation "https://github.com/argha-sarkar-2006/projects/blob/main/README.md"

    %% Styles
    classDef core fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef config fill:#90EE90,stroke:#333,stroke-width:1px
    classDef util fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef external fill:#FFFF99,stroke:#333,stroke-width:1px
```
