+-------------------------------------------------------------------------------------------------+
|                                         Makefile Targets                                        |
+-------------------------------------------------------------------------------------------------+
|                                                                                                 |
|  [Default Test Workflow]                                                                        |
|  test (Auto-detects mode: .local or .package)                                                   |
|    └─> build_container                                                                          |
|    └─> test_container                                                                           |
|                                                                                                 |
|  [Specific Test Workflows - Topology 1: Privileged Container]                                   |
|  test_package (Mode A1: Bots from official packages)                                            |
|    └─> build_container                                                                          |
|    └─> test_container                                                                           |
|                                                                                                 |
|  test_local (Mode B1: Bots from local binaries)                                                 |
|    └─> build_container                                                                          |
|    └─> test_container                                                                           |
|                                                                                                 |
|  build_container                                                                                |
|    - Action: Builds the `autogits_integration` privileged container image.                      |
|    - Purpose: Prepares an environment for running tests within a single container.              |
|                                                                                                 |
|  test_container                                                                                 |
|    - Action: Runs `autogits_integration` container, executes `make build`, `make up`, and       |
|              `pytest -v tests/*` inside it.                                                     |
|    - Purpose: Executes the full test suite in Topology 1 (privileged container).                |
|                                                                                                 |
|  [Build & Orchestration Workflows - Topology 2: podman-compose]                                 |
|                                                                                                 |
|  build_package (Mode A: Builds service images from official packages)                           |
|    └─> build                                                                                    |
|                                                                                                 |
|  build_local (Mode B: Builds service images from local binaries)                                |
|    └─> build                                                                                    |
|                                                                                                 |
|  build                                                                                          |
|    - Action: Pulls `rabbitmq` image and iterates through `podman-compose.yml` services          |
|              to build each one.                                                                 |
|    - Purpose: Prepares all necessary service images for Topology 2 deployment.                  |
|                                                                                                 |
|  up                                                                                             |
|    - Action: Starts all services defined in `podman-compose.yml` in detached mode.              |
|    - Purpose: Deploys the application topology (containers) for testing or development.         |
|                                                                                                 |
|  down                                                                                           |
|    - Action: Stops and removes all services started by `up`.                                    |
|    - Purpose: Cleans up the deployed application topology.                                      |
|                                                                                                 |
|  up-bots-package (Mode A: Spawns Topology 2 with official package bots)                         |
|    - Action: Calls `podman-compose up -d` with `GIWTF_IMAGE_SUFFIX=.package`.                   |
|    - Purpose: Specifically brings up the environment using official package bots.               |
|                                                                                                 |
|  up-bots-local (Mode B: Spawns Topology 2 with local binaries)                                  |
|    - Action: Calls `podman-compose up -d` with `GIWTF_IMAGE_SUFFIX=.local`.                     |
|    - Purpose: Specifically brings up the environment using local binaries.                      |
|                                                                                                 |
+-------------------------------------------------------------------------------------------------+