Core Utilities
===============

Fundamental components including database connections, configuration, exceptions, and utility functions.

.. toctree::
   :maxdepth: 2
   :caption: Core Components:

   database
   config
   exceptions
   utils
   decorators
   logging_utils
   metrics
   notification_service
   operation_types
   queue_discovery
   settings_manager

Overview
--------

Core utilities provide the foundation for the data transfer system:

**Database**
   Database connection and ORM models.

**Configuration**
   System configuration management and settings.

**Exceptions**
   Custom exception classes for error handling.

**Utilities**
   Common utility functions and helpers.

**Decorators**
   Reusable decorators for common patterns.

**Logging Utils**
   Logging configuration and utilities.

**Metrics**
   Performance metrics and monitoring.

**Notification Service**
   System notifications and alerts.

**Operation Types**
   Data models for operation types and states.

**Queue Discovery**
   Celery queue discovery and management.

**Settings Manager**
   Dynamic settings management.

Core Architecture
-----------------

These components provide the foundation that all managers and services build upon:

* Database connectivity and data models
* Configuration management
* Error handling and logging
* Performance monitoring
* System notifications

For understanding how these components fit into the larger system:

* :doc:`../../concepts` - Core concepts and data model
* :doc:`../../philosophy` - System design principles