# tracehanami/secureaccess architecture

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

- Interactive diagram: https://gitdiagram.com/tracehanami/secureaccess
- Repository: https://github.com/tracehanami/secureaccess

## Overview

SecureAccess is a desktop personal-file vault. The main workflow is: a user launches the GUI, registers or logs in, then selects a file and passcode to encrypt it into a personal vault or decrypt it in place. Authentication and file encryption use separate cryptographic paths; vault operations stage writes atomically. The README also documents header validation, account lockout, and inactivity logout. The source excerpts show the principal calls; the credentials and vault stores are runtime files, not repository files.

Main entry points: [`secure_access/gui.py`](https://github.com/tracehanami/secureaccess/blob/main/secure_access/gui.py) (Vault GUI), [`secure_access/vault.py`](https://github.com/tracehanami/secureaccess/blob/main/secure_access/vault.py) (Vault operations), [`secure_access/auth.py`](https://github.com/tracehanami/secureaccess/blob/main/secure_access/auth.py) (Account service), [`secure_access/config.py`](https://github.com/tracehanami/secureaccess/blob/main/secure_access/config.py) (Security settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_launcher["App launcher<br/>[secure_access.py]"]
  node_gui["Vault GUI<br/>[gui.py]"]
end

subgraph group_identity["Authentication"]
  node_auth["Account service<br/>[auth.py]"]
  node_credentials[("Credential store")]
end

subgraph group_protection["File protection"]
  node_crypto["Crypto engine<br/>[crypto.py]"]
  node_vault["Vault operations<br/>[vault.py]"]
  node_vaultfiles[("Vault files")]
end

subgraph group_settings["Configuration"]
  node_config["Security settings<br/>[config.py]"]
end

node_user(("User"))
node_os["Host file opener"]

node_user -->|"launches"| node_launcher
node_launcher -->|"starts"| node_gui
node_user -->|"uses"| node_gui
node_gui -->|"registers or authenticates"| node_auth
node_auth -->|"reads and writes"| node_credentials
node_auth -->|"hashes and verifies"| node_crypto
node_gui -->|"requests file operations"| node_vault
node_vault -->|"encrypts and decrypts"| node_crypto
node_vault -->|"reads and writes"| node_vaultfiles
node_vault -->|"validates username"| node_auth
node_gui -->|"uses session limits"| node_config
node_auth -->|"uses credential path"| node_config
node_vault -->|"uses vault path"| node_config
node_crypto -->|"uses crypto parameters"| node_config
node_gui -->|"opens vault folder"| node_os

click node_launcher "https://github.com/tracehanami/secureaccess/blob/main/secure_access.py"
click node_gui "https://github.com/tracehanami/secureaccess/blob/main/secure_access/gui.py"
click node_auth "https://github.com/tracehanami/secureaccess/blob/main/secure_access/auth.py"
click node_crypto "https://github.com/tracehanami/secureaccess/blob/main/secure_access/crypto.py"
click node_vault "https://github.com/tracehanami/secureaccess/blob/main/secure_access/vault.py"
click node_config "https://github.com/tracehanami/secureaccess/blob/main/secure_access/config.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_launcher,node_gui,node_user toneBlue
class node_auth,node_credentials toneAmber
class node_crypto,node_vault,node_vaultfiles toneMint
class node_config toneRose
class node_os toneIndigo
```

## Components

### Desktop interface

- [App launcher](https://github.com/tracehanami/secureaccess/blob/main/secure_access.py): `secure_access.py`
- [Vault GUI](https://github.com/tracehanami/secureaccess/blob/main/secure_access/gui.py): `secure_access/gui.py`

### Authentication

- [Account service](https://github.com/tracehanami/secureaccess/blob/main/secure_access/auth.py): `secure_access/auth.py`
- **Credential store**

### File protection

- [Crypto engine](https://github.com/tracehanami/secureaccess/blob/main/secure_access/crypto.py): `secure_access/crypto.py`
- [Vault operations](https://github.com/tracehanami/secureaccess/blob/main/secure_access/vault.py): `secure_access/vault.py`
- **Vault files**

### Configuration

- [Security settings](https://github.com/tracehanami/secureaccess/blob/main/secure_access/config.py): `secure_access/config.py`

### Other components

- **User**
- **Host file opener**

## Connections

- User → App launcher: launches (evidence: `README.md`)
- App launcher → Vault GUI: starts (evidence: `secure_access.py`)
- User → Vault GUI: uses (evidence: `README.md`)
- Vault GUI → Account service: registers or authenticates (evidence: `secure_access/gui.py`)
- Account service → Credential store: reads and writes (evidence: `secure_access/auth.py`)
- Account service → Crypto engine: hashes and verifies (evidence: `secure_access/auth.py`)
- Vault GUI → Vault operations: requests file operations (evidence: `secure_access/gui.py`)
- Vault operations → Crypto engine: encrypts and decrypts (evidence: `secure_access/vault.py`)
- Vault operations → Vault files: reads and writes (evidence: `secure_access/vault.py`)
- Vault operations → Account service: validates username (evidence: `secure_access/vault.py`)
- Vault GUI → Security settings: uses session limits (evidence: `secure_access/gui.py`)
- Account service → Security settings: uses credential path (evidence: `secure_access/auth.py`)
- Vault operations → Security settings: uses vault path (evidence: `secure_access/vault.py`)
- Crypto engine → Security settings: uses crypto parameters (evidence: `secure_access/crypto.py`)
- Vault GUI → Host file opener: opens vault folder (evidence: `secure_access/gui.py`)
