How abdulloh-dev03/logstream-ops works
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: app.ts Express API · prisma.ts PostgreSQL via Prisma · src Socket.IO server · auth.ts Session middleware
Components 24
Web application
- Dashboard and account UI
packages/frontend/src/app - RTK Query APIs
packages/frontend/src/redux/features - Live log updates
packages/frontend/src/redux/features/logQueryApi.ts
Backend API
- Express API
packages/backend/src/app.ts - Auth routes
packages/backend/src/routes/auth.route.ts - Auth controller
packages/backend/src/controllers/auth.controller.ts - Project routes
packages/backend/src/routes/project.route.ts - Project controller
packages/backend/src/controllers/project.controller.ts - Ingestion routes
packages/backend/src/routes/log.route.ts - Ingestion controller
packages/backend/src/controllers/log.controller.ts - Log query routes
packages/backend/src/routes/log.query.route.ts - Log query controller
packages/backend/src/controllers/log.query.controller.ts - AI routes
packages/backend/src/routes/ai.route.ts - AI controller
packages/backend/src/controllers/ai.controller.ts - Session middleware
packages/backend/src/middleware/auth.ts
Observability services
- Authentication
packages/backend/src/services/auth.service.ts - Project management
packages/backend/src/services/project.service.ts - Log ingestion
packages/backend/src/services/log.service.ts - Log query and resolution
packages/backend/src/services/log.query.service.ts - AI diagnostics
packages/backend/src/services/ai.service.ts
Persistence and integrations
- PostgreSQL via Prisma
packages/backend/src/lib/prisma.ts - Hugging Face inference
- Socket.IO server
packages/backend/src
Other components
- Operator
Connections 33
- 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
packages/frontend/src/redux/features/logQueryApi.ts - Express API → Auth routes: mounts
packages/backend/src/app.ts - Express API → Project routes: mounts
packages/backend/src/app.ts - Express API → Ingestion routes: mounts
packages/backend/src/app.ts - Express API → Log query routes: mounts
packages/backend/src/app.ts - Express API → AI routes: mounts
packages/backend/src/app.ts - Auth routes → Auth controller: dispatches
packages/backend/src/routes/auth.route.ts - Auth controller → Authentication: delegates to
packages/backend/src/controllers/auth.controller.ts - Auth routes → Session middleware: protects routes
packages/backend/src/routes/auth.route.ts - Authentication → PostgreSQL via Prisma: reads and writes
packages/backend/src/services/auth.service.ts - Project routes → Project controller: dispatches
packages/backend/src/routes/project.route.ts - Project controller → Project management: delegates to
packages/backend/src/controllers/project.controller.ts - Project routes → Session middleware: protects routes
packages/backend/src/routes/project.route.ts - Project management → PostgreSQL via Prisma: reads and writes
packages/backend/src/services/project.service.ts - Ingestion routes → Ingestion controller: dispatches
packages/backend/src/routes/log.route.ts - Ingestion controller → Log ingestion: delegates to
packages/backend/src/controllers/log.controller.ts - Log query routes → Log query controller: dispatches
packages/backend/src/routes/log.query.route.ts - Log query routes → Session middleware: protects routes
packages/backend/src/routes/log.query.route.ts - Log query controller → Log query and resolution: delegates to
packages/backend/src/controllers/log.query.controller.ts - Log query and resolution → PostgreSQL via Prisma: reads and updates
packages/backend/src/services/log.query.service.ts - AI routes → AI controller: dispatches
packages/backend/src/routes/ai.route.ts - AI routes → Session middleware: protects routes
packages/backend/src/routes/ai.route.ts - AI controller → AI diagnostics: delegates to
packages/backend/src/controllers/ai.controller.ts - AI diagnostics → PostgreSQL via Prisma: reads context
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
packages/backend/src/controllers/log.controller.ts - Log query controller → Socket.IO server: emits resolution
packages/backend/src/controllers/log.query.controller.ts - Socket.IO server → Live log updates: sends log events
packages/frontend/src/redux/features/logQueryApi.ts