# dhruvvv-sh/is_proj architecture

> Architecture diagram of the GitHub repository dhruvvv-sh/is_proj, 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/dhruvvv-sh/is_proj
- Repository: https://github.com/dhruvvv-sh/is_proj

## Overview

CipherChat is an educational encrypted-messaging prototype with attack detection, privacy-preserving incident evidence, and bounded recovery. Its principal flow establishes peer sessions, sends and validates encrypted messages, then classifies protocol failures, records evidence, and either rekeys or blocks the session. A local teaching UI exposes message and attack demonstrations. The UI and simulator excerpts show orchestration; the graph omits uncertain frontend wiring and treats the prototype as local rather than a production transport.

Main entry points: [`cipherchat/protocol/session.py`](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/protocol/session.py) (Session manager), [`cipherchat/main.py`](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/main.py) (CLI demo), [`cipherchat/security/simulator.py`](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/simulator.py) (Attack simulator), [`cipherchat/ui/server.py`](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/ui/server.py) (Local UI server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_demo["Demo entry points"]
  node_main["CLI demo<br/>[main.py]"]
  node_ui["Local UI server<br/>[server.py]"]
  node_browser["Browser UI"]
end

subgraph group_crypto["Identity and cryptography"]
  node_identity["Peer identity<br/>[identity.py]"]
  node_exchange["X25519 exchange<br/>[key_exchange.py]"]
  node_kdf["HKDF derivation<br/>[kdf.py]"]
  node_encryption["AES-GCM<br/>[encryption.py]"]
end

subgraph group_protocol["Messaging protocol"]
  node_sessions["Session manager<br/>[session.py]"]
  node_messages["Message sessions<br/>[messages.py]"]
end

subgraph group_security["Attack response"]
  node_attacks["Failure classification<br/>[attacks.py]"]
  node_evidence[("Evidence chain<br/>[evidence.py]")]
  node_recovery["Recovery machine<br/>[recovery.py]"]
  node_simulator["Attack simulator<br/>[simulator.py]"]
end

node_user(("Demo user"))

node_user -->|"runs demo"| node_main
node_user -->|"opens demo"| node_ui
node_browser -->|"sends requests"| node_ui
node_main -->|"creates peers"| node_identity
node_identity -->|"generates keys"| node_exchange
node_main -->|"establishes sessions"| node_sessions
node_sessions -->|"checks pinned keys"| node_attacks
node_sessions -->|"derives shared secret"| node_exchange
node_sessions -->|"derives session key"| node_kdf
node_sessions -->|"creates sessions"| node_messages
node_messages -->|"encrypts and decrypts"| node_encryption
node_main -->|"classifies failures"| node_attacks
node_main -->|"records incidents"| node_evidence
node_main -->|"drives recovery"| node_recovery
node_ui -->|"creates demo peers"| node_identity
node_ui -->|"establishes sessions"| node_sessions
node_ui -->|"runs attack scenarios"| node_simulator
node_simulator -->|"establishes and rekeys"| node_sessions
node_simulator -->|"classifies failures"| node_attacks
node_simulator -->|"records and verifies"| node_evidence
node_simulator -->|"drives recovery"| node_recovery

click node_main "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/main.py"
click node_ui "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/ui/server.py"
click node_browser "https://github.com/dhruvvv-sh/is_proj/tree/main/cipherchat/ui/static"
click node_identity "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/identity.py"
click node_exchange "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/key_exchange.py"
click node_kdf "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/kdf.py"
click node_encryption "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/encryption.py"
click node_sessions "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/protocol/session.py"
click node_messages "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/protocol/messages.py"
click node_attacks "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/attacks.py"
click node_evidence "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/evidence.py"
click node_recovery "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/recovery.py"
click node_simulator "https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/simulator.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_main,node_ui,node_browser,node_user toneBlue
class node_identity,node_exchange,node_kdf,node_encryption toneAmber
class node_sessions,node_messages toneMint
class node_attacks,node_evidence,node_recovery,node_simulator toneRose
```

## Components

### Demo entry points

- [CLI demo](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/main.py): `cipherchat/main.py`
- [Local UI server](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/ui/server.py): `cipherchat/ui/server.py`
- [Browser UI](https://github.com/dhruvvv-sh/is_proj/tree/main/cipherchat/ui/static): `cipherchat/ui/static`

### Identity and cryptography

- [Peer identity](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/identity.py): `cipherchat/crypto/identity.py`
- [X25519 exchange](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/key_exchange.py): `cipherchat/crypto/key_exchange.py`
- [HKDF derivation](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/kdf.py): `cipherchat/crypto/kdf.py`
- [AES-GCM](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/crypto/encryption.py): `cipherchat/crypto/encryption.py`

### Messaging protocol

- [Session manager](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/protocol/session.py): `cipherchat/protocol/session.py`
- [Message sessions](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/protocol/messages.py): `cipherchat/protocol/messages.py`

### Attack response

- [Failure classification](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/attacks.py): `cipherchat/security/attacks.py`
- [Evidence chain](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/evidence.py): `cipherchat/security/evidence.py`
- [Recovery machine](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/recovery.py): `cipherchat/security/recovery.py`
- [Attack simulator](https://github.com/dhruvvv-sh/is_proj/blob/main/cipherchat/security/simulator.py): `cipherchat/security/simulator.py`

### Other components

- **Demo user**

## Connections

- Demo user → CLI demo: runs demo (evidence: `README.md`)
- Demo user → Local UI server: opens demo (evidence: `README.md`)
- Browser UI → Local UI server: sends requests (evidence: `cipherchat/ui/server.py`)
- CLI demo → Peer identity: creates peers (evidence: `cipherchat/main.py`)
- Peer identity → X25519 exchange: generates keys (evidence: `cipherchat/crypto/identity.py`)
- CLI demo → Session manager: establishes sessions (evidence: `cipherchat/main.py`)
- Session manager → Failure classification: checks pinned keys (evidence: `cipherchat/protocol/session.py`)
- Session manager → X25519 exchange: derives shared secret (evidence: `cipherchat/protocol/session.py`)
- Session manager → HKDF derivation: derives session key (evidence: `cipherchat/protocol/session.py`)
- Session manager → Message sessions: creates sessions (evidence: `cipherchat/protocol/session.py`)
- Message sessions → AES-GCM: encrypts and decrypts (evidence: `cipherchat/protocol/messages.py`)
- CLI demo → Failure classification: classifies failures (evidence: `cipherchat/main.py`)
- CLI demo → Evidence chain: records incidents (evidence: `cipherchat/main.py`)
- CLI demo → Recovery machine: drives recovery (evidence: `cipherchat/main.py`)
- Local UI server → Peer identity: creates demo peers (evidence: `cipherchat/ui/server.py`)
- Local UI server → Session manager: establishes sessions (evidence: `cipherchat/ui/server.py`)
- Local UI server → Attack simulator: runs attack scenarios (evidence: `cipherchat/ui/server.py`)
- Attack simulator → Session manager: establishes and rekeys (evidence: `cipherchat/security/simulator.py`)
- Attack simulator → Failure classification: classifies failures (evidence: `cipherchat/security/simulator.py`)
- Attack simulator → Evidence chain: records and verifies (evidence: `cipherchat/security/simulator.py`)
- Attack simulator → Recovery machine: drives recovery (evidence: `cipherchat/security/simulator.py`)
