No description
Files: prototype and documentation files on features, with versions. Adding, replacing or removing a file is a feature revision with a change note. Types come from the extension; uploads are capped at 25 MB and stored under opaque paths. Every file URL checks project access, then redirects to a short-lived signed URL on the bucket, or streams with nosniff and a CSP sandbox when no bucket is configured. HTML prototypes run in a sandboxed iframe without same-origin access. Threads: whole-file threads and pins at a point on an image, drawn as an SVG overlay in percentages. Pins are placed with number fields, or by clicking the image with JS. Implementations: name, link and status, plus a per-feature status grid stamped with the feature revision, marked behind when the feature changes, and confirmable without changing the status. 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.