# Customer Data Contract - Community Edition
# Simple E-commerce Analytics

contract_metadata:
  name: "customer_data_contract_community"
  version: "1.0.0"
  created_date: "2025-07-24"
  owner_team: "Data Team"
  framework_version: "AI Agentic Data Stack Community v1.0"

# Business Context
business_context:
  objective: "Basic customer segmentation for targeted marketing"
  success_metrics:
    primary_kpis:
      - name: "Customer Segmentation Accuracy"
        target: ">80%"
        measurement: "RFM analysis validation"
      - name: "Data Quality Score"
        target: ">85%"
        measurement: "3-dimensional quality framework"

# Data Specifications
data_entities:
  customer_master:
    description: "Basic customer profile for segmentation"
    source_systems: ["e-commerce_platform"]
    update_frequency: "daily"
    
    schema:
      customer_id:
        type: "string"
        format: "CUST_######"
        required: true
        quality_dimension: "completeness"
      
      email:
        type: "string"
        format: "email"
        required: true
        quality_dimension: "accuracy"
      
      first_name:
        type: "string"
        max_length: 100
        required: true
        quality_dimension: "completeness"
      
      last_name:
        type: "string"
        max_length: 100
        required: true
        quality_dimension: "completeness"
      
      registration_date:
        type: "datetime"
        format: "iso8601"
        required: true
        quality_dimension: "consistency"
      
      address:
        type: "object"
        required: false
        properties:
          street: {type: "string", max_length: 255}
          city: {type: "string", max_length: 100}
          state: {type: "string", length: 2}
          zip_code: {type: "string"}
      
      # Basic Segmentation Fields
      customer_segment:
        type: "string"
        enum: ["Champions", "Loyal_Customers", "At_Risk", "New_Customers", "Others"]
        calculated: true
        calculation_method: "rfm_analysis"

# Community Quality Framework (3 Dimensions)
quality_framework:
  dimensions:
    # 1. Completeness
    completeness:
      requirements:
        customer_id: {threshold: 100.0, criticality: "critical"}
        email: {threshold: 95.0, criticality: "high"}
        first_name: {threshold: 90.0, criticality: "medium"}
        last_name: {threshold: 90.0, criticality: "medium"}
      monitoring:
        frequency: "daily"
        alerting: "email_on_breach"
    
    # 2. Accuracy
    accuracy:
      requirements:
        email_format: {threshold: 95.0, validation: "regex_email"}
        customer_id_format: {threshold: 100.0, validation: "pattern_match"}
      monitoring:
        frequency: "daily"
        validation: "on_ingestion"
    
    # 3. Consistency
    consistency:
      requirements:
        customer_id_unique: {threshold: 100.0, check: "uniqueness"}
        email_unique: {threshold: 99.0, check: "uniqueness"}
      monitoring:
        frequency: "daily"
        reconciliation: "cross_reference"

# Basic Data Access
data_access:
  interfaces:
    analytics_dashboard:
      description: "Simple customer segment dashboard"
      features:
        - "basic_segment_exploration"
        - "rfm_analysis_results"
        - "data_quality_metrics"
      
    basic_api:
      customer_profile:
        endpoint: "/api/customer/{customer_id}"
        method: "GET"
        response_time: "<1s"

# Basic Security
security_controls:
  data_protection:
    encryption:
      at_rest: "aes_256"
      in_transit: "tls_1_2"
    
    access_controls:
      authentication: "basic_auth"
      authorization: "role_based"

# Simple Monitoring
monitoring:
  basic_alerts:
    data_quality_breach:
      threshold: "85%"
      notification: "email"
    
    pipeline_failure:
      detection: "automated"
      escalation: "immediate"

# Validation Checklist
validation_requirements:
  technical_validation:
    - schema_compliance: "100%"
    - quality_framework: "3_dimensions_operational"
    - basic_monitoring: "alerting_configured"
  
  business_validation:
    - segment_definition: "clear_criteria"
    - quality_threshold: ">85%_maintained"

---

# Community Edition Notes
#
# This data contract demonstrates the essential features of the
# AI Agentic Data Stack Framework Community Edition:
#
# ✅ Included:
# - 3-dimensional quality framework (Completeness, Accuracy, Consistency)
# - Basic customer segmentation
# - Essential monitoring and validation
# - Simple security controls
#
# 🏢 Enterprise Edition adds:
# - 7-dimensional quality framework with ML enhancement
# - Real-time collaboration and approval workflows
# - Advanced compliance automation (HIPAA, GDPR, SOX)
# - Predictive analytics and business impact measurement
# - Professional support and training
#
# Contact: enterprise@agenticdatastack.com