Add business domains document

This commit is contained in:
2026-09-27 12:43:19 +05:30
parent 1503a0827a
commit 58f47fd430
+461
View File
@@ -0,0 +1,461 @@
# 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:
```text
Product Catalog
Customer Management
Service Qualification
Order Management
Inventory Management
Provisioning
Workforce Management
Billing
Service Assurance
Notification Management
Knowledge Management
```
---
# Domain Relationship Overview
```text
Customer
↓
Service Qualification
↓
Product Catalog
↓
Order Management
↓
Inventory
↓
Provisioning
↓
Workforce Management
↓
Service Activation
↓
Billing
↓
Service Assurance
```
Supporting Domains:
```text
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
```text
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
```text
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
```text
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
```text
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
```text
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
```text
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
```text
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