Files
demotel-docs/01-business/BUSINESS_DOMAINS.md
T
2026-09-27 12:43:19 +05:30

5.9 KiB

BUSINESS DOMAINS

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


Purpose

This document defines the core business domains of DemoTel.

The purpose of these domains is to:

  • Establish business ownership boundaries
  • Enable domain-driven architecture
  • Support traceability
  • Provide context for AI-assisted document generation
  • Guide future application development

These domain definitions are the foundation for BRDs, HLDs, LLDs, APIs, data models and AI agents.


Business Domain Landscape

The DemoTel operating model is structured around the following business domains:

Product Catalog
Customer Management
Service Qualification
Order Management
Inventory Management
Provisioning
Workforce Management
Billing
Service Assurance
Notification Management
Knowledge Management

Domain Relationship Overview

Customer
    ↓
Service Qualification
    ↓
Product Catalog
    ↓
Order Management
    ↓
Inventory
    ↓
Provisioning
    ↓
Workforce Management
    ↓
Service Activation
    ↓
Billing
    ↓
Service Assurance

Supporting Domains:

Notification Management
Knowledge Management

DOMAIN 1 - PRODUCT CATALOG

Purpose

Manage all products, pricing and commercial offerings.

Responsibilities

  • Product Definition
  • Pricing Management
  • Promotions
  • Discounts
  • Bundles
  • Commercial Rules

Capabilities

  • Product Creation
  • Product Maintenance
  • Product Search
  • Offer Management
  • Price Management

Example Data

  • Broadband Packages
  • Voice Packages
  • Add-on Services

Future Repository

demotel-product-catalog

DOMAIN 2 - CUSTOMER MANAGEMENT

Purpose

Manage customer records and profiles.

Responsibilities

  • Customer Registration
  • Contact Management
  • Preferences
  • Consent Management

Capabilities

  • Customer Creation
  • Customer Search
  • Customer Updates
  • Customer Validation

Example Data

  • Customer Profile
  • Contact Details
  • Marketing Preferences

Future Repository

demotel-crm

DOMAIN 3 - SERVICE QUALIFICATION

Purpose

Determine whether a service can be provided at a location.

Responsibilities

  • Availability Checking
  • Address Validation
  • Network Eligibility

Capabilities

  • Postcode Lookup
  • Service Availability Check
  • Fibre Availability Check

Example Data

  • Address
  • Network Coverage
  • Service Status

DOMAIN 4 - ORDER MANAGEMENT

Purpose

Manage customer orders throughout their lifecycle.

Responsibilities

  • Order Capture
  • Order Tracking
  • Order Orchestration
  • Order Status Management

Capabilities

  • Create Order
  • Update Order
  • Cancel Order
  • Order Tracking

Example Data

  • Order Number
  • Order Status
  • Fulfilment Status

Future Repository

demotel-oms

DOMAIN 5 - INVENTORY MANAGEMENT

Purpose

Manage logical and physical inventory required for service delivery.

Responsibilities

  • Resource Tracking
  • Capacity Tracking
  • Asset Management

Capabilities

  • Asset Inventory
  • Resource Reservation
  • Capacity Monitoring

Example Data

  • Network Equipment
  • Ports
  • Fibre Assets

Future Repository

demotel-inventory

DOMAIN 6 - PROVISIONING

Purpose

Activate and configure services on the network.

Responsibilities

  • Service Activation
  • Configuration Management
  • Provisioning Requests

Capabilities

  • Create Provisioning Order
  • Execute Configuration
  • Activation Status Tracking

Example Data

  • Service Parameters
  • Activation Jobs
  • Configuration Records

Future Repository

demotel-provisioning

DOMAIN 7 - WORKFORCE MANAGEMENT

Purpose

Coordinate field engineers and appointments.

Responsibilities

  • Appointment Scheduling
  • Engineer Allocation
  • Resource Planning

Capabilities

  • Appointment Booking
  • Schedule Management
  • Work Order Tracking

Example Data

  • Appointment Slots
  • Engineer Details
  • Job Status

DOMAIN 8 - BILLING

Purpose

Manage charging, invoicing and payments.

Responsibilities

  • Invoice Generation
  • Payment Processing
  • Credit Management

Capabilities

  • Billing Run
  • Invoice Management
  • Payment Tracking

Example Data

  • Invoice
  • Payment
  • Account Balance

Future Repository

demotel-billing

DOMAIN 9 - SERVICE ASSURANCE

Purpose

Maintain service quality and resolve customer issues.

Responsibilities

  • Incident Management
  • Fault Tracking
  • Problem Resolution

Capabilities

  • Fault Creation
  • Fault Diagnosis
  • Resolution Tracking

Example Data

  • Ticket
  • Fault Record
  • Service Health

DOMAIN 10 - NOTIFICATION MANAGEMENT

Purpose

Manage customer communications.

Responsibilities

  • Email Notifications
  • SMS Notifications
  • KCI Updates

Capabilities

  • Send Email
  • Send SMS
  • Delivery Tracking

Example Examples

  • Order Confirmation
  • Appointment Reminder
  • Service Activated

DOMAIN 11 - KNOWLEDGE MANAGEMENT

Purpose

Manage organizational knowledge and AI retrieval.

Responsibilities

  • Document Storage
  • Document Search
  • Knowledge Retrieval
  • AI Context Management

Capabilities

  • Upload Document
  • Search Knowledge
  • Generate Embeddings
  • Source Attribution

Technology Components

  • Gitea
  • Qdrant
  • MongoDB
  • n8n

Future Repository

demotel-docs

Cross-Domain Principles

All domains should:

  • Expose APIs
  • Maintain auditability
  • Support traceability
  • Support AI-assisted development
  • Be deployable independently
  • Maintain clear ownership boundaries

AI Usage

Future AI assistants should use this document to:

  • Understand the DemoTel business landscape
  • Generate BRDs
  • Generate HLDs
  • Generate LLDs
  • Generate APIs
  • Generate User Stories
  • Generate Test Cases

All future solutions must align with these domain definitions unless superseded by a later version of this document.


Future Expansion Candidates

The following domains may be introduced later:

  • Partner Management
  • Identity & Access Management
  • Finance
  • Marketing
  • Campaign Management
  • Analytics & Reporting
  • Fraud Management

END OF DOCUMENT