Files

6.4 KiB

INFRASTRUCTURE

Version: 1.0 Date: 2026-09-27 Status: Active


Purpose

This document defines the DemoTel infrastructure landscape.

The objective is to provide a single source of truth for:

  • Hosting
  • Deployment
  • Networking
  • Containers
  • Repositories
  • Databases
  • Future Services

This document should be updated whenever new platforms, containers, domains or services are introduced.


Infrastructure Overview

DemoTel currently operates using a container-based architecture hosted on a VPS.

Deployment Model:

Single VPS
    ↓
Docker
    ↓
Containerized Services
    ↓
Traefik Routing

Primary Objectives:

  • Low Cost
  • Rapid Development
  • Easy Deployment
  • AI Experimentation
  • Telecom Solution Prototyping

Hosting Environment

Provider

Hostinger VPS

Environment Type

Development / Lab Environment

Platform Strategy

  • Container First
  • Open Source First
  • API Driven
  • AI Enabled

Logical Architecture

Browser
   │
   ▼
Traefik
   │
   ├──────────────┬──────────────┬──────────────┐
   │              │              │              │
   ▼              ▼              ▼              ▼

 AI UI           n8n          Gitea         Other Apps
                        

                   │
       ┌───────────┼───────────┐
       │           │           │

       ▼           ▼           ▼

    MongoDB     Qdrant     PostgreSQL

Core Infrastructure Components

Traefik

Purpose

Reverse Proxy and Routing Layer

Responsibilities

  • SSL Termination
  • Domain Routing
  • HTTPS Enforcement
  • Service Exposure

Status

Operational


n8n

Purpose

Workflow Automation Platform

Responsibilities

  • AI Orchestration
  • Knowledge Ingestion
  • Data Movement
  • System Integration

Status

Operational

Planned Expansion

  • Gitea Ingestion
  • Embedding Generation
  • AI Search
  • Agent Workflows

MongoDB

Purpose

Operational Data Store

Responsibilities

  • Customer Data
  • Metadata
  • Conversation Storage
  • Document Catalog

Status

Operational

Current Validation

  • Insert Workflow Tested
  • Read Workflow Tested

Qdrant

Purpose

Vector Database

Responsibilities

  • Embeddings
  • Semantic Search
  • RAG Retrieval

Status

Operational

Planned Usage

  • Knowledge Search
  • Context Retrieval
  • Multi-document Question Answering

Gitea

Purpose

Code and Documentation Repository

Responsibilities

  • Source Control
  • Knowledge Repository
  • Version History
  • Documentation Management

Status

Operational

Repositories Managed

  • demotel-docs
  • demotel-crm
  • demotel-oms
  • demotel-product-catalog
  • demotel-billing
  • demotel-provisioning
  • demotel-inventory

PostgreSQL

Purpose

Relational Database Platform

Status

Available

Future Usage

  • Application Services
  • Reporting
  • Structured Domain Data

DNS Strategy

Primary Domain

demotel.network

Subdomain Strategy

git.demotel.network
n8n.demotel.network
ai.demotel.network

Future Examples

crm.demotel.network
oms.demotel.network
billing.demotel.network
catalog.demotel.network

Repository Landscape

Knowledge Repository

demotel-docs

Purpose

  • Context Documents
  • Architecture Documents
  • Standards
  • Templates
  • Project Knowledge

Customer Domain

demotel-crm

Purpose

Customer Management Application


Product Domain

demotel-product-catalog

Purpose

Product Catalog Management


Order Domain

demotel-oms

Purpose

Order Management


Billing Domain

demotel-billing

Purpose

Billing Platform


Provisioning Domain

demotel-provisioning

Purpose

Provisioning Services


Inventory Domain

demotel-inventory

Purpose

Network and Service Inventory


Knowledge Architecture

Target Architecture

Documents
      ↓
Gitea
      ↓
n8n
      ↓
Embeddings
      ↓
Qdrant
      ↓
AI Workspace

Principles

  • Gitea = Source Of Truth
  • Qdrant = Search Layer
  • MongoDB = Metadata Layer

AI Workspace Architecture

Planned Frontend Stack

  • React
  • TypeScript
  • TailwindCSS
  • ShadCN UI

Phase 1 Architecture

Browser
      ↓
React Workspace
      ↓
n8n Webhooks

No FastAPI planned during Phase 1.


Container Strategy

Deployment Standard

Every major service should be deployed as an independent container.

Examples

traefik
n8n
mongodb
qdrant
gitea
postgres

Future Containers

demotel-ai-ui
demotel-agent-service
demotel-search-service

Principles

  • Independent Deployment
  • Loose Coupling
  • Domain Ownership
  • Scalable Design

Security Principles

Current Objectives

  • HTTPS Everywhere
  • Secret Management
  • Minimum Public Exposure

Planned Enhancements

  • Central Authentication
  • RBAC
  • Audit Logging

Data Architecture

Operational Data

Platform

MongoDB

Examples

  • Customer Accounts
  • Orders
  • Metadata

Knowledge Data

Platform

Gitea

Examples

  • BRDs
  • HLDs
  • LLDs
  • Standards

Vector Data

Platform

Qdrant

Examples

  • Embeddings
  • RAG Chunks
  • Search Results

Relational Data

Platform

PostgreSQL

Examples

  • Future Application Data
  • Reporting

Monitoring Roadmap

Future Capabilities

  • Infrastructure Monitoring
  • Container Monitoring
  • Workflow Monitoring
  • AI Usage Metrics
  • Search Analytics

Potential Platforms

  • Grafana
  • Prometheus
  • Loki

Disaster Recovery Strategy

Current

  • Git-Based Source Control
  • VPS Backups

Future

  • Database Backups
  • Configuration Backups
  • Automated Recovery Procedures

Future Infrastructure Evolution

Phase 1

Knowledge Platform

Phase 2

AI Workspace

Phase 3

Knowledge Search Platform

Phase 4

Agent Platform

Phase 5

SDLC Automation Platform

Phase 6

Enterprise Telecom Reference Architecture


Success Criteria

Infrastructure shall be considered successful when:

✅ Source code is version controlled

✅ Documentation is centralized

✅ Knowledge is searchable

✅ AI can retrieve context

✅ New services are containerized

✅ Architecture decisions are documented

✅ Deployment remains simple and repeatable


Revision History

Version Date Description
1.0 2026-09-27 Initial Infrastructure Baseline

END OF DOCUMENT