461 lines
5.9 KiB
Markdown
461 lines
5.9 KiB
Markdown
# 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 |