# hypnofox/supportpublic- architecture

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

- Interactive diagram: https://gitdiagram.com/hypnofox/supportpublic-
- Repository: https://github.com/hypnofox/supportpublic-

## Overview

Supportnetes is an early-stage design for an AI orchestration layer that works across existing technical-support systems rather than replacing them. Its documented workflow connects source data, assembles case context and evidence-backed recommendations, applies policy and human approval, then writes approved actions back and captures outcomes for audit and evaluation. The repository contains documentation only, so this graph represents documented architecture, not verified runtime wiring; optional Redis is shown separately.

Main entry points: [`docs/architecture.md`](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md) (Connectors), [`docs/storage-and-retrieval.md`](https://github.com/hypnofox/supportpublic-/blob/main/docs/storage-and-retrieval.md) (Knowledge retrieval), [`docs/product-principles.md`](https://github.com/hypnofox/supportpublic-/blob/main/docs/product-principles.md) (Human approval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Integration"]
  node_connectors["Connectors<br/>[architecture.md]"]
  node_ingestion["Ingestion<br/>[architecture.md]"]
  node_action_writeback["Action writeback<br/>[architecture.md]"]
end

subgraph group_intelligence["Case intelligence"]
  node_parsing_classification["Parsing and classification<br/>[architecture.md]"]
  node_retrieval["Knowledge retrieval"]
  node_case_context["Case context<br/>[architecture.md]"]
  node_recommendations["Evidence-backed recommendations<br/>[architecture.md]"]
  node_workflow["Workflow coordination<br/>[architecture.md]"]
  node_outcomes["Outcome capture<br/>[architecture.md]"]
end

subgraph group_governance["Governance"]
  node_identity_permissions["Identity and permissions<br/>[architecture.md]"]
  node_policy["Policy checks"]
  node_approval["Human approval"]
  node_audit_evaluation["Audit and evaluation<br/>[architecture.md]"]
end

subgraph group_platform["Data platform"]
  node_structured_storage[("Relational storage")]
  node_object_storage[("Attachment storage<br/>[architecture.md]")]
  node_redis[("Redis &#40;later&#41;<br/>[architecture.md]")]
end

node_support_operator(("Support operator"))
node_existing_systems["Support systems"]

node_existing_systems -->|"provide source data"| node_connectors
node_connectors -->|"deliver data"| node_ingestion
node_ingestion -->|"supply records"| node_identity_permissions
node_identity_permissions -->|"apply access context"| node_parsing_classification
node_parsing_classification -->|"store structured data"| node_structured_storage
node_parsing_classification -->|"store attachments"| node_object_storage
node_structured_storage -->|"retrieve records"| node_retrieval
node_object_storage -->|"retrieve attachments"| node_retrieval
node_retrieval -->|"provide evidence"| node_case_context
node_case_context -->|"inform next steps"| node_recommendations
node_recommendations -->|"inform workflow"| node_workflow
node_workflow -->|"check actions"| node_policy
node_policy -->|"request approval"| node_approval
node_support_operator -->|"review actions"| node_approval
node_approval -->|"authorize actions"| node_action_writeback
node_action_writeback -->|"dispatch actions"| node_connectors
node_connectors -->|"write approved actions"| node_existing_systems
node_existing_systems -->|"return outcomes"| node_outcomes
node_outcomes -->|"inform evaluation"| node_audit_evaluation
node_redis -.->|"support transient state"| node_workflow

click node_connectors "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_ingestion "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_identity_permissions "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_parsing_classification "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_structured_storage "https://github.com/hypnofox/supportpublic-/blob/main/docs/storage-and-retrieval.md"
click node_retrieval "https://github.com/hypnofox/supportpublic-/blob/main/docs/storage-and-retrieval.md"
click node_object_storage "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_case_context "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_recommendations "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_workflow "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_policy "https://github.com/hypnofox/supportpublic-/blob/main/docs/product-principles.md"
click node_approval "https://github.com/hypnofox/supportpublic-/blob/main/docs/product-principles.md"
click node_action_writeback "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_outcomes "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_audit_evaluation "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"
click node_redis "https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md"

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_connectors,node_ingestion,node_action_writeback toneBlue
class node_parsing_classification,node_retrieval,node_case_context,node_recommendations,node_workflow,node_outcomes toneAmber
class node_identity_permissions,node_policy,node_approval,node_audit_evaluation toneMint
class node_structured_storage,node_object_storage,node_redis toneRose
class node_support_operator,node_existing_systems toneIndigo
```

## Components

### Integration

- [Connectors](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Ingestion](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Action writeback](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`

### Case intelligence

- [Parsing and classification](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Knowledge retrieval](https://github.com/hypnofox/supportpublic-/blob/main/docs/storage-and-retrieval.md): `docs/storage-and-retrieval.md`
- [Case context](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Evidence-backed recommendations](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Workflow coordination](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Outcome capture](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`

### Governance

- [Identity and permissions](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Policy checks](https://github.com/hypnofox/supportpublic-/blob/main/docs/product-principles.md): `docs/product-principles.md`
- [Human approval](https://github.com/hypnofox/supportpublic-/blob/main/docs/product-principles.md): `docs/product-principles.md`
- [Audit and evaluation](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`

### Data platform

- [Relational storage](https://github.com/hypnofox/supportpublic-/blob/main/docs/storage-and-retrieval.md): `docs/storage-and-retrieval.md`
- [Attachment storage](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`
- [Redis (later)](https://github.com/hypnofox/supportpublic-/blob/main/docs/architecture.md): `docs/architecture.md`

### Other components

- **Support operator**
- **Support systems**

## Connections

- Support systems → Connectors: provide source data
- Connectors → Ingestion: deliver data
- Ingestion → Identity and permissions: supply records
- Identity and permissions → Parsing and classification: apply access context
- Parsing and classification → Relational storage: store structured data
- Parsing and classification → Attachment storage: store attachments
- Relational storage → Knowledge retrieval: retrieve records
- Attachment storage → Knowledge retrieval: retrieve attachments
- Knowledge retrieval → Case context: provide evidence
- Case context → Evidence-backed recommendations: inform next steps
- Evidence-backed recommendations → Workflow coordination: inform workflow
- Workflow coordination → Policy checks: check actions
- Policy checks → Human approval: request approval
- Support operator → Human approval: review actions
- Human approval → Action writeback: authorize actions
- Action writeback → Connectors: dispatch actions
- Connectors → Support systems: write approved actions
- Support systems → Outcome capture: return outcomes
- Outcome capture → Audit and evaluation: inform evaluation
- Redis (later) → Workflow coordination: support transient state