tests: add integration tests

Author: adiffpirate

CLAUDE.md

@@ -12,7 +12,8 @@ The application is organized in a modular monolith with clear separation:
 - `app.db.session`: Database session management
 - `app.modules.orders`: Complete order module with models, schemas, repository, service, routes
 - `alembic`: Database migration tool
-- `tests`: Unit tests (SQLite in-memory)
+- `tests/unit`: Unit tests (SQLite in-memory)
+- `tests/integration`: Integration tests (PostgreSQL)
 
 ## Key Development Commands
 
@@ -24,10 +25,21 @@ source .venv/bin/activate  # Windows: .venv\Scripts\Activate.ps1
 
 # Install dependencies
 pip install --upgrade pip
-pip install -e .[dev]
-
-# Run API
-uvicorn app.main:app --reload
+pip install -e '.[dev]'
+
+# Run fresh database
+docker stop postgres-dev || true
+docker rm postgres-dev || true
+docker run -d \
+  --name postgres-dev \
+  -e POSTGRES_USER=postgres \
+  -e POSTGRES_PASSWORD=postgres \
+  -e POSTGRES_DB=app \
+  -p 5432:5432 \
+  postgres:15
+
+# Run API in background
+uvicorn app.main:app --reload &
 ```
 
 **Testing**

README.md

@@ -13,6 +13,7 @@ Alembic for migrations, and SQLite for fast unit tests.
 │   ├── api/
 │   │   └── router.py
 │   ├── core/
+│   │   └── config.py
 │   ├── db/
 │   │   └── session.py
 │   └── modules/
@@ -28,10 +29,10 @@ Alembic for migrations, and SQLite for fast unit tests.
 │           ├── repository.py
 │           ├── service.py
 │           └── routes.py
-│
 ├── alembic/
 ├── tests/
-│   └── unit/
+│   ├── unit/
+│   └── integration/
 ├── pyproject.toml
 └── README.md
 ```
@@ -69,9 +70,11 @@ pip install -e '.[dev]'
 
 ## 🐘 Running PostgreSQL (Docker)
 
-Start a local PostgreSQL instance:
+Start a fresh local PostgreSQL instance:
 
 ```bash
+docker stop postgres-dev || true
+docker rm postgres-dev || true
 docker run -d \
   --name postgres-dev \
   -e POSTGRES_USER=postgres \
@@ -123,10 +126,20 @@ http://localhost:8000/docs
 
 ## 🧪 Running Tests
 
-Tests use **SQLite in-memory**, so no database setup is required.
+### Unit Tests
+
+> Uses SQLite in-memory, so no database setup is required.
+
+```bash
+pytest tests/unit
+```
+
+### Integration Tests
+
+> Fresh PostgreSQL instance with migrations applied is required.
 
 ```bash
-pytest
+pytest tests/integration
 ```
 
 ## 🔌 Example API Usage

alembic/env.py

@@ -1,16 +1,25 @@
 from logging.config import fileConfig
-import os
-
 from sqlalchemy import engine_from_config, pool
 from alembic import context
-
 from app.db.session import Base
-from app.modules.orders import models  # important
+import os
+import pkgutil
+import importlib
+
+# Dynamically import all 'models' submodules in 'app.modules'
+def import_all_models():
+    import app.modules as modules_pkg
+    # walk_packages looks into subdirectories of app.modules
+    for loader, module_name, is_pkg in pkgutil.walk_packages(
+        modules_pkg.__path__, modules_pkg.__name__ + "."
+    ):
+        # Only import if the submodule ends with '.models'
+        if module_name.endswith(".models"):
+            importlib.import_module(module_name)
+import_all_models()
 
 config = context.config
-
 fileConfig(config.config_file_name)
-
 target_metadata = Base.metadata
 
 

alembic/versions/084d9bd91fca_add_users.py

@@ -0,0 +1,41 @@
+"""add users
+
+Revision ID: 084d9bd91fca
+Revises: 91a829a056ca
+Create Date: 2026-04-24 09:32:08.216154
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '084d9bd91fca'
+down_revision: Union[str, Sequence[str], None] = '91a829a056ca'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('users',
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('username', sa.String(), nullable=False),
+    sa.Column('hashed_password', sa.String(), nullable=False),
+    sa.PrimaryKeyConstraint('id')
+    )
+    op.create_index(op.f('ix_users_id'), 'users', ['id'], unique=False)
+    op.create_index(op.f('ix_users_username'), 'users', ['username'], unique=True)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(op.f('ix_users_username'), table_name='users')
+    op.drop_index(op.f('ix_users_id'), table_name='users')
+    op.drop_table('users')
+    # ### end Alembic commands ###