# santhoshswamyv/finacledevassist architecture

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

- Interactive diagram: https://gitdiagram.com/santhoshswamyv/finacledevassist
- Repository: https://github.com/santhoshswamyv/finacledevassist

## Overview

FinacleDevAssist is a Notepad++ plugin whose main workflow sends user actions through a C++ worker and local Java backend: validate scripts and show line-linked issues, beautify code, fetch autocomplete tokens, or explicitly send FI requests. The README also lists custom-menu generation and source deployment, though those are described as upcoming; their handlers appear in the runtime task dispatch. Links between sampled modules follow indexed references or shown calls; Java validation internals and some UI wiring are unsampled, so uncertain links are omitted.

Main entry points: [`cpp/src/Threading/Worker.cpp`](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Threading/Worker.cpp) (Task worker), [`cpp/src/Communication/FDAClient.cpp`](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/FDAClient.cpp) (Local socket client), [`java/src/com/sandy/fda/socket/FDASocket.java`](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/socket/FDASocket.java) (JSON request dispatch), [`cpp/src/Communication/Handlers/ValidationHandler.cpp`](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/ValidationHandler.cpp) (Validation handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Notepad++ Plugin"]
  node_commands["Plugin commands<br/>[PluginDefinition.h]"]
  node_worker["Task worker<br/>[Worker.cpp]"]
  node_socket["Local socket client<br/>[FDAClient.cpp]"]
  node_validation_ui["Validation handler"]
  node_panel["Dockable issue panel"]
  node_autocomplete["Autocomplete"]
  node_beautify_handler["Beautify handler"]
  node_fi_handler["FI request handler"]
  node_menu_handler["Menu task handler"]
  node_deploy_handler["Deployment handler"]
  node_config["Plugin configuration<br/>[FDAConfig.cpp]"]
  node_tokens_store[("Token store<br/>[TokenStore.cpp]")]
end

subgraph group_backend["Java Backend"]
  node_java["Java backend"]
  node_dispatch["JSON request dispatch<br/>[FDASocket.java]"]
end

subgraph group_validation["Script Validation"]
  node_validator["Script validator"]
  node_parser["Script parser<br/>[ScriptParser.java]"]
  node_syntax["Syntax rules"]
end

subgraph group_assistance["Code Assistance"]
  node_tokens["Token parser<br/>[TokenParser.java]"]
  node_beautifier["Code beautifier<br/>[Beautifier.java]"]
end

subgraph group_finacle["Finacle Operations"]
  node_fi_service["FI execution"]
  node_menu_service["Menu generation"]
  node_templates["Menu templates"]
  node_sftp["SFTP transfer<br/>[SFTPHandler.java]"]
end

node_user(("Plugin user"))
node_npp["Notepad++"]
node_fi_http["Finacle HTTP endpoint"]
node_remote["Finacle environment"]

node_user -->|"uses"| node_npp
node_npp -->|"invokes"| node_commands
node_commands -.->|"submits tasks"| node_worker
node_worker -->|"dispatches requests"| node_socket
node_worker -->|"starts process"| node_java
node_socket -->|"sends JSON"| node_dispatch
node_dispatch -->|"routes validation"| node_validator
node_validator -->|"parses script"| node_parser
node_validator -->|"checks syntax"| node_syntax
node_worker -->|"dispatches validation"| node_validation_ui
node_validation_ui -->|"requests validation"| node_socket
node_validation_ui -->|"shows issues"| node_panel
node_panel -->|"jumps to line"| node_npp
node_dispatch -->|"routes token query"| node_tokens
node_tokens -.->|"provides keywords"| node_autocomplete
node_worker -->|"loads suggestions"| node_autocomplete
node_worker -->|"dispatches formatting"| node_beautify_handler
node_beautify_handler -->|"requests formatting"| node_socket
node_dispatch -->|"routes formatting"| node_beautifier
node_worker -->|"dispatches FI task"| node_fi_handler
node_fi_handler -->|"sends FI request"| node_socket
node_dispatch -->|"routes FI request"| node_fi_service
node_fi_service -->|"sends HTTP request"| node_fi_http
node_worker -->|"dispatches generation"| node_menu_handler
node_menu_handler -.->|"requests generation"| node_socket
node_dispatch -->|"routes menu task"| node_menu_service
node_menu_service -->|"renders templates"| node_templates
node_worker -->|"dispatches deployment"| node_deploy_handler
node_deploy_handler -.->|"requests deployment"| node_socket
node_menu_service -->|"transfers files"| node_sftp
node_sftp -->|"uploads files"| node_remote
node_worker -->|"loads settings"| node_config
node_autocomplete -->|"reads tokens"| node_tokens_store

click node_commands "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/PluginDefinition.h"
click node_worker "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Threading/Worker.cpp"
click node_socket "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/FDAClient.cpp"
click node_java "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/FinacleDevAssist.java"
click node_dispatch "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/socket/FDASocket.java"
click node_validator "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/validator/ScriptValidator.java"
click node_parser "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/parser/ScriptParser.java"
click node_syntax "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/validator/core/SyntaxValidator.java"
click node_validation_ui "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/ValidationHandler.cpp"
click node_panel "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/DockingFeature/ValidationPanel.cpp"
click node_tokens "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/parser/TokenParser.java"
click node_autocomplete "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Features/AutoCompleteManager.cpp"
click node_beautify_handler "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/CodeBeautifierHandler.cpp"
click node_beautifier "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/beautifier/Beautifier.java"
click node_fi_handler "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/FIExecutionHandler.cpp"
click node_fi_service "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/fi/FinacleInterfaceHandler.java"
click node_menu_handler "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/GenerateCustomMenuHandler.cpp"
click node_menu_service "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/Custom24Handler.java"
click node_templates "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/TemplateService.java"
click node_deploy_handler "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/DeploySourceHandler.cpp"
click node_sftp "https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/SFTPHandler.java"
click node_config "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Configuration/FDAConfig.cpp"
click node_tokens_store "https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Core/TokenStore.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_commands,node_worker,node_socket,node_validation_ui,node_panel,node_autocomplete,node_beautify_handler,node_fi_handler,node_menu_handler,node_deploy_handler,node_config,node_tokens_store,node_user toneBlue
class node_java,node_dispatch toneAmber
class node_validator,node_parser,node_syntax toneMint
class node_tokens,node_beautifier toneRose
class node_fi_service,node_menu_service,node_templates,node_sftp,node_npp,node_fi_http,node_remote toneIndigo
```

## Components

### Notepad++ Plugin

- [Plugin commands](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/PluginDefinition.h): `cpp/src/PluginDefinition.h`
- [Task worker](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Threading/Worker.cpp): `cpp/src/Threading/Worker.cpp`
- [Local socket client](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/FDAClient.cpp): `cpp/src/Communication/FDAClient.cpp`
- [Validation handler](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/ValidationHandler.cpp): `cpp/src/Communication/Handlers/ValidationHandler.cpp`
- [Dockable issue panel](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/DockingFeature/ValidationPanel.cpp): `cpp/src/DockingFeature/ValidationPanel.cpp`
- [Autocomplete](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Features/AutoCompleteManager.cpp): `cpp/src/Features/AutoCompleteManager.cpp`
- [Beautify handler](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/CodeBeautifierHandler.cpp): `cpp/src/Communication/Handlers/CodeBeautifierHandler.cpp`
- [FI request handler](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/FIExecutionHandler.cpp): `cpp/src/Communication/Handlers/FIExecutionHandler.cpp`
- [Menu task handler](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/GenerateCustomMenuHandler.cpp): `cpp/src/Communication/Handlers/GenerateCustomMenuHandler.cpp`
- [Deployment handler](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Communication/Handlers/DeploySourceHandler.cpp): `cpp/src/Communication/Handlers/DeploySourceHandler.cpp`
- [Plugin configuration](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Configuration/FDAConfig.cpp): `cpp/src/Configuration/FDAConfig.cpp`
- [Token store](https://github.com/santhoshswamyv/finacledevassist/blob/main/cpp/src/Core/TokenStore.cpp): `cpp/src/Core/TokenStore.cpp`

### Java Backend

- [Java backend](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/FinacleDevAssist.java): `java/src/com/sandy/fda/FinacleDevAssist.java`
- [JSON request dispatch](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/socket/FDASocket.java): `java/src/com/sandy/fda/socket/FDASocket.java`

### Script Validation

- [Script validator](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/validator/ScriptValidator.java): `java/src/com/sandy/fda/validator/ScriptValidator.java`
- [Script parser](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/parser/ScriptParser.java): `java/src/com/sandy/fda/parser/ScriptParser.java`
- [Syntax rules](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/validator/core/SyntaxValidator.java): `java/src/com/sandy/fda/validator/core/SyntaxValidator.java`

### Code Assistance

- [Token parser](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/parser/TokenParser.java): `java/src/com/sandy/fda/parser/TokenParser.java`
- [Code beautifier](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/beautifier/Beautifier.java): `java/src/com/sandy/fda/beautifier/Beautifier.java`

### Finacle Operations

- [FI execution](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/fi/FinacleInterfaceHandler.java): `java/src/com/sandy/fda/fi/FinacleInterfaceHandler.java`
- [Menu generation](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/Custom24Handler.java): `java/src/com/sandy/fda/custom24/Custom24Handler.java`
- [Menu templates](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/TemplateService.java): `java/src/com/sandy/fda/custom24/TemplateService.java`
- [SFTP transfer](https://github.com/santhoshswamyv/finacledevassist/blob/main/java/src/com/sandy/fda/custom24/SFTPHandler.java): `java/src/com/sandy/fda/custom24/SFTPHandler.java`

### Other components

- **Plugin user**
- **Notepad++**
- **Finacle HTTP endpoint**
- **Finacle environment**

## Connections

- Plugin user → Notepad++: uses (evidence: `README.md`)
- Notepad++ → Plugin commands: invokes (evidence: `README.md`)
- Plugin commands → Task worker: submits tasks
- Task worker → Local socket client: dispatches requests (evidence: `cpp/src/Threading/Worker.cpp`)
- Task worker → Java backend: starts process (evidence: `cpp/src/Threading/Worker.cpp`)
- Local socket client → JSON request dispatch: sends JSON (evidence: `README.md`)
- JSON request dispatch → Script validator: routes validation (evidence: `java/src/com/sandy/fda/socket/FDASocket.java`)
- Script validator → Script parser: parses script (evidence: `java/src/com/sandy/fda/parser/ScriptParser.java`)
- Script validator → Syntax rules: checks syntax
- Task worker → Validation handler: dispatches validation (evidence: `cpp/src/Threading/Worker.cpp`)
- Validation handler → Local socket client: requests validation (evidence: `cpp/src/Communication/Handlers/ValidationHandler.cpp`)
- Validation handler → Dockable issue panel: shows issues (evidence: `cpp/src/Communication/Handlers/ValidationHandler.cpp`)
- Dockable issue panel → Notepad++: jumps to line (evidence: `README.md`)
- JSON request dispatch → Token parser: routes token query (evidence: `java/src/com/sandy/fda/socket/FDASocket.java`)
- Token parser → Autocomplete: provides keywords
- Task worker → Autocomplete: loads suggestions (evidence: `cpp/src/Features/AutoCompleteManager.cpp`)
- Task worker → Beautify handler: dispatches formatting (evidence: `cpp/src/Threading/Worker.cpp`)
- Beautify handler → Local socket client: requests formatting (evidence: `cpp/src/Communication/Handlers/CodeBeautifierHandler.cpp`)
- JSON request dispatch → Code beautifier: routes formatting (evidence: `java/src/com/sandy/fda/socket/FDASocket.java`)
- Task worker → FI request handler: dispatches FI task (evidence: `cpp/src/Threading/Worker.cpp`)
- FI request handler → Local socket client: sends FI request (evidence: `cpp/src/Communication/Handlers/FIExecutionHandler.cpp`)
- JSON request dispatch → FI execution: routes FI request (evidence: `java/src/com/sandy/fda/socket/FDASocket.java`)
- FI execution → Finacle HTTP endpoint: sends HTTP request
- Task worker → Menu task handler: dispatches generation (evidence: `cpp/src/Threading/Worker.cpp`)
- Menu task handler → Local socket client: requests generation
- JSON request dispatch → Menu generation: routes menu task (evidence: `java/src/com/sandy/fda/socket/FDASocket.java`)
- Menu generation → Menu templates: renders templates (evidence: `java/src/com/sandy/fda/custom24/Custom24Handler.java`)
- Task worker → Deployment handler: dispatches deployment (evidence: `cpp/src/Threading/Worker.cpp`)
- Deployment handler → Local socket client: requests deployment
- Menu generation → SFTP transfer: transfers files (evidence: `java/src/com/sandy/fda/custom24/Custom24Handler.java`)
- SFTP transfer → Finacle environment: uploads files
- Task worker → Plugin configuration: loads settings (evidence: `cpp/src/Threading/Worker.cpp`)
- Autocomplete → Token store: reads tokens (evidence: `cpp/src/Features/AutoCompleteManager.cpp`)
