diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md
index 670ac103..4c24021e 100644
--- a/docs/architecture/overview.md
+++ b/docs/architecture/overview.md
@@ -344,7 +344,7 @@ Internet ───────────│ Load Balancer│
 ### For Developers
 - [Creating a New Admin Page](../frontend/admin/page-templates.md)
 - [Backend Development Guide](../backend/overview.md)
-- [Database Migrations](../development/database-migrations.md)
+- [Database Migrations](../development/migration/database-migrations.md)
 
 ### For Operations
 - [Deployment Guide](../deployment/production.md)
diff --git a/docs/backend/overview.md b/docs/backend/overview.md
index 97e0a0da..dea8d4b1 100644
--- a/docs/backend/overview.md
+++ b/docs/backend/overview.md
@@ -341,7 +341,7 @@ make migrate-create message="add_product_table"
 make migrate-up
 ```
 
-**See**: [Database Migrations](../development/database-migrations.md)
+**See**: [Database Migrations](../development/migration/database-migrations.md)
 
 ## API Documentation
 
@@ -480,5 +480,5 @@ def get_vendor_settings(vendor_id: int) -> dict:
 
 - [Middleware Reference](middleware-reference.md) - Technical API documentation
 - [Architecture Overview](../architecture/overview.md) - System architecture
-- [Database Migrations](../development/database-migrations.md) - Migration guide
+- [Database Migrations](../development/migration/database-migrations.md) - Migration guide
 - [Testing Guide](../testing/testing-guide.md) - Testing practices
diff --git a/docs/development/contributing.md b/docs/development/contributing.md
index 8e0b9cd6..85d50c13 100644
Binary files a/docs/development/contributing.md and b/docs/development/contributing.md differ
diff --git a/docs/development/database-migrations.md b/docs/development/migration/database-migrations.md
similarity index 100%
rename from docs/development/database-migrations.md
rename to docs/development/migration/database-migrations.md
diff --git a/docs/development/svc-006-migration-plan.md b/docs/development/migration/svc-006-migration-plan.md
similarity index 100%
rename from docs/development/svc-006-migration-plan.md
rename to docs/development/migration/svc-006-migration-plan.md
diff --git a/docs/development/troubleshooting.md b/docs/development/troubleshooting.md
index 6790a2cb..e5d4ca1d 100644
--- a/docs/development/troubleshooting.md
+++ b/docs/development/troubleshooting.md
@@ -535,4 +535,4 @@ If the issue persists:
 
 - [PyCharm Make Configuration](pycharm-configuration-make.md) - Configure Make with virtual environment
 - [Contributing Guide](contributing.md) - Development workflow
-- [Database Migrations](database-migrations.md) - Working with Alembic
+- [Database Migrations](migration/database-migrations.md) - Working with Alembic
diff --git a/docs/getting-started/database-setup.md b/docs/getting-started/database-setup.md
index 03526cd0..e87f8a20 100644
--- a/docs/getting-started/database-setup.md
+++ b/docs/getting-started/database-setup.md
@@ -331,5 +331,5 @@ python scripts/create_landing_page.py
 
 - [Shop Setup Guide](../guides/shop-setup.md) - Configure vendor storefronts
 - [Landing Pages Guide](../features/vendor-landing-pages.md) - Customize landing pages
-- [Database Migrations Guide](../development/database-migrations.md) - Advanced migration workflows
+- [Database Migrations Guide](../development/migration/database-migrations.md) - Advanced migration workflows
 - [API Documentation](../api/index.md) - Start building features
diff --git a/docs/index.md b/docs/index.md
index 8efe62d6..4e9be7de 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -179,7 +179,7 @@ platform.com/admin                 → Admin Interface
 
     Alembic migration guide
 
-    [:octicons-arrow-right-24: Migrations](development/database-migrations.md)
+    [:octicons-arrow-right-24: Migrations](development/migration/database-migrations.md)
 
 -   :material-electron-framework:{ .lg .middle } __PyCharm Setup__
 
@@ -324,7 +324,7 @@ When running the application locally:
 
 3. **Start developing**
    - [Backend Development](backend/overview.md)
-   - [Database Migrations](development/database-migrations.md)
+   - [Database Migrations](development/migration/database-migrations.md)
    - [Testing Guide](testing/testing-guide.md)
 
 ### For Operations
diff --git a/mkdocs.yml b/mkdocs.yml
index 0e507c99..162ef49b 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -118,7 +118,7 @@ nav:
     - Customer Authentication:
       - Implementation Guide: development/customer-authentication-implementation.md
       - Quick Summary: development/customer-auth-summary.md
-    - Database Migrations: development/database-migrations.md
+    - Database Migrations: development/migration/database-migrations.md
     - Database Seeder:
       - Documentation: development/database-seeder/database-seeder-documentation.md
       - Makefile Guide: development/database-seeder/makefile-database-seeder.md