# abdulloh-dev03/logstream-ops architecture

> Architecture diagram of the GitHub repository abdulloh-dev03/logstream-ops, 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/abdulloh-dev03/logstream-ops
- Repository: https://github.com/abdulloh-dev03/logstream-ops

## Overview

LogStream Ops is an observability platform: users create projects, send telemetry, inspect and resolve logs, and request AI diagnostics. The backend exposes Express routes through controllers and services, with Prisma as its persistence layer; the frontend provides dashboard and account experiences with RTK Query and Socket.IO-based log updates. The tree and excerpts support the main backend routing and log-query path. Some documented capabilities, including ingestion internals and Socket.IO server wiring, are represented at directory-level paths because their implementation was not sampled; those links are marked unverified where appropriate.

Main entry points: [`packages/backend/src/app.ts`](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/app.ts) (Express API), [`packages/backend/src/lib/prisma.ts`](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/lib/prisma.ts) (PostgreSQL via Prisma), [`packages/backend/src`](https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/backend/src) (Socket.IO server), [`packages/backend/src/middleware/auth.ts`](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/middleware/auth.ts) (Session middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["Dashboard and account UI"]
  node_client_api["RTK Query APIs"]
  node_live_client["Live log updates<br/>[logQueryApi.ts]"]
end

subgraph group_backend["Backend API"]
  node_api["Express API<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[auth.route.ts]"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_project_routes["Project routes<br/>[project.route.ts]"]
  node_project_controller["Project controller"]
  node_ingest_routes["Ingestion routes<br/>[log.route.ts]"]
  node_ingest_controller["Ingestion controller<br/>[log.controller.ts]"]
  node_query_routes["Log query routes<br/>[log.query.route.ts]"]
  node_query_controller["Log query controller"]
  node_ai_routes["AI routes<br/>[ai.route.ts]"]
  node_ai_controller["AI controller<br/>[ai.controller.ts]"]
  node_auth_middleware["Session middleware<br/>[auth.ts]"]
end

subgraph group_domain["Observability services"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_project_service["Project management<br/>[project.service.ts]"]
  node_ingest_service["Log ingestion<br/>[log.service.ts]"]
  node_query_service["Log query and resolution"]
  node_ai_service["AI diagnostics<br/>[ai.service.ts]"]
end

subgraph group_infra["Persistence and integrations"]
  node_database[("PostgreSQL via Prisma<br/>[prisma.ts]")]
  node_ai_engine{{"Hugging Face inference"}}
  node_socket_server["Socket.IO server"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_web
node_web -.->|"requests data"| node_client_api
node_client_api -.->|"calls API"| node_api
node_web -.->|"views live logs"| node_live_client
node_live_client -->|"subscribes to events"| node_socket_server
node_api -->|"mounts"| node_auth_routes
node_api -->|"mounts"| node_project_routes
node_api -->|"mounts"| node_ingest_routes
node_api -->|"mounts"| node_query_routes
node_api -->|"mounts"| node_ai_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_routes -->|"protects routes"| node_auth_middleware
node_auth_service -->|"reads and writes"| node_database
node_project_routes -->|"dispatches"| node_project_controller
node_project_controller -->|"delegates to"| node_project_service
node_project_routes -->|"protects routes"| node_auth_middleware
node_project_service -->|"reads and writes"| node_database
node_ingest_routes -->|"dispatches"| node_ingest_controller
node_ingest_controller -->|"delegates to"| node_ingest_service
node_query_routes -->|"dispatches"| node_query_controller
node_query_routes -->|"protects routes"| node_auth_middleware
node_query_controller -->|"delegates to"| node_query_service
node_query_service -->|"reads and updates"| node_database
node_ai_routes -->|"dispatches"| node_ai_controller
node_ai_routes -->|"protects routes"| node_auth_middleware
node_ai_controller -->|"delegates to"| node_ai_service
node_ai_service -->|"reads context"| node_database
node_ai_service -->|"requests analysis"| node_ai_engine
node_ingest_service -.->|"persists logs"| node_database
node_ingest_service -.->|"broadcasts logs"| node_socket_server
node_query_controller -->|"emits resolution"| node_socket_server
node_socket_server -->|"sends log events"| node_live_client

click node_web "https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/frontend/src/app"
click node_client_api "https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/frontend/src/redux/features"
click node_live_client "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/frontend/src/redux/features/logQueryApi.ts"
click node_api "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/app.ts"
click node_auth_routes "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/auth.route.ts"
click node_auth_controller "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/auth.controller.ts"
click node_auth_service "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/auth.service.ts"
click node_project_routes "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/project.route.ts"
click node_project_controller "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/project.controller.ts"
click node_project_service "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/project.service.ts"
click node_ingest_routes "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/log.route.ts"
click node_ingest_controller "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/log.controller.ts"
click node_ingest_service "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/log.service.ts"
click node_query_routes "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/log.query.route.ts"
click node_query_controller "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/log.query.controller.ts"
click node_query_service "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/log.query.service.ts"
click node_ai_routes "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/ai.route.ts"
click node_ai_controller "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/ai.controller.ts"
click node_ai_service "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/ai.service.ts"
click node_auth_middleware "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/middleware/auth.ts"
click node_database "https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/lib/prisma.ts"
click node_socket_server "https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/backend/src"

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_web,node_client_api,node_live_client toneBlue
class node_api,node_auth_routes,node_auth_controller,node_project_routes,node_project_controller,node_ingest_routes,node_ingest_controller,node_query_routes,node_query_controller,node_ai_routes,node_ai_controller,node_auth_middleware toneAmber
class node_auth_service,node_project_service,node_ingest_service,node_query_service,node_ai_service toneMint
class node_database,node_ai_engine,node_socket_server toneRose
class node_operator toneIndigo
```

## Components

### Web application

- [Dashboard and account UI](https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/frontend/src/app): `packages/frontend/src/app`
- [RTK Query APIs](https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/frontend/src/redux/features): `packages/frontend/src/redux/features`
- [Live log updates](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/frontend/src/redux/features/logQueryApi.ts): `packages/frontend/src/redux/features/logQueryApi.ts`

### Backend API

- [Express API](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/app.ts): `packages/backend/src/app.ts`
- [Auth routes](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/auth.route.ts): `packages/backend/src/routes/auth.route.ts`
- [Auth controller](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/auth.controller.ts): `packages/backend/src/controllers/auth.controller.ts`
- [Project routes](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/project.route.ts): `packages/backend/src/routes/project.route.ts`
- [Project controller](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/project.controller.ts): `packages/backend/src/controllers/project.controller.ts`
- [Ingestion routes](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/log.route.ts): `packages/backend/src/routes/log.route.ts`
- [Ingestion controller](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/log.controller.ts): `packages/backend/src/controllers/log.controller.ts`
- [Log query routes](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/log.query.route.ts): `packages/backend/src/routes/log.query.route.ts`
- [Log query controller](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/log.query.controller.ts): `packages/backend/src/controllers/log.query.controller.ts`
- [AI routes](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/routes/ai.route.ts): `packages/backend/src/routes/ai.route.ts`
- [AI controller](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/controllers/ai.controller.ts): `packages/backend/src/controllers/ai.controller.ts`
- [Session middleware](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/middleware/auth.ts): `packages/backend/src/middleware/auth.ts`

### Observability services

- [Authentication](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/auth.service.ts): `packages/backend/src/services/auth.service.ts`
- [Project management](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/project.service.ts): `packages/backend/src/services/project.service.ts`
- [Log ingestion](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/log.service.ts): `packages/backend/src/services/log.service.ts`
- [Log query and resolution](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/log.query.service.ts): `packages/backend/src/services/log.query.service.ts`
- [AI diagnostics](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/services/ai.service.ts): `packages/backend/src/services/ai.service.ts`

### Persistence and integrations

- [PostgreSQL via Prisma](https://github.com/abdulloh-dev03/logstream-ops/blob/Abdulloh/packages/backend/src/lib/prisma.ts): `packages/backend/src/lib/prisma.ts`
- **Hugging Face inference**
- [Socket.IO server](https://github.com/abdulloh-dev03/logstream-ops/tree/Abdulloh/packages/backend/src): `packages/backend/src`

### Other components

- **Operator**

## Connections

- Operator → Dashboard and account UI: uses
- Dashboard and account UI → RTK Query APIs: requests data
- RTK Query APIs → Express API: calls API
- Dashboard and account UI → Live log updates: views live logs
- Live log updates → Socket.IO server: subscribes to events (evidence: `packages/frontend/src/redux/features/logQueryApi.ts`)
- Express API → Auth routes: mounts (evidence: `packages/backend/src/app.ts`)
- Express API → Project routes: mounts (evidence: `packages/backend/src/app.ts`)
- Express API → Ingestion routes: mounts (evidence: `packages/backend/src/app.ts`)
- Express API → Log query routes: mounts (evidence: `packages/backend/src/app.ts`)
- Express API → AI routes: mounts (evidence: `packages/backend/src/app.ts`)
- Auth routes → Auth controller: dispatches (evidence: `packages/backend/src/routes/auth.route.ts`)
- Auth controller → Authentication: delegates to (evidence: `packages/backend/src/controllers/auth.controller.ts`)
- Auth routes → Session middleware: protects routes (evidence: `packages/backend/src/routes/auth.route.ts`)
- Authentication → PostgreSQL via Prisma: reads and writes (evidence: `packages/backend/src/services/auth.service.ts`)
- Project routes → Project controller: dispatches (evidence: `packages/backend/src/routes/project.route.ts`)
- Project controller → Project management: delegates to (evidence: `packages/backend/src/controllers/project.controller.ts`)
- Project routes → Session middleware: protects routes (evidence: `packages/backend/src/routes/project.route.ts`)
- Project management → PostgreSQL via Prisma: reads and writes (evidence: `packages/backend/src/services/project.service.ts`)
- Ingestion routes → Ingestion controller: dispatches (evidence: `packages/backend/src/routes/log.route.ts`)
- Ingestion controller → Log ingestion: delegates to (evidence: `packages/backend/src/controllers/log.controller.ts`)
- Log query routes → Log query controller: dispatches (evidence: `packages/backend/src/routes/log.query.route.ts`)
- Log query routes → Session middleware: protects routes (evidence: `packages/backend/src/routes/log.query.route.ts`)
- Log query controller → Log query and resolution: delegates to (evidence: `packages/backend/src/controllers/log.query.controller.ts`)
- Log query and resolution → PostgreSQL via Prisma: reads and updates (evidence: `packages/backend/src/services/log.query.service.ts`)
- AI routes → AI controller: dispatches (evidence: `packages/backend/src/routes/ai.route.ts`)
- AI routes → Session middleware: protects routes (evidence: `packages/backend/src/routes/ai.route.ts`)
- AI controller → AI diagnostics: delegates to (evidence: `packages/backend/src/controllers/ai.controller.ts`)
- AI diagnostics → PostgreSQL via Prisma: reads context (evidence: `packages/backend/src/services/ai.service.ts`)
- AI diagnostics → Hugging Face inference: requests analysis
- Log ingestion → PostgreSQL via Prisma: persists logs
- Log ingestion → Socket.IO server: broadcasts logs (evidence: `packages/backend/src/controllers/log.controller.ts`)
- Log query controller → Socket.IO server: emits resolution (evidence: `packages/backend/src/controllers/log.query.controller.ts`)
- Socket.IO server → Live log updates: sends log events (evidence: `packages/frontend/src/redux/features/logQueryApi.ts`)
