Add business domains document
This commit is contained in:
@@ -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
|
||||
Reference in New Issue
Block a user