Files
StarPunk/docs/architecture/INDEX.md
T
PhilandClaude Opus 5.5 75946be7b2 maint: Dependency upgrades and High backlog items (v2.11.0)
- All dependencies to current releases (97 known vulnerabilities -> 0),
  Python 3.14, uv pinned, requirements-test.txt, lxml/dateutil pinned
- CSRF tokens on admin forms, logout and IndieAuth consent
- IndieAuth client and crosspost link-card fetches via safe_get
- FLASK_DEBUG/FLASK_ENV default off/production; image sets them
- Foreign keys enforced on pooled connections; migration 018 removes orphans
- Rate limits shared across processes (rate_limits, migration 019)
- datetime.utcnow() and sqlite3 default adapters replaced
- compose.yaml fixed; duplicate dev_auth.py and test.ini removed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 13:09:52 -07:00

2.3 KiB
Raw Blame History

Architecture Documentation Index

This directory describes the current design of StarPunk (v2.10.1). Per ../DOCUMENTATION.md it is updated at the end of each release. Decisions and their history are in ../decisions/; per-release designs and reports are in ../design/.

Documents

Document Description
overview.md System overview: purpose, request flow, modules and routes, background workers, storage, auth model, URL surface, caching, security posture
technology-stack.md Current runtime, Python dependencies, standards implemented, testing and CI
database.md SQLite schema after migrations 001–019, migration runner and its lock, connection pool
deployment.md Container image stages, CI workflow, release process, /data layout, reverse proxy, all environment variables
simplified-auth-architecture.md Admin login via OpenID Connect and the built-in IndieAuth server that issues Micropub tokens (ADR-064)
indieweb-protocols.md How Micropub, IndieAuth, Webmention, microformats2, WebSub and the feeds are implemented, with compliance status and known gaps
syndication-architecture.md Crossposting (POSSE) to GoToSocial, Bluesky and Threads: syndications table, worker, reconcile rules
technology-stack-legacy.md Historical: the original v0.x technology choices (IndieLogin era); not current

Where to start

  • New to the code: overview.md, then technology-stack.md.
  • Changing the schema: database.md (migrations must be safe inside one transaction).
  • Releasing or operating the site: deployment.md.
  • Working on auth, Micropub, Webmention or WebSub: simplified-auth-architecture.md and indieweb-protocols.md, plus the ADRs they link to.

Last Updated: 2026-11-03 (v2.10.1)