Tutorials
=========

Step-by-step guides for common development tasks with ops-db-api.

.. contents:: Table of Contents
   :local:
   :depth: 2

Overview
--------

These tutorials cover:

* **Simple Endpoints**: Basic read/write endpoints with authentication
* **Complex Endpoints**: Multi-table transactions, buffering, smart queries
* **Observatory Integration**: Service scripts for telescope operations
* **UI Integration**: Frontend integration patterns

.. toctree::
   :maxdepth: 2

   simple-endpoints/index
   complex-endpoints/index
   observatory-integration/index
   ui-integration/index

Tutorial Path
-------------

**New to the API?** Start with:

1. :doc:`simple-endpoints/simple-read-endpoint`
2. :doc:`simple-endpoints/simple-write-endpoint`
3. :doc:`simple-endpoints/adding-authentication`

**Ready for advanced topics?** Continue with:

4. :doc:`complex-endpoints/multi-table-transactions`
5. :doc:`complex-endpoints/buffered-critical-operations`
6. :doc:`complex-endpoints/smart-queries-with-buffering`

**Building observatory automation?** See:

7. :doc:`observatory-integration/recording-observations`
8. :doc:`observatory-integration/registering-data-files`
9. :doc:`observatory-integration/service-scripts`

**Building UI features?** See:

10. :doc:`ui-integration/dashboard-endpoints`
11. :doc:`ui-integration/visibility-calculations`
12. :doc:`ui-integration/transfer-monitoring`

Prerequisites
-------------

Before starting tutorials:

* Completed :doc:`../quickstart/installation`
* Familiar with FastAPI basics
* Understanding of :doc:`../architecture/index`
* Local development environment set up

Next Steps
----------

Choose a tutorial category:

* :doc:`simple-endpoints/index` - Basic endpoint development
* :doc:`complex-endpoints/index` - Advanced patterns
* :doc:`observatory-integration/index` - Automation scripts
* :doc:`ui-integration/index` - Frontend integration