Phase 1: Datenmodell, CRUD-API und Stammdaten

FastAPI mit SQLAlchemy und SQLite, Migrationen über Alembic. Die Endpunkte aus projekt.md für items, categories und sizes stehen samt Reservierung; Bilder und Anmeldung folgen in Phase 2 und 3. Umgesetzt wie in Plan.md festgelegt: - Feste Wertelisten als Enum UND als CHECK in der Datenbank. Die CHECK-Bedingung ist der eigentliche Schutz: an SQLAlchemy vorbei (Import, sqlite3 von Hand) käme sonst "Gril" durch, und die Filter griffen still nicht mehr. - Status "draft" für den Stapel-Import. Entwürfe erscheinen weder in der Galerie noch in GET /items, solange nicht ausdrücklich status=draft angefragt wird, und lassen sich nicht reservieren. - Titel ist freiwillig und wird sonst beim ANZEIGEN aus Kategorie und Grösse gebildet ("Jacken 98/104") - nicht beim Speichern, damit er einer späteren Korrektur der Grösse folgt. - reservation_token: nur wer es hat, kann die eigene Reservierung aufheben. Verglichen mit compare_digest, gelöscht beim Freigeben und beim Erledigen, damit ein alter Link nicht später eine fremde Reservierung aufhebt. - Eigene sizes-Tabelle mit sort_order statt SELECT DISTINCT: sonst stünde "104" vor "56" und jeder Tippfehler würde zur Filteroption. - Pagination auf GET /items, in projekt.md nicht vorgesehen. Zwei SQLite-Eigenheiten, die leicht untergehen: foreign_keys ist standardmässig AUS (ohne PRAGMA greift ON DELETE CASCADE nicht), und check_same_thread muss für FastAPI abgeschaltet werden. Beides in database.py, dazu WAL fürs gleichzeitige Lesen. 24 Tests, alle grün. Zusätzlich von Hand geprüft: Migration anwenden, Eintrag anlegen, reservieren, ohne Token freigeben (403), mit Token freigeben (200), Swagger UI erreichbar. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GR4bNaj9GtRu57J4Niii8o
2026-08-29 22:00:58 +02:00
parent 3cf6903df5
commit 3d7b7c706a
22 changed files with 1443 additions and 0 deletions
@@ -0,0 +1,59 @@
+"""Alembic-Umgebung.
+
+Die Datenbank-URL kommt aus app/config.py statt aus alembic.ini, damit sie
+nur an einer Stelle gepflegt wird und im Container automatisch stimmt.
+"""
+
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+from app.config import einstellungen
+from app.database import Basis
+
+# Modelle importieren, damit Alembic sie in Basis.metadata sieht.
+from app import models  # noqa: F401
+
+config = context.config
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+config.set_main_option("sqlalchemy.url", einstellungen().datenbank_url)
+target_metadata = Basis.metadata
+
+
+def run_migrations_offline() -> None:
+    context.configure(
+        url=config.get_main_option("sqlalchemy.url"),
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        # SQLite kann Spalten nicht ohne Weiteres ändern; Alembic baut die
+        # Tabelle dann im Hintergrund neu.
+        render_as_batch=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            render_as_batch=True,
+        )
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()
@@ -0,0 +1,24 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}
@@ -0,0 +1,92 @@
+"""Erstes Schema: Kategorien, Groessen, Items, Bilder
+
+Revision ID: bc7d400995d3
+Revises: 
+Create Date: 2026-08-29 19:59:57.751289
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+revision: str = 'bc7d400995d3'
+down_revision: Union[str, None] = None
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('categories',
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('name', sa.String(length=50), nullable=False),
+    sa.Column('slug', sa.String(length=50), nullable=False),
+    sa.PrimaryKeyConstraint('id'),
+    sa.UniqueConstraint('name'),
+    sa.UniqueConstraint('slug')
+    )
+    op.create_table('sizes',
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('label', sa.String(length=20), nullable=False),
+    sa.Column('sort_order', sa.Integer(), nullable=False),
+    sa.PrimaryKeyConstraint('id'),
+    sa.UniqueConstraint('label')
+    )
+    op.create_table('items',
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('title', sa.String(length=100), nullable=True),
+    sa.Column('description', sa.Text(), nullable=True),
+    sa.Column('size', sa.String(length=20), nullable=True),
+    sa.Column('gender', sa.String(length=10), nullable=False),
+    sa.Column('season', sa.String(length=15), nullable=False),
+    sa.Column('condition', sa.String(length=20), nullable=False),
+    sa.Column('status', sa.String(length=20), nullable=False),
+    sa.Column('category_id', sa.Integer(), nullable=True),
+    sa.Column('reserved_by', sa.String(length=100), nullable=True),
+    sa.Column('reservation_token', sa.String(length=64), nullable=True),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), nullable=False),
+    sa.CheckConstraint("condition IN ('new', 'very_good', 'good', 'worn')", name='ck_items_condition'),
+    sa.CheckConstraint("gender IN ('boy', 'girl', 'unisex')", name='ck_items_gender'),
+    sa.CheckConstraint("season IN ('spring_summer', 'autumn_winter', 'all_year')", name='ck_items_season'),
+    sa.CheckConstraint("status = 'draft' OR (size IS NOT NULL AND category_id IS NOT NULL)", name='ck_items_vollstaendig_wenn_veroeffentlicht'),
+    sa.CheckConstraint("status = 'reserved' OR (reserved_by IS NULL AND reservation_token IS NULL)", name='ck_items_reservierung_nur_wenn_reserviert'),
+    sa.CheckConstraint("status IN ('draft', 'available', 'reserved', 'given_away')", name='ck_items_status'),
+    sa.ForeignKeyConstraint(['category_id'], ['categories.id'], ondelete='RESTRICT'),
+    sa.PrimaryKeyConstraint('id')
+    )
+    with op.batch_alter_table('items', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_items_category_id'), ['category_id'], unique=False)
+        batch_op.create_index(batch_op.f('ix_items_status'), ['status'], unique=False)
+        batch_op.create_index('ix_items_status_size', ['status', 'size'], unique=False)
+
+    op.create_table('item_images',
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('item_id', sa.Integer(), nullable=False),
+    sa.Column('image_url', sa.String(length=255), nullable=False),
+    sa.Column('is_primary', sa.Boolean(), nullable=False),
+    sa.ForeignKeyConstraint(['item_id'], ['items.id'], ondelete='CASCADE'),
+    sa.PrimaryKeyConstraint('id')
+    )
+    with op.batch_alter_table('item_images', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_item_images_item_id'), ['item_id'], unique=False)
+
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    with op.batch_alter_table('item_images', schema=None) as batch_op:
+        batch_op.drop_index(batch_op.f('ix_item_images_item_id'))
+
+    op.drop_table('item_images')
+    with op.batch_alter_table('items', schema=None) as batch_op:
+        batch_op.drop_index('ix_items_status_size')
+        batch_op.drop_index(batch_op.f('ix_items_status'))
+        batch_op.drop_index(batch_op.f('ix_items_category_id'))
+
+    op.drop_table('items')
+    op.drop_table('sizes')
+    op.drop_table('categories')
+    # ### end Alembic commands ###