# dkbholusaria/aaydoccapio architecture

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

- Interactive diagram: https://gitdiagram.com/dkbholusaria/aaydoccapio
- Repository: https://github.com/dkbholusaria/aaydoccapio

## Overview

AayDocCapio is a PyQt6 desktop tool for tax practitioners managing multiple clients. The main workflow is to select clients and tax years, authenticate to the Income Tax Department portal, download or generate documents, track outcomes, and optionally email documents to clients. The graph combines README-described capabilities with relationships visible in excerpts and the SOURCE INDEX; several implementation details are unsampled, so their internal links are omitted.

Main entry points: [`app.py`](https://github.com/dkbholusaria/aaydoccapio/blob/main/app.py) (Desktop App), [`automation/batch_handlers.py`](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/batch_handlers.py) (Batch Dispatch), [`automation/downloader_challans.py`](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_challans.py) (Challan Downloads), [`automation/challan_generator.py`](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/challan_generator.py) (Challan Generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client Workflow"]
  node_app["Desktop App<br/>[app.py]"]
  node_dialogs["Workflow Dialogs<br/>[dialogs.py]"]
  node_batch["Batch Dispatch<br/>[batch_handlers.py]"]
  node_themes["Theme System<br/>[themes.py]"]
end

subgraph group_portal["Portal Documents"]
  node_browser["Browser Session<br/>[browser.py]"]
  node_auth["Portal Authentication<br/>[auth.py]"]
  node_downloader["Portal Navigation<br/>[downloader.py]"]
  node_download26["26AS and 168<br/>[downloader_26as.py]"]
  node_downloadais["AIS and TIS"]
  node_downloadreturns["Filed Returns"]
  node_downloadchallans["Challan Downloads"]
end

subgraph group_processing["Document Processing"]
  node_challangen["Challan Generation"]
  node_challanfields["Challan Fields<br/>[challan_fields.py]"]
  node_as26["26AS Conversion<br/>[as26_converter.py]"]
  node_aisconvert["AIS Conversion<br/>[ais_converter.py]"]
  node_aisdecrypt["AIS JSON Decryption"]
  node_pdfunlock["PDF Unlocking<br/>[pdf_unlocker.py]"]
  node_diagnostics["Download Diagnostics<br/>[diagnostics.py]"]
end

subgraph group_delivery["Storage and Delivery"]
  node_vault[("Encrypted Client Vault<br/>[vault.py]")]
  node_emailer["Email Delivery<br/>[emailer.py]"]
  node_history[("Download History<br/>[log_history.py]")]
end

node_user(("Tax Practitioner"))
node_portalservice["Tax Portal"]
node_smtp["SMTP Provider"]

node_user -->|"operates"| node_app
node_app -->|"opens"| node_dialogs
node_app -->|"manages clients"| node_vault
node_app -->|"dispatches batches"| node_batch
node_app -->|"launches browser"| node_browser
node_app -->|"authenticates clients"| node_auth
node_batch -->|"downloads forms"| node_download26
node_batch -->|"requests and downloads"| node_downloadais
node_batch -->|"downloads returns"| node_downloadreturns
node_batch -->|"downloads challans"| node_downloadchallans
node_batch -->|"generates challans"| node_challangen
node_download26 -->|"uses navigation"| node_downloader
node_downloadais -->|"uses navigation"| node_downloader
node_downloadreturns -->|"uses navigation"| node_downloader
node_downloadchallans -->|"uses navigation"| node_downloader
node_downloadchallans -->|"unlocks PDFs"| node_pdfunlock
node_challangen -->|"uses fields"| node_challanfields
node_challangen -->|"uses portal helpers"| node_downloadchallans
node_challangen -->|"captures diagnostics"| node_diagnostics
node_aisconvert -->|"uses decryption"| node_aisdecrypt
node_app -->|"emails documents"| node_emailer
node_emailer -->|"sends via SMTP"| node_smtp
node_app -->|"shows history"| node_history
node_app -->|"uses themes"| node_themes
node_download26 -->|"downloads from"| node_portalservice
node_downloadais -->|"requests documents"| node_portalservice
node_downloadreturns -->|"downloads from"| node_portalservice
node_downloadchallans -->|"downloads from"| node_portalservice

click node_app "https://github.com/dkbholusaria/aaydoccapio/blob/main/app.py"
click node_dialogs "https://github.com/dkbholusaria/aaydoccapio/blob/main/ui/dialogs.py"
click node_vault "https://github.com/dkbholusaria/aaydoccapio/blob/main/vault.py"
click node_browser "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/browser.py"
click node_auth "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/auth.py"
click node_batch "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/batch_handlers.py"
click node_downloader "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader.py"
click node_download26 "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_26as.py"
click node_downloadais "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_ais_tis.py"
click node_downloadreturns "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_filed_returns.py"
click node_downloadchallans "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_challans.py"
click node_challangen "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/challan_generator.py"
click node_challanfields "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/challan_fields.py"
click node_as26 "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/as26_converter.py"
click node_aisconvert "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/ais_converter.py"
click node_aisdecrypt "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/ais_json_decryptor.py"
click node_pdfunlock "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/pdf_unlocker.py"
click node_diagnostics "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/diagnostics.py"
click node_emailer "https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/emailer.py"
click node_history "https://github.com/dkbholusaria/aaydoccapio/blob/main/ui/log_history.py"
click node_themes "https://github.com/dkbholusaria/aaydoccapio/blob/main/themes.py"

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_app,node_dialogs,node_batch,node_themes toneBlue
class node_browser,node_auth,node_downloader,node_download26,node_downloadais,node_downloadreturns,node_downloadchallans toneAmber
class node_challangen,node_challanfields,node_as26,node_aisconvert,node_aisdecrypt,node_pdfunlock,node_diagnostics toneMint
class node_vault,node_emailer,node_history toneRose
class node_user,node_portalservice,node_smtp toneIndigo
```

## Components

### Client Workflow

- [Desktop App](https://github.com/dkbholusaria/aaydoccapio/blob/main/app.py): `app.py`
- [Workflow Dialogs](https://github.com/dkbholusaria/aaydoccapio/blob/main/ui/dialogs.py): `ui/dialogs.py`
- [Batch Dispatch](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/batch_handlers.py): `automation/batch_handlers.py`
- [Theme System](https://github.com/dkbholusaria/aaydoccapio/blob/main/themes.py): `themes.py`

### Portal Documents

- [Browser Session](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/browser.py): `automation/browser.py`
- [Portal Authentication](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/auth.py): `automation/auth.py`
- [Portal Navigation](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader.py): `automation/downloader.py`
- [26AS and 168](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_26as.py): `automation/downloader_26as.py`
- [AIS and TIS](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_ais_tis.py): `automation/downloader_ais_tis.py`
- [Filed Returns](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_filed_returns.py): `automation/downloader_filed_returns.py`
- [Challan Downloads](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/downloader_challans.py): `automation/downloader_challans.py`

### Document Processing

- [Challan Generation](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/challan_generator.py): `automation/challan_generator.py`
- [Challan Fields](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/challan_fields.py): `automation/challan_fields.py`
- [26AS Conversion](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/as26_converter.py): `automation/as26_converter.py`
- [AIS Conversion](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/ais_converter.py): `automation/ais_converter.py`
- [AIS JSON Decryption](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/ais_json_decryptor.py): `automation/ais_json_decryptor.py`
- [PDF Unlocking](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/pdf_unlocker.py): `automation/pdf_unlocker.py`
- [Download Diagnostics](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/diagnostics.py): `automation/diagnostics.py`

### Storage and Delivery

- [Encrypted Client Vault](https://github.com/dkbholusaria/aaydoccapio/blob/main/vault.py): `vault.py`
- [Email Delivery](https://github.com/dkbholusaria/aaydoccapio/blob/main/automation/emailer.py): `automation/emailer.py`
- [Download History](https://github.com/dkbholusaria/aaydoccapio/blob/main/ui/log_history.py): `ui/log_history.py`

### Other components

- **Tax Practitioner**
- **Tax Portal**
- **SMTP Provider**

## Connections

- Tax Practitioner → Desktop App: operates (evidence: `README.md`)
- Desktop App → Workflow Dialogs: opens (evidence: `app.py`)
- Desktop App → Encrypted Client Vault: manages clients (evidence: `app.py`)
- Desktop App → Batch Dispatch: dispatches batches (evidence: `app.py`)
- Desktop App → Browser Session: launches browser (evidence: `README.md`)
- Desktop App → Portal Authentication: authenticates clients (evidence: `app.py`)
- Batch Dispatch → 26AS and 168: downloads forms (evidence: `automation/batch_handlers.py`)
- Batch Dispatch → AIS and TIS: requests and downloads (evidence: `automation/batch_handlers.py`)
- Batch Dispatch → Filed Returns: downloads returns (evidence: `automation/batch_handlers.py`)
- Batch Dispatch → Challan Downloads: downloads challans (evidence: `automation/batch_handlers.py`)
- Batch Dispatch → Challan Generation: generates challans (evidence: `automation/batch_handlers.py`)
- 26AS and 168 → Portal Navigation: uses navigation (evidence: `automation/downloader_26as.py`)
- AIS and TIS → Portal Navigation: uses navigation (evidence: `automation/downloader_ais_tis.py`)
- Filed Returns → Portal Navigation: uses navigation (evidence: `automation/downloader_filed_returns.py`)
- Challan Downloads → Portal Navigation: uses navigation (evidence: `automation/downloader_challans.py`)
- Challan Downloads → PDF Unlocking: unlocks PDFs (evidence: `automation/downloader_challans.py`)
- Challan Generation → Challan Fields: uses fields (evidence: `automation/challan_generator.py`)
- Challan Generation → Challan Downloads: uses portal helpers (evidence: `automation/challan_generator.py`)
- Challan Generation → Download Diagnostics: captures diagnostics (evidence: `automation/challan_generator.py`)
- AIS Conversion → AIS JSON Decryption: uses decryption (evidence: `automation/ais_converter.py`)
- Desktop App → Email Delivery: emails documents (evidence: `README.md`)
- Email Delivery → SMTP Provider: sends via SMTP (evidence: `README.md`)
- Desktop App → Download History: shows history (evidence: `README.md`)
- Desktop App → Theme System: uses themes (evidence: `app.py`)
- 26AS and 168 → Tax Portal: downloads from (evidence: `README.md`)
- AIS and TIS → Tax Portal: requests documents (evidence: `README.md`)
- Filed Returns → Tax Portal: downloads from (evidence: `README.md`)
- Challan Downloads → Tax Portal: downloads from (evidence: `README.md`)
