From 83eee0159729c19f926f74762dd595579704f6a7 Mon Sep 17 00:00:00 2001 From: alokelive Date: Sun, 27 Sep 2026 12:47:16 +0530 Subject: [PATCH] Add infrastructure architecture document --- 03-architecture/INFRASTRUCTURE.md | 603 ++++++++++++++++++++++++++++++ 1 file changed, 603 insertions(+) create mode 100644 03-architecture/INFRASTRUCTURE.md diff --git a/03-architecture/INFRASTRUCTURE.md b/03-architecture/INFRASTRUCTURE.md new file mode 100644 index 0000000..51d462c --- /dev/null +++ b/03-architecture/INFRASTRUCTURE.md @@ -0,0 +1,603 @@ +# 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: + +```text +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 + +```text +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 + +```text +demotel.network +``` + +Subdomain Strategy + +```text +git.demotel.network +n8n.demotel.network +ai.demotel.network +``` + +Future Examples + +```text +crm.demotel.network +oms.demotel.network +billing.demotel.network +catalog.demotel.network +``` + +--- + +# Repository Landscape + +## Knowledge Repository + +```text +demotel-docs +``` + +Purpose + +- Context Documents +- Architecture Documents +- Standards +- Templates +- Project Knowledge + +--- + +## Customer Domain + +```text +demotel-crm +``` + +Purpose + +Customer Management Application + +--- + +## Product Domain + +```text +demotel-product-catalog +``` + +Purpose + +Product Catalog Management + +--- + +## Order Domain + +```text +demotel-oms +``` + +Purpose + +Order Management + +--- + +## Billing Domain + +```text +demotel-billing +``` + +Purpose + +Billing Platform + +--- + +## Provisioning Domain + +```text +demotel-provisioning +``` + +Purpose + +Provisioning Services + +--- + +## Inventory Domain + +```text +demotel-inventory +``` + +Purpose + +Network and Service Inventory + +--- + +# Knowledge Architecture + +Target Architecture + +```text +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 + +```text +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 + +```text +traefik +n8n +mongodb +qdrant +gitea +postgres +``` + +Future Containers + +```text +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 \ No newline at end of file