API Reference
=============

Complete API documentation for the CCAT Data Transfer System. This section provides detailed documentation for developers working with the system.

.. toctree::
   :maxdepth: 2
   :caption: API Documentation:

   managers/index
   services/index
   core/index
   tasks/index

Overview
--------

The API is organized into functional areas:

**Managers** (:doc:`managers/index`)
   Core business logic classes that orchestrate data transfer operations.
   These follow the Manager/Worker pattern described in :doc:`../philosophy`.

**Services** (:doc:`services/index`)
   Supporting services and utilities that provide monitoring, health checks,
   and operational support.

**Core** (:doc:`core/index`)
   Fundamental components including database connections, configuration,
   exceptions, and utility functions.

**Tasks** (:doc:`tasks/index`)
   Celery task definitions and distributed processing components.

Architecture Notes
------------------

All managers follow the same pattern:

1. **Manager Process**: Scans database, prepares operations, submits tasks
2. **Worker Process**: Executes actual work, updates database with results

See :doc:`../philosophy` for detailed explanation of the Manager/Worker duality.

For higher-level operational guidance, see the main documentation sections:

* :doc:`../concepts` - Core concepts and data model
* :doc:`../pipeline` - Data processing pipeline
* :doc:`../monitoring` - System monitoring and observability
* :doc:`../lifecycle` - Data lifecycle management