# b-acharekar/trustvault architecture

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

- Interactive diagram: https://gitdiagram.com/b-acharekar/trustvault
- Repository: https://github.com/b-acharekar/trustvault

## Overview

TrustVault Phase 1 is an Android authentication client backed by a FastAPI gateway and auth service with MongoDB persistence. The main user flow is register or log in, retain the issued token securely, restore the session through /auth/me, and reach the dashboard or log out. The backend also exposes password-reset and account-deletion operations. The README marks file, sharing, activity, blockchain, storage, and detection capabilities as reserved; their implementation relationships are not evidenced here. Arrows cite shown calls or README statements; unsampled areas are left unconnected.

Main entry points: [`backend/auth_service/main.py`](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/main.py) (Auth routes), [`backend/auth_service/service.py`](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/service.py) (Auth operations), [`android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt`](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt) (Auth repository), [`backend/gateway/main.py`](https://github.com/b-acharekar/trustvault/blob/main/backend/gateway/main.py) (HTTP proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android client"]
  node_screens["Auth and dashboard<br/>[MainActivity.kt]"]
  node_authvm["Auth state<br/>[AuthViewModel.kt]"]
  node_authrepo["Auth repository<br/>[AuthRepository.kt]"]
  node_authapi["Auth API client<br/>[AuthApi.kt]"]
  node_token[("Secure token store<br/>[TokenStore.kt]")]
end

subgraph group_gateway["API gateway"]
  node_gatewayapp["HTTP proxy<br/>[main.py]"]
end

subgraph group_auth["Authentication service"]
  node_authroutes["Auth routes<br/>[main.py]"]
  node_authservice["Auth operations<br/>[service.py]"]
  node_validation["Request and response schemas<br/>[schemas.py]"]
  node_settings["Auth settings<br/>[config.py]"]
  node_errors["API error handling<br/>[errors.py]"]
  node_logging["Auth event logging<br/>[logging.py]"]
end

subgraph group_state["Identity storage"]
  node_userrepo["User repository<br/>[repository.py]"]
  node_mongodb[("MongoDB users")]
end

subgraph group_future["Reserved capabilities"]
  node_files["File service"]
  node_sharing["Sharing service"]
  node_activity["Activity service"]
  node_blockchain["Blockchain verification"]
  node_storage["File storage"]
  node_detection["Suspicious activity detection"]
end

node_user(("User"))

node_user -->|"uses"| node_screens
node_screens -->|"invokes"| node_authvm
node_authvm -->|"calls"| node_authrepo
node_authrepo -->|"calls"| node_authapi
node_authrepo -->|"reads and writes"| node_token
node_authapi -->|"sends auth requests"| node_gatewayapp
node_gatewayapp -->|"proxies auth routes"| node_authroutes
node_authroutes -->|"dispatches"| node_authservice
node_authroutes -->|"validates and shapes"| node_validation
node_authroutes -->|"initializes"| node_userrepo
node_authroutes -->|"connects to"| node_mongodb
node_authroutes -->|"installs handlers"| node_errors
node_gatewayapp -->|"installs handlers"| node_errors
node_authservice -->|"calls"| node_userrepo
node_authservice -->|"returns user schema"| node_validation
node_authservice -->|"records events"| node_logging
node_userrepo -->|"reads and writes"| node_mongodb
node_authroutes -->|"loads configuration"| node_settings

click node_screens "https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/MainActivity.kt"
click node_authvm "https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/ui/auth/AuthViewModel.kt"
click node_authrepo "https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt"
click node_authapi "https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/api/AuthApi.kt"
click node_token "https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/local/TokenStore.kt"
click node_gatewayapp "https://github.com/b-acharekar/trustvault/blob/main/backend/gateway/main.py"
click node_authroutes "https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/main.py"
click node_authservice "https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/service.py"
click node_validation "https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/schemas.py"
click node_settings "https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/config.py"
click node_errors "https://github.com/b-acharekar/trustvault/blob/main/backend/common/errors.py"
click node_logging "https://github.com/b-acharekar/trustvault/blob/main/backend/common/logging.py"
click node_userrepo "https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/repository.py"
click node_files "https://github.com/b-acharekar/trustvault/tree/main/backend/file-service"
click node_sharing "https://github.com/b-acharekar/trustvault/tree/main/backend/sharing-service"
click node_activity "https://github.com/b-acharekar/trustvault/tree/main/backend/activity-service"
click node_blockchain "https://github.com/b-acharekar/trustvault/tree/main/blockchain"
click node_storage "https://github.com/b-acharekar/trustvault/tree/main/storage"
click node_detection "https://github.com/b-acharekar/trustvault/tree/main/detection"

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_screens,node_authvm,node_authrepo,node_authapi,node_token,node_user toneBlue
class node_gatewayapp toneAmber
class node_authroutes,node_authservice,node_validation,node_settings,node_errors,node_logging toneMint
class node_userrepo,node_mongodb toneRose
class node_files,node_sharing,node_activity,node_blockchain,node_storage,node_detection toneIndigo
```

## Components

### Android client

- [Auth and dashboard](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/MainActivity.kt): `android-app/app/src/main/java/com/trustvault/MainActivity.kt`
- [Auth state](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/ui/auth/AuthViewModel.kt): `android-app/app/src/main/java/com/trustvault/ui/auth/AuthViewModel.kt`
- [Auth repository](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt): `android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt`
- [Auth API client](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/api/AuthApi.kt): `android-app/app/src/main/java/com/trustvault/data/api/AuthApi.kt`
- [Secure token store](https://github.com/b-acharekar/trustvault/blob/main/android-app/app/src/main/java/com/trustvault/data/local/TokenStore.kt): `android-app/app/src/main/java/com/trustvault/data/local/TokenStore.kt`

### API gateway

- [HTTP proxy](https://github.com/b-acharekar/trustvault/blob/main/backend/gateway/main.py): `backend/gateway/main.py`

### Authentication service

- [Auth routes](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/main.py): `backend/auth_service/main.py`
- [Auth operations](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/service.py): `backend/auth_service/service.py`
- [Request and response schemas](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/schemas.py): `backend/auth_service/schemas.py`
- [Auth settings](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/config.py): `backend/auth_service/config.py`
- [API error handling](https://github.com/b-acharekar/trustvault/blob/main/backend/common/errors.py): `backend/common/errors.py`
- [Auth event logging](https://github.com/b-acharekar/trustvault/blob/main/backend/common/logging.py): `backend/common/logging.py`

### Identity storage

- [User repository](https://github.com/b-acharekar/trustvault/blob/main/backend/auth_service/repository.py): `backend/auth_service/repository.py`
- **MongoDB users**

### Reserved capabilities

- [File service](https://github.com/b-acharekar/trustvault/tree/main/backend/file-service): `backend/file-service`
- [Sharing service](https://github.com/b-acharekar/trustvault/tree/main/backend/sharing-service): `backend/sharing-service`
- [Activity service](https://github.com/b-acharekar/trustvault/tree/main/backend/activity-service): `backend/activity-service`
- [Blockchain verification](https://github.com/b-acharekar/trustvault/tree/main/blockchain): `blockchain`
- [File storage](https://github.com/b-acharekar/trustvault/tree/main/storage): `storage`
- [Suspicious activity detection](https://github.com/b-acharekar/trustvault/tree/main/detection): `detection`

### Other components

- **User**

## Connections

- User → Auth and dashboard: uses (evidence: `README.md`)
- Auth and dashboard → Auth state: invokes (evidence: `android-app/app/src/main/java/com/trustvault/MainActivity.kt`)
- Auth state → Auth repository: calls (evidence: `android-app/app/src/main/java/com/trustvault/ui/auth/AuthViewModel.kt`)
- Auth repository → Auth API client: calls (evidence: `android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt`)
- Auth repository → Secure token store: reads and writes (evidence: `android-app/app/src/main/java/com/trustvault/data/repository/AuthRepository.kt`)
- Auth API client → HTTP proxy: sends auth requests (evidence: `README.md`)
- HTTP proxy → Auth routes: proxies auth routes (evidence: `backend/gateway/main.py`)
- Auth routes → Auth operations: dispatches (evidence: `backend/auth_service/main.py`)
- Auth routes → Request and response schemas: validates and shapes (evidence: `backend/auth_service/main.py`)
- Auth routes → User repository: initializes (evidence: `backend/auth_service/main.py`)
- Auth routes → MongoDB users: connects to (evidence: `backend/auth_service/main.py`)
- Auth routes → API error handling: installs handlers (evidence: `backend/auth_service/main.py`)
- HTTP proxy → API error handling: installs handlers (evidence: `backend/gateway/main.py`)
- Auth operations → User repository: calls (evidence: `backend/auth_service/service.py`)
- Auth operations → Request and response schemas: returns user schema (evidence: `backend/auth_service/service.py`)
- Auth operations → Auth event logging: records events (evidence: `backend/auth_service/service.py`)
- User repository → MongoDB users: reads and writes (evidence: `backend/auth_service/repository.py`)
- Auth routes → Auth settings: loads configuration (evidence: `backend/auth_service/main.py`)
