# traynertunder2047/hsoc architecture

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

## Overview

HSOC is documented as a local-first home-security desktop application, but the repository describes itself as an initial skeleton: its README says the directory READMEs are organizational placeholders, not implemented features. The intended workflow is a user operating the desktop dashboard alongside a local Go core/service, with SQLite as the core’s sole-writer store. The tree also preserves planned specialist Rust and Python modules, security-rule domains, and protocol contracts. These are shown as capabilities, not as verified runtime stages. Only the Go-to-database write relationship is explicitly documented; other connections are omitted.

Main entry points: [`internal`](https://github.com/traynertunder2047/hsoc/tree/main/internal) (Go core/service), [`database`](https://github.com/traynertunder2047/hsoc/tree/main/database) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_dashboard["Dashboard"]
end

subgraph group_runtime["Local runtime"]
  node_core["Go core/service"]
  node_rust["Specialist modules"]
  node_python["Auxiliary analysis"]
end

subgraph group_domains["Security domains"]
  node_detection["Detection rules"]
  node_correlation["Correlation rules"]
  node_iot["IoT rules"]
  node_vulnerability["Vulnerability rules"]
end

subgraph group_contracts["Contracts and storage"]
  node_protocols["IPC and messages"]
  node_sqlite[("SQLite database")]
end

node_user(("Home user"))

node_core -->|"writes"| node_sqlite

click node_dashboard "https://github.com/traynertunder2047/hsoc/tree/main/desktop"
click node_core "https://github.com/traynertunder2047/hsoc/tree/main/internal"
click node_rust "https://github.com/traynertunder2047/hsoc/tree/main/rust"
click node_python "https://github.com/traynertunder2047/hsoc/tree/main/python"
click node_detection "https://github.com/traynertunder2047/hsoc/tree/main/rules/detection"
click node_correlation "https://github.com/traynertunder2047/hsoc/tree/main/rules/correlation"
click node_iot "https://github.com/traynertunder2047/hsoc/tree/main/rules/iot"
click node_vulnerability "https://github.com/traynertunder2047/hsoc/tree/main/rules/vulnerability"
click node_protocols "https://github.com/traynertunder2047/hsoc/tree/main/protocols"
click node_sqlite "https://github.com/traynertunder2047/hsoc/tree/main/database"

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_dashboard,node_user toneBlue
class node_core,node_rust,node_python toneAmber
class node_detection,node_correlation,node_iot,node_vulnerability toneMint
class node_protocols,node_sqlite toneRose
```

## Components

### Desktop application

- [Dashboard](https://github.com/traynertunder2047/hsoc/tree/main/desktop): `desktop`

### Local runtime

- [Go core/service](https://github.com/traynertunder2047/hsoc/tree/main/internal): `internal`
- [Specialist modules](https://github.com/traynertunder2047/hsoc/tree/main/rust): `rust`
- [Auxiliary analysis](https://github.com/traynertunder2047/hsoc/tree/main/python): `python`

### Security domains

- [Detection rules](https://github.com/traynertunder2047/hsoc/tree/main/rules/detection): `rules/detection`
- [Correlation rules](https://github.com/traynertunder2047/hsoc/tree/main/rules/correlation): `rules/correlation`
- [IoT rules](https://github.com/traynertunder2047/hsoc/tree/main/rules/iot): `rules/iot`
- [Vulnerability rules](https://github.com/traynertunder2047/hsoc/tree/main/rules/vulnerability): `rules/vulnerability`

### Contracts and storage

- [IPC and messages](https://github.com/traynertunder2047/hsoc/tree/main/protocols): `protocols`
- [SQLite database](https://github.com/traynertunder2047/hsoc/tree/main/database): `database`

### Other components

- **Home user**

## Connections

- Go core/service → SQLite database: writes (evidence: `README.md`)
