# Tutorials

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

```{contents} Table of Contents
:depth: 2
:local: true
```

## 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