diff --git a/01-business/BUSINESS_DOMAINS.md b/01-business/BUSINESS_DOMAINS.md new file mode 100644 index 0000000..c49d33e --- /dev/null +++ b/01-business/BUSINESS_DOMAINS.md @@ -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 \ No newline at end of file