# debjoy26/text_ai_complete_product_doc architecture

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

- Interactive diagram: https://gitdiagram.com/debjoy26/text_ai_complete_product_doc
- Repository: https://github.com/debjoy26/text_ai_complete_product_doc

## Overview

This repository is a documentation-only product hub, not an implementation. Its documented principal workflow is a website visitor using the embeddable widget and visitor API, backed by tenant data and services. It also describes client administration and a separate, proposed provider-control experience. The graph reflects the README’s documented topology; component-level behavior and implementation paths are not available here, so subsystem nodes point to the relevant architecture or requirements documents.

Main entry points: [`PRODUCT_REQUIREMENTS.md`](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/PRODUCT_REQUIREMENTS.md) (Provider-admin experience), [`SYSTEM_ARCHITECTURE.md`](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md) (Visitor API), [`DATA_AND_API_CONTRACTS.md`](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/DATA_AND_API_CONTRACTS.md) (Approved RPCs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor service"]
  node_widget["Static widget"]
  node_visitor_api["Visitor API"]
  node_tenant_db[("Tenant database")]
  node_vector_search["Vector search"]
  node_private_storage[("Private document storage")]
  node_worker["Worker"]
end

subgraph group_client_admin["Client administration"]
  node_admin_panel["Client admin panel"]
  node_supabase_auth["Supabase Auth"]
  node_rls_reads["RLS-protected reads"]
  node_approved_rpcs["Approved RPCs"]
  node_admin_storage[("Supabase Storage")]
end

subgraph group_provider["Provider control plane"]
  node_provider_experience["Provider-admin experience"]
  node_provider_identity["Provider identity"]
  node_control_api["Control API"]
  node_client_registry[("Client registry")]
  node_audit_store[("Audit store")]
  node_tenant_operations["Scoped tenant operations"]
end

node_client_website(("Client website"))
node_client_admins(("Client administrators"))
node_provider_staff(("Provider staff"))

node_client_website -->|"embeds"| node_widget
node_widget -->|"calls"| node_visitor_api
node_visitor_api -->|"uses"| node_tenant_db
node_visitor_api -->|"uses"| node_vector_search
node_visitor_api -->|"uses"| node_private_storage
node_visitor_api -->|"uses"| node_worker
node_client_admins -->|"uses"| node_admin_panel
node_admin_panel -->|"uses"| node_supabase_auth
node_admin_panel -->|"uses"| node_rls_reads
node_admin_panel -->|"uses"| node_approved_rpcs
node_admin_panel -->|"uses"| node_admin_storage
node_provider_staff -.->|"uses"| node_provider_experience
node_provider_experience -.->|"uses"| node_provider_identity
node_provider_experience -.->|"uses"| node_control_api
node_provider_experience -.->|"uses"| node_client_registry
node_provider_experience -.->|"uses"| node_audit_store
node_provider_experience -.->|"requests"| node_tenant_operations

click node_widget "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_visitor_api "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_tenant_db "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_vector_search "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_private_storage "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_worker "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_admin_panel "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/PRODUCT_REQUIREMENTS.md"
click node_supabase_auth "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_rls_reads "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_approved_rpcs "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/DATA_AND_API_CONTRACTS.md"
click node_admin_storage "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_provider_experience "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/PRODUCT_REQUIREMENTS.md"
click node_provider_identity "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_control_api "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_client_registry "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_audit_store "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md"
click node_tenant_operations "https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_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_widget,node_visitor_api,node_tenant_db,node_vector_search,node_private_storage,node_worker,node_client_website,node_client_admins toneBlue
class node_admin_panel,node_supabase_auth,node_rls_reads,node_approved_rpcs,node_admin_storage toneAmber
class node_provider_experience,node_provider_identity,node_control_api,node_client_registry,node_audit_store,node_tenant_operations toneMint
class node_provider_staff toneIndigo
```

## Components

### Visitor service

- [Static widget](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Visitor API](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Tenant database](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Vector search](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Private document storage](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Worker](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`

### Client administration

- [Client admin panel](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/PRODUCT_REQUIREMENTS.md): `PRODUCT_REQUIREMENTS.md`
- [Supabase Auth](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [RLS-protected reads](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Approved RPCs](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/DATA_AND_API_CONTRACTS.md): `DATA_AND_API_CONTRACTS.md`
- [Supabase Storage](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`

### Provider control plane

- [Provider-admin experience](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/PRODUCT_REQUIREMENTS.md): `PRODUCT_REQUIREMENTS.md`
- [Provider identity](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Control API](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Client registry](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Audit store](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`
- [Scoped tenant operations](https://github.com/debjoy26/text_ai_complete_product_doc/blob/main/SYSTEM_ARCHITECTURE.md): `SYSTEM_ARCHITECTURE.md`

### Other components

- **Client website**
- **Client administrators**
- **Provider staff**

## Connections

- Client website → Static widget: embeds (evidence: `README.md`)
- Static widget → Visitor API: calls (evidence: `README.md`)
- Visitor API → Tenant database: uses (evidence: `README.md`)
- Visitor API → Vector search: uses (evidence: `README.md`)
- Visitor API → Private document storage: uses (evidence: `README.md`)
- Visitor API → Worker: uses (evidence: `README.md`)
- Client administrators → Client admin panel: uses (evidence: `README.md`)
- Client admin panel → Supabase Auth: uses (evidence: `README.md`)
- Client admin panel → RLS-protected reads: uses (evidence: `README.md`)
- Client admin panel → Approved RPCs: uses (evidence: `README.md`)
- Client admin panel → Supabase Storage: uses (evidence: `README.md`)
- Provider staff → Provider-admin experience: uses (evidence: `README.md`)
- Provider-admin experience → Provider identity: uses (evidence: `README.md`)
- Provider-admin experience → Control API: uses (evidence: `README.md`)
- Provider-admin experience → Client registry: uses (evidence: `README.md`)
- Provider-admin experience → Audit store: uses (evidence: `README.md`)
- Provider-admin experience → Scoped tenant operations: requests (evidence: `README.md`)
