Add core data model (12 tables) and initial Alembic migration

All core entities from ARCHITECTURE §5: tenancy (User, Tree, TreeMembership), people (Person, Name, Relationship), facts (Event, Place, PlaceName), provenance (Source, Citation), and the append-only AuditEntry. Cross-cutting mixins give every row a UUID key, timestamps, soft delete, and (where tree-owned) a tree_id for uniform tenant isolation.

Modeling choices: parentage as qualified edges (biological/adoptive/step/foster/donor/guardian) so non-traditional families are first-class; events keep both a verbatim date string and a normalized start/end range; closed sets are PG enums while GEDCOM-extensible vocabularies (event/name/source type) stay strings; CHECK constraints enforce single-subject events and single-target citations. Place is tree-scoped in Phase 0 (see ARCHITECTURE note). The migration is verified reversible (upgrade/downgrade drops tables and enum types) and matches the models (alembic check clean); applied on the deploy target. Dockerfile now ships migrations.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Justin Paul <justin@jpaul.me>

This commit is contained in:

Justin Paul

2026-06-06 10:40:00 -04:00

parent 03124027fe

commit 297cb797d6

18 changed files with 942 additions and 1 deletions

									
										backend/Dockerfile
									
		+3
		-1
	
												View File
												
				@@ -17,8 +17,10 @@ COPY pyproject.toml uv.lock* ./

				RUN --mount=type=cache,target=/root/.cache/uv \

				    uv sync --no-dev

				# Application source (project is package=false, so no install step needed).

				# Application source + migrations (project is package=false, no install step).

				COPY app ./app

				COPY alembic.ini ./alembic.ini

				COPY migrations ./migrations

				EXPOSE 8000