Backend
=======

Code Structure
--------------

.. list-table:: Main backend areas
	 :header-rows: 1
	 :class: feature-table

	 * - Path
		 - Description
	 * - ``backend/main.py``
		 - FastAPI application creation and lifecycle wiring.
	 * - ``backend/api/``
		 - HTTP routes (compute, documents, prompt, variables, and related domains).
	 * - ``backend/service/``
		 - Business logic modules (chat, climate data, geocoding, and processing).
	 * - ``backend/core/``
		 - Configuration and cross-cutting runtime components.

API
---

The OpenAPI schema is exposed by FastAPI:

- ``/openapi.json``
- ``/docs`` (Swagger UI)

Best Practices
--------------

- Add routes in ``backend/api/`` and then wire the router.
- Keep business logic in ``backend/service/``.
- Write pytest tests in ``backend/tests/`` for each new feature.