No description
Issues: per-project numbers, statuses (open, accepted, rejected, withdrawn, duplicate), feature links, edits, and a timeline of comments and events. From an issue, collaborators create or update a feature with the revision tied to the issue and an option to accept it. Comments: general and line-anchored threads on features, one discussion thread per issue, edit history, tombstone deletes, resolve, and promoting a feature thread to an issue. Line threads attach to top-level Markdown blocks and go outdated only when the text changes. HTMX swaps threads in place with focus management; every action also works as a plain form post. Markdown headings are re-levelled so user text never skips heading levels on the page. The example flow from concept.md (steps 1-7) is covered end to end in tests/test_example_flow.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .forgejo/workflows | ||
| bin | ||
| config | ||
| docs | ||
| intent | ||
| static | ||
| templates | ||
| tests | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| .python-version | ||
| compose.yaml | ||
| Dockerfile | ||
| fly.toml | ||
| litestream.yml | ||
| manage.py | ||
| pyproject.toml | ||
| README.md | ||
| uv.lock | ||
Intent
Track the why behind features, across implementations. See docs/concept.md and docs/plan.md.
Local development
With uv:
uv sync
uv run python manage.py migrate
uv run python manage.py runserver
Or with Docker:
docker compose up --build
Then open http://localhost:8000. Data lives in data/ (uv) or the data volume (Docker).
Checks:
uv run ruff check . && uv run ruff format --check . && uv run pytest
Production
Fly.io, one machine with a volume at /data. bin/start restores the database from B2 if the volume is empty, runs migrations, and starts gunicorn under Litestream.
Secrets (fly secrets set):
| Name | Purpose |
|---|---|
DJANGO_SECRET_KEY |
Django secret key |
LITESTREAM_BUCKET, LITESTREAM_ENDPOINT, LITESTREAM_ACCESS_KEY_ID, LITESTREAM_SECRET_ACCESS_KEY |
B2 backup bucket |
BUCKET_NAME, AWS_* |
Tigris uploads; set by fly storage create |
SENTRY_DSN |
Optional error reporting |
Restore drill: create a fresh volume, deploy, and confirm bin/start logs a restore before migrating.