Files
mivanchenko 3a20cb5d2b CI: run backoffice test suite on push/PR, document local test setup
Adds .gitea/workflows/test-backoffice.yml (paths-filtered to
backoffice/app/** and backoffice/db/**, self-hosted homelab runner,
plain git clone matching deploy-backoffice.yml's conventions) so a
regression no longer needs a human to notice it.

The psycopg[binary]==3.2.1 pin turned out to be correct, not stale: it
only ships wheels through cp312, so it resolves cleanly under the
project's python:3.12-slim target but not under newer interpreters.
Documented in requirements.txt and docs/agents/testing.md, along with
the fact that the suite spins up its own throwaway postgres:16-alpine
container (tests/conftest.py) with no manual DB setup required.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-03 17:34:43 +02:00

1.1 KiB

AGENTS.md

Guidance for AI agents working in this repo.

Agent skills

Issue tracker

Issues live in Gitea at https://git.mivanchenko.de/BPPP/smb-online/issues, created/read via the Gitea REST API (or the tea CLI) with a PAT that has issue scope, kept in .secrets/ and never committed. See docs/agents/issue-tracker.md.

Triage labels

Canonical roles, used verbatim as Gitea labels: categories bug / enhancement; states needs-triage · needs-info · ready-for-agent · ready-for-human · wontfix. Invoke triage with /mattpocock-skills:triage. See docs/agents/triage-labels.md.

Domain docs

Single-context: one CONTEXT.md + docs/adr/ at the repo root (created lazily when terms or decisions get resolved). See docs/agents/domain.md.

Testing

Backoffice tests need only Docker (a throwaway Postgres container is started for you) and a Python 3.12 venv — the psycopg[binary] pin has version-specific wheel availability, so use 3.12, not whatever python3 defaults to. Runs automatically in Gitea Actions on push/PR. See docs/agents/testing.md.