Skip to content

Simplify arch - #31

Merged
rattling merged 33 commits into
mainfrom
simplify-arch
Sep 14, 2025
Merged

rattling merged 33 commits into
mainfrom
simplify-arch

Conversation

@rattling

Copy link
Copy Markdown
Contributor

PR: Postgres + Pragmatic Architecture, Taxonomies/Tagging, Ingestion, Docs/DX

What changed

  • Storage/Search: Elasticsearch removed. Postgres FTS added (SQLite fallback via LIKE).
  • Backend: FastAPI routers for talks, taxonomies, tagging, ingestion, analytics, health.
  • Taxonomies/Tagging: CRUD for taxonomies/values; add/replace/remove talk tags; advanced search (ANY/ALL by tags).
  • Ingestion: Sessionize + Meetup full ingest; per‑source SyncStatus; incremental sync currently reuses full.
  • Migrations: Alembic initial schema; PG‑safe indexes (GIN only on PG).
  • Tests/DX: Tests green on SQLite; archive excluded via pytest.ini; Makefile tasks; small logging middleware.
  • Docs: HANDOFF.md (status/next steps) and ARCHITECTURE.md (layers, ERD, flow, search/ingest).

Architecture note

We explored a “very clean architecture” (applications/contracts/domain/infrastructure). That path increased complexity without clear benefit at this stage. It’s now archived under archive/CLEAN_ARCH/ and we’ve returned to a pragmatic layered design: routers → services → SQLAlchemy repo → models. This keeps boundaries clear while minimizing boilerplate.

Why

Simpler stack, tighter feedback loops, first‑class Postgres search, and faster contributor onboarding.

Verification

  • Test suite passes locally (SQLite): make test
  • API works with SQLite by default; Postgres supported via DATABASE_URL + make migrate
  • Manual ingest OK; interactive docs at /docs when running make dev

rattling added 30 commits July 12, 2025 18:20
…bic migrations (SQLite default, PG-ready FTS)
@rattling
rattling merged commit bcaf6a0 into main Sep 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant