- 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>
2.3 KiB
2.3 KiB
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.
Related documentation
- ../decisions/: Architectural Decision Records (ADRs)
- ../design/: designs, questions and reports per version
- ../standards/: coding, testing and versioning standards
- ../projectplan/: backlog and release plans
Last Updated: 2026-11-03 (v2.10.1)