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

alembic/versions/bc7d400995d3_erstes_schema_kategorien_groessen_items_.py

@@ -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 ###