docs: enhance database migrations section in README

Author: Creylay

README.rst

@@ -200,18 +200,94 @@ You can check all available options through the command:
 
 
 Database Migrations
-==========
+==================
+
 Migrations are managed through `Alembic <https://alembic.sqlalchemy.org/en/latest/>`_.
-They are automatically run when starting DashAI. However, if you want to
-run them manually, you can do it through the command (inside the `DashAI/` folder):
-.. code:: bash
+
+They are automatically executed when starting DashAI. However, if you want to
+run them manually, you can do so using the following command (inside the
+`DashAI/` folder):
+
+.. code-block:: bash
+
     $ alembic upgrade head
 
-To create a new migration after modifying the database models, run:
-.. code:: bash
+This command applies all pending migrations up to the latest revision.
+
+---
+
+Creating a New Migration
+------------------------
+
+After modifying the database models, a new migration can be generated using:
+
+.. code-block:: bash
+
     $ alembic revision --autogenerate -m "<<Your message here>>"
-Where <<Your message here>> is a very brief description of the changes made.
-Migrations are located in `alembic/versions`. Should be committed to the repository.
+
+Where ``<<Your message here>>`` is a brief description of the changes introduced
+(e.g., *add model metadata table*, *update dataset schema*).
+
+Generated migrations are located in the ``alembic/versions`` directory and
+**must be committed to the repository**.
+
+It is strongly recommended to review the autogenerated migration file before
+applying it, as Alembic may not always detect complex changes correctly.
+
+---
+
+Applying Migrations
+-------------------
+
+To apply all pending migrations:
+
+.. code-block:: bash
+
+    $ alembic upgrade head
+
+To upgrade to a specific revision:
+
+.. code-block:: bash
+
+    $ alembic upgrade <revision_id>
+
+---
+
+Downgrading Migrations
+----------------------
+
+If you need to revert database changes, migrations can be downgraded using:
+
+.. code-block:: bash
+
+    $ alembic downgrade -1
+
+This command reverts the last applied migration.
+
+To downgrade to a specific revision:
+
+.. code-block:: bash
+
+    $ alembic downgrade <revision_id>
+
+---
+
+Checking Migration Status
+-------------------------
+
+To view the current migration applied to the database:
+
+.. code-block:: bash
+
+    $ alembic current
+
+To list the full migration history:
+
+.. code-block:: bash
+
+    $ alembic history
+
+---
 
 
 Testing