=====
Tasks
=====

Every deployment can have **tasks** linked to it, powered by the built-in
Odoo project management module (``project.task``).

Creating Tasks
==============

1. Open a deployment and navigate to the **Tasks** tab.
2. Click **New Task**.
3. Enter a title, description, and optionally set a **stage** and **priority**.

Tasks created here are automatically linked to the deployment and its parent
project.

.. image:: /static/img/task_list.png
   :alt: TODO — screenshot of the task list

.. image:: /static/img/create_task_form.png
   :alt: TODO — screenshot of the create task form

Eyrie Task Types
================

Eyrie adds custom task type labels with colors to help categorize work:

- Bug fixes, feature requests, infrastructure changes, etc.

These labels appear as colored badges on the task list.

Task Behavior on Merge
======================

When deployments are merged across scopes (e.g. dev → production), the
**scope's merge task behavior** controls what happens to linked tasks:

- **Move** — reassign tasks to the target deployment and optionally change
  their stage.
- **Unlink** — remove the task-deployment link (tasks remain but are no longer
  associated with a deployment).
- **None** — do nothing.

This is configured per scope via the ``merge_task_behavior`` and
``project_task_stage_id`` fields (see :doc:`scopes`).