init commit. Skeleton prepared

.drone.yml

@@ -0,0 +1,119 @@
+---
+kind: pipeline
+type: docker
+name: ci
+
+trigger:
+  event: [ push, pull_request ]
+
+steps:
+  - name: test-auth
+    image: python:3.12
+    environment:
+      PYTHONPATH: services/auth/src
+    commands:
+      - python -V
+      - pip install --no-cache-dir -r services/auth/requirements.txt
+      - python -m pytest -q services/auth/tests
+  - name: test-profiles
+    image: python:3.12
+    environment:
+      PYTHONPATH: services/profiles/src
+    commands:
+      - python -V
+      - pip install --no-cache-dir -r services/profiles/requirements.txt
+      - python -m pytest -q services/profiles/tests
+  - name: test-match
+    image: python:3.12
+    environment:
+      PYTHONPATH: services/match/src
+    commands:
+      - python -V
+      - pip install --no-cache-dir -r services/match/requirements.txt
+      - python -m pytest -q services/match/tests
+  - name: test-chat
+    image: python:3.12
+    environment:
+      PYTHONPATH: services/chat/src
+    commands:
+      - python -V
+      - pip install --no-cache-dir -r services/chat/requirements.txt
+      - python -m pytest -q services/chat/tests
+  - name: test-payments
+    image: python:3.12
+    environment:
+      PYTHONPATH: services/payments/src
+    commands:
+      - python -V
+      - pip install --no-cache-dir -r services/payments/requirements.txt
+      - python -m pytest -q services/payments/tests
+  - name: build-auth
+    image: plugins/docker
+    privileged: true
+    settings:
+      context: services/auth
+      dockerfile: services/auth/Dockerfile
+      repo: registry.example.com/your-namespace/marriage-auth
+      tags: [ latest ]
+      username:
+        from_secret: docker_username
+      password:
+        from_secret: docker_password
+    when:
+      event: [ push ]
+  - name: build-profiles
+    image: plugins/docker
+    privileged: true
+    settings:
+      context: services/profiles
+      dockerfile: services/profiles/Dockerfile
+      repo: registry.example.com/your-namespace/marriage-profiles
+      tags: [ latest ]
+      username:
+        from_secret: docker_username
+      password:
+        from_secret: docker_password
+    when:
+      event: [ push ]
+  - name: build-match
+    image: plugins/docker
+    privileged: true
+    settings:
+      context: services/match
+      dockerfile: services/match/Dockerfile
+      repo: registry.example.com/your-namespace/marriage-match
+      tags: [ latest ]
+      username:
+        from_secret: docker_username
+      password:
+        from_secret: docker_password
+    when:
+      event: [ push ]
+  - name: build-chat
+    image: plugins/docker
+    privileged: true
+    settings:
+      context: services/chat
+      dockerfile: services/chat/Dockerfile
+      repo: registry.example.com/your-namespace/marriage-chat
+      tags: [ latest ]
+      username:
+        from_secret: docker_username
+      password:
+        from_secret: docker_password
+    when:
+      event: [ push ]
+  - name: build-payments
+    image: plugins/docker
+    privileged: true
+    settings:
+      context: services/payments
+      dockerfile: services/payments/Dockerfile
+      repo: registry.example.com/your-namespace/marriage-payments
+      tags: [ latest ]
+      username:
+        from_secret: docker_username
+      password:
+        from_secret: docker_password
+    when:
+      event: [ push ]

.github/workflows/readme.md

@@ -0,0 +1,3 @@
+# CI Note
+This project uses Drone CI (.drone.yml).
+This placeholder keeps the directory in the repo.

.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+.eggs/
+.venv/
+venv/
+.env
+.env.*
+.pytest_cache/
+.mypy_cache/
+coverage.xml
+htmlcov/
+dist/
+build/
+
+# IDE / OS
+.DS_Store
+.idea/
+.vscode/
+
+# Docker
+**/.python_packages/
+**/.pytest_cache/
+**/.ruff_cache/

README.md

@@ -0,0 +1,15 @@
+# Match Agency — Python Microservices Skeleton
+
+**Stack**: Python (FastAPI) • PostgreSQL • SQLAlchemy 2.0 • Alembic • Docker Compose  
+**Gateway**: Nginx • **CI/CD**: Drone
+
+## Quick Start
+1) `cp .env.example .env`  
+2) `docker compose up --build`  
+3) Gateway: http://localhost:8080  (routes: /auth, /profiles, /match, /chat, /payments)
+
+## Structure
+- services/*           — микросервисы (ООП-слои: repositories/services)
+- infra/db/init        — init-скрипты Postgres (создание БД под сервисы)
+- infra/gateway        — конфиг Nginx (API gateway)
+- .drone.yml           — CI/CD (pytest + docker build)

docker-compose.yml

@@ -0,0 +1,105 @@
+version: "3.9"
+services:
+  postgres:
+    image: postgres:16
+    container_name: postgres
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+      - ./infra/db/init:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres} -d ${POSTGRES_DB:-postgres}"]
+      interval: 5s
+      timeout: 5s
+      retries: 40
+
+  gateway:
+    image: nginx:alpine
+    container_name: gateway
+    depends_on:
+      - auth
+      - profiles
+      - match
+      - chat
+      - payments
+    ports:
+      - "8080:80"
+    volumes:
+      - ./infra/gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
+
+  auth:
+    build:
+      context: ./services/auth
+    container_name: marriage_auth
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: ${AUTH_DATABASE_URL}
+    depends_on:
+      - postgres
+    ports:
+      - "${AUTH_PORT:-8001}:8000"
+    command: ./docker-entrypoint.sh
+
+  profiles:
+    build:
+      context: ./services/profiles
+    container_name: marriage_profiles
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: ${PROFILES_DATABASE_URL}
+    depends_on:
+      - postgres
+    ports:
+      - "${PROFILES_PORT:-8002}:8000"
+    command: ./docker-entrypoint.sh
+
+  match:
+    build:
+      context: ./services/match
+    container_name: marriage_match
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: ${MATCH_DATABASE_URL}
+    depends_on:
+      - postgres
+    ports:
+      - "${MATCH_PORT:-8003}:8000"
+    command: ./docker-entrypoint.sh
+
+  chat:
+    build:
+      context: ./services/chat
+    container_name: marriage_chat
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: ${CHAT_DATABASE_URL}
+    depends_on:
+      - postgres
+    ports:
+      - "${CHAT_PORT:-8004}:8000"
+    command: ./docker-entrypoint.sh
+
+  payments:
+    build:
+      context: ./services/payments
+    container_name: marriage_payments
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: ${PAYMENTS_DATABASE_URL}
+    depends_on:
+      - postgres
+    ports:
+      - "${PAYMENTS_PORT:-8005}:8000"
+    command: ./docker-entrypoint.sh
+
+volumes:
+  pgdata:

infra/db/init/01_create_databases.sql

@@ -0,0 +1,6 @@
+-- Executed once on fresh Postgres volume
+CREATE DATABASE auth_db;
+CREATE DATABASE profiles_db;
+CREATE DATABASE match_db;
+CREATE DATABASE chat_db;
+CREATE DATABASE payments_db;

infra/gateway/nginx.conf

@@ -0,0 +1,50 @@
+server {
+  listen 80;
+  server_name _;
+
+  # Health of gateway itself
+  location = /health {
+    default_type application/json;
+    return 200 '{"status":"ok","gateway":"nginx"}';
+  }
+  location /auth/ {
+    proxy_pass         http://auth:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header   Host $host;
+    proxy_set_header   X-Real-IP $remote_addr;
+    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+  }
+  location /profiles/ {
+    proxy_pass         http://profiles:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header   Host $host;
+    proxy_set_header   X-Real-IP $remote_addr;
+    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+  }
+  location /match/ {
+    proxy_pass         http://match:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header   Host $host;
+    proxy_set_header   X-Real-IP $remote_addr;
+    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+  }
+  location /chat/ {
+    proxy_pass         http://chat:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header   Host $host;
+    proxy_set_header   X-Real-IP $remote_addr;
+    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+  }
+  location /payments/ {
+    proxy_pass         http://payments:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header   Host $host;
+    proxy_set_header   X-Real-IP $remote_addr;
+    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header   X-Forwarded-Proto $scheme;
+  }
+}

services/auth/Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip \
+ && pip install --no-cache-dir -r requirements.txt
+
+COPY src ./src
+COPY alembic.ini ./
+COPY alembic ./alembic
+COPY docker-entrypoint.sh ./
+ENV PYTHONPATH=/app/src
+EXPOSE 8000
+CMD ["./docker-entrypoint.sh"]

services/auth/alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+timezone = UTC
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers = console
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stdout,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s %(name)s %(message)s

services/auth/alembic/env.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+import os
+import sys
+from logging.config import fileConfig
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Add ./src to sys.path
+BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+SRC_DIR = os.path.join(BASE_DIR, "src")
+if SRC_DIR not in sys.path:
+    sys.path.append(SRC_DIR)
+
+from app.db.session import Base  # noqa
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+DATABASE_URL = os.getenv("DATABASE_URL")
+
+def run_migrations_offline() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        compare_type=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+def run_migrations_online() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    connectable = engine_from_config(
+        {"sqlalchemy.url": url},
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata, compare_type=True)
+        with context.begin_transaction():
+            context.run_migrations()
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

services/auth/docker-entrypoint.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -e
+# Run migrations (no-op if no revisions yet)
+alembic -c alembic.ini upgrade head || true
+# Start app
+exec uvicorn app.main:app --host 0.0.0.0 --port 8000

services/auth/requirements.txt

@@ -0,0 +1,10 @@
+fastapi
+uvicorn[standard]
+SQLAlchemy>=2.0
+psycopg2-binary
+alembic
+pydantic>=2
+pydantic-settings
+python-dotenv
+httpx>=0.27
+pytest

services/auth/src/app/api/routes/ping.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/ping")
+def ping():
+    return {"ping": "pong"}

services/auth/src/app/core/config.py

@@ -0,0 +1,9 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    database_url: str | None = None
+
+    class Config:
+        env_prefix = ""
+        env_file = ".env"
+        case_sensitive = False

services/auth/src/app/db/session.py

@@ -0,0 +1,26 @@
+import os
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker, DeclarativeBase
+from typing import Generator
+
+DEFAULT_DB_URL = "postgresql+psycopg2://postgres:postgres@postgres:5432/auth_db"
+
+class Base(DeclarativeBase):
+    pass
+
+DATABASE_URL = os.getenv("DATABASE_URL", DEFAULT_DB_URL)
+
+engine = create_engine(
+    DATABASE_URL,
+    pool_pre_ping=True,
+    future=True,
+)
+
+SessionLocal = sessionmaker(bind=engine, autoflush=False, autocommit=False)
+
+def get_db() -> Generator:
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

services/auth/src/app/main.py

@@ -0,0 +1,11 @@
+from fastapi import FastAPI
+from .api.routes.ping import router as ping_router
+
+app = FastAPI(title="AUTH Service")
+
+@app.get("/health")
+def health():
+    return {"status": "ok", "service": "auth"}
+
+# v1 API
+app.include_router(ping_router, prefix="/v1")

services/auth/src/app/models/base.py

@@ -0,0 +1 @@
+from app.db.session import Base  # re-export for convenience

services/auth/src/app/repositories/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseRepository:
+    def __init__(self, db: Session):
+        self.db = db

services/auth/src/app/schemas/common.py

@@ -0,0 +1,4 @@
+from pydantic import BaseModel
+
+class Message(BaseModel):
+    message: str

services/auth/src/app/services/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseService:
+    def __init__(self, db: Session):
+        self.db = db

services/auth/tests/test_health.py

@@ -0,0 +1,10 @@
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+def test_health():
+    r = client.get("/health")
+    assert r.status_code == 200
+    data = r.json()
+    assert data.get("status") == "ok"

services/chat/Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip \
+ && pip install --no-cache-dir -r requirements.txt
+
+COPY src ./src
+COPY alembic.ini ./
+COPY alembic ./alembic
+COPY docker-entrypoint.sh ./
+ENV PYTHONPATH=/app/src
+EXPOSE 8000
+CMD ["./docker-entrypoint.sh"]

services/chat/alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+timezone = UTC
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers = console
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stdout,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s %(name)s %(message)s

services/chat/alembic/env.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+import os
+import sys
+from logging.config import fileConfig
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Add ./src to sys.path
+BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+SRC_DIR = os.path.join(BASE_DIR, "src")
+if SRC_DIR not in sys.path:
+    sys.path.append(SRC_DIR)
+
+from app.db.session import Base  # noqa
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+DATABASE_URL = os.getenv("DATABASE_URL")
+
+def run_migrations_offline() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        compare_type=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+def run_migrations_online() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    connectable = engine_from_config(
+        {"sqlalchemy.url": url},
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata, compare_type=True)
+        with context.begin_transaction():
+            context.run_migrations()
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

services/chat/docker-entrypoint.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -e
+# Run migrations (no-op if no revisions yet)
+alembic -c alembic.ini upgrade head || true
+# Start app
+exec uvicorn app.main:app --host 0.0.0.0 --port 8000

services/chat/requirements.txt

@@ -0,0 +1,10 @@
+fastapi
+uvicorn[standard]
+SQLAlchemy>=2.0
+psycopg2-binary
+alembic
+pydantic>=2
+pydantic-settings
+python-dotenv
+httpx>=0.27
+pytest

services/chat/src/app/api/routes/ping.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/ping")
+def ping():
+    return {"ping": "pong"}

services/chat/src/app/core/config.py

@@ -0,0 +1,9 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    database_url: str | None = None
+
+    class Config:
+        env_prefix = ""
+        env_file = ".env"
+        case_sensitive = False

services/chat/src/app/db/session.py

@@ -0,0 +1,26 @@
+import os
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker, DeclarativeBase
+from typing import Generator
+
+DEFAULT_DB_URL = "postgresql+psycopg2://postgres:postgres@postgres:5432/chat_db"
+
+class Base(DeclarativeBase):
+    pass
+
+DATABASE_URL = os.getenv("DATABASE_URL", DEFAULT_DB_URL)
+
+engine = create_engine(
+    DATABASE_URL,
+    pool_pre_ping=True,
+    future=True,
+)
+
+SessionLocal = sessionmaker(bind=engine, autoflush=False, autocommit=False)
+
+def get_db() -> Generator:
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

services/chat/src/app/main.py

@@ -0,0 +1,11 @@
+from fastapi import FastAPI
+from .api.routes.ping import router as ping_router
+
+app = FastAPI(title="CHAT Service")
+
+@app.get("/health")
+def health():
+    return {"status": "ok", "service": "chat"}
+
+# v1 API
+app.include_router(ping_router, prefix="/v1")

services/chat/src/app/models/base.py

@@ -0,0 +1 @@
+from app.db.session import Base  # re-export for convenience

services/chat/src/app/repositories/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseRepository:
+    def __init__(self, db: Session):
+        self.db = db

services/chat/src/app/schemas/common.py

@@ -0,0 +1,4 @@
+from pydantic import BaseModel
+
+class Message(BaseModel):
+    message: str

services/chat/src/app/services/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseService:
+    def __init__(self, db: Session):
+        self.db = db

services/chat/tests/test_health.py

@@ -0,0 +1,10 @@
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+def test_health():
+    r = client.get("/health")
+    assert r.status_code == 200
+    data = r.json()
+    assert data.get("status") == "ok"

services/match/Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip \
+ && pip install --no-cache-dir -r requirements.txt
+
+COPY src ./src
+COPY alembic.ini ./
+COPY alembic ./alembic
+COPY docker-entrypoint.sh ./
+ENV PYTHONPATH=/app/src
+EXPOSE 8000
+CMD ["./docker-entrypoint.sh"]

services/match/alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+timezone = UTC
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers = console
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stdout,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s %(name)s %(message)s

services/match/alembic/env.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+import os
+import sys
+from logging.config import fileConfig
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Add ./src to sys.path
+BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+SRC_DIR = os.path.join(BASE_DIR, "src")
+if SRC_DIR not in sys.path:
+    sys.path.append(SRC_DIR)
+
+from app.db.session import Base  # noqa
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+DATABASE_URL = os.getenv("DATABASE_URL")
+
+def run_migrations_offline() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        compare_type=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+def run_migrations_online() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    connectable = engine_from_config(
+        {"sqlalchemy.url": url},
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata, compare_type=True)
+        with context.begin_transaction():
+            context.run_migrations()
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

services/match/docker-entrypoint.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -e
+# Run migrations (no-op if no revisions yet)
+alembic -c alembic.ini upgrade head || true
+# Start app
+exec uvicorn app.main:app --host 0.0.0.0 --port 8000

services/match/requirements.txt

@@ -0,0 +1,10 @@
+fastapi
+uvicorn[standard]
+SQLAlchemy>=2.0
+psycopg2-binary
+alembic
+pydantic>=2
+pydantic-settings
+python-dotenv
+httpx>=0.27
+pytest

services/match/src/app/api/routes/ping.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/ping")
+def ping():
+    return {"ping": "pong"}

services/match/src/app/core/config.py

@@ -0,0 +1,9 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    database_url: str | None = None
+
+    class Config:
+        env_prefix = ""
+        env_file = ".env"
+        case_sensitive = False

services/match/src/app/db/session.py

@@ -0,0 +1,26 @@
+import os
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker, DeclarativeBase
+from typing import Generator
+
+DEFAULT_DB_URL = "postgresql+psycopg2://postgres:postgres@postgres:5432/match_db"
+
+class Base(DeclarativeBase):
+    pass
+
+DATABASE_URL = os.getenv("DATABASE_URL", DEFAULT_DB_URL)
+
+engine = create_engine(
+    DATABASE_URL,
+    pool_pre_ping=True,
+    future=True,
+)
+
+SessionLocal = sessionmaker(bind=engine, autoflush=False, autocommit=False)
+
+def get_db() -> Generator:
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

services/match/src/app/main.py

@@ -0,0 +1,11 @@
+from fastapi import FastAPI
+from .api.routes.ping import router as ping_router
+
+app = FastAPI(title="MATCH Service")
+
+@app.get("/health")
+def health():
+    return {"status": "ok", "service": "match"}
+
+# v1 API
+app.include_router(ping_router, prefix="/v1")

services/match/src/app/models/base.py

@@ -0,0 +1 @@
+from app.db.session import Base  # re-export for convenience

services/match/src/app/repositories/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseRepository:
+    def __init__(self, db: Session):
+        self.db = db

services/match/src/app/schemas/common.py

@@ -0,0 +1,4 @@
+from pydantic import BaseModel
+
+class Message(BaseModel):
+    message: str

services/match/src/app/services/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseService:
+    def __init__(self, db: Session):
+        self.db = db

services/match/tests/test_health.py

@@ -0,0 +1,10 @@
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+def test_health():
+    r = client.get("/health")
+    assert r.status_code == 200
+    data = r.json()
+    assert data.get("status") == "ok"

services/payments/Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip \
+ && pip install --no-cache-dir -r requirements.txt
+
+COPY src ./src
+COPY alembic.ini ./
+COPY alembic ./alembic
+COPY docker-entrypoint.sh ./
+ENV PYTHONPATH=/app/src
+EXPOSE 8000
+CMD ["./docker-entrypoint.sh"]

services/payments/alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+timezone = UTC
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers = console
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stdout,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s %(name)s %(message)s

services/payments/alembic/env.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+import os
+import sys
+from logging.config import fileConfig
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Add ./src to sys.path
+BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+SRC_DIR = os.path.join(BASE_DIR, "src")
+if SRC_DIR not in sys.path:
+    sys.path.append(SRC_DIR)
+
+from app.db.session import Base  # noqa
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+DATABASE_URL = os.getenv("DATABASE_URL")
+
+def run_migrations_offline() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        compare_type=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+def run_migrations_online() -> None:
+    url = DATABASE_URL
+    if not url:
+        raise RuntimeError("DATABASE_URL is not set")
+    connectable = engine_from_config(
+        {"sqlalchemy.url": url},
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata, compare_type=True)
+        with context.begin_transaction():
+            context.run_migrations()
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

services/payments/docker-entrypoint.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -e
+# Run migrations (no-op if no revisions yet)
+alembic -c alembic.ini upgrade head || true
+# Start app
+exec uvicorn app.main:app --host 0.0.0.0 --port 8000

services/payments/requirements.txt

@@ -0,0 +1,10 @@
+fastapi
+uvicorn[standard]
+SQLAlchemy>=2.0
+psycopg2-binary
+alembic
+pydantic>=2
+pydantic-settings
+python-dotenv
+httpx>=0.27
+pytest

services/payments/src/app/api/routes/ping.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/ping")
+def ping():
+    return {"ping": "pong"}

services/payments/src/app/core/config.py

@@ -0,0 +1,9 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    database_url: str | None = None
+
+    class Config:
+        env_prefix = ""
+        env_file = ".env"
+        case_sensitive = False

services/payments/src/app/db/session.py

@@ -0,0 +1,26 @@
+import os
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker, DeclarativeBase
+from typing import Generator
+
+DEFAULT_DB_URL = "postgresql+psycopg2://postgres:postgres@postgres:5432/payments_db"
+
+class Base(DeclarativeBase):
+    pass
+
+DATABASE_URL = os.getenv("DATABASE_URL", DEFAULT_DB_URL)
+
+engine = create_engine(
+    DATABASE_URL,
+    pool_pre_ping=True,
+    future=True,
+)
+
+SessionLocal = sessionmaker(bind=engine, autoflush=False, autocommit=False)
+
+def get_db() -> Generator:
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

services/payments/src/app/main.py

@@ -0,0 +1,11 @@
+from fastapi import FastAPI
+from .api.routes.ping import router as ping_router
+
+app = FastAPI(title="PAYMENTS Service")
+
+@app.get("/health")
+def health():
+    return {"status": "ok", "service": "payments"}
+
+# v1 API
+app.include_router(ping_router, prefix="/v1")

services/payments/src/app/models/base.py

@@ -0,0 +1 @@
+from app.db.session import Base  # re-export for convenience

services/payments/src/app/repositories/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import Session
+
+class BaseRepository:
+    def __init__(self, db: Session):
+        self.db = db

services/payments/src/app/schemas/common.py

@@ -0,0 +1,4 @@
+from pydantic import BaseModel
+
+class Message(BaseModel):
+    message: str