docs: architecture notes for the screenshot gate, playback tests and language guard

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-12 10:34:33 +00:00
1 parent bef602a9c4
commit 16a65e536d
1 file changed
+6 -3
+6 -3
View File
@@ -226,7 +226,7 @@ run as server jobs whose progress comes from the events.
for PostgreSQL integration tests.
- Classes run in parallel. A test that changes or observes process-wide state (the UI language, unobserved task
exceptions, the managed heap) belongs in a `[Serial]` class; the App and Core test programs fail a test outside one
that switches the language away from English (`TestContext.Current`).
that switches the language away from English, after switching it back (`TestContext.Current`).
- Put tests under `tests/Titano.<Area>.Tests/<Folder>/<Thing>Tests.cs`, mirroring the source folder.
- `Titano.App.Tests` targets net10.0-windows and runs on Windows CI only: keep logic in plain classes.
- Fixtures are synthetic and generated in code wherever possible; tiny binary fixtures may go in `tests/fixtures/`
@@ -240,8 +240,11 @@ run as server jobs whose progress comes from the events.
- `Titano.Tools.Tests` covers the tools whose output CI relies on (fixtures annotations and exit codes, the screenshot
diff) and the test runner's outcomes.
- Visual regression: CI compares the `--capture` screenshots with `tests/visual/baselines` (`Titano.Tools screenshots
diff`; its README says how baselines are added). The capture draws the same pixels on any day: the sample's clock
is fixed, formats are English and nothing animates.
diff`; its README says how baselines are added). Once any baseline is committed, a screen without one fails too;
before that the step warns that it compared nothing. The capture draws the same pixels on any day: the sample's
clock is fixed, formats are English and nothing animates.
- Media Foundation output plays back (`Titano.Core.Windows.Tests`): MediaPlayer opens it where Windows Media Player
is installed (skipped, with the reason, where it is not) and a source reader decodes its first frame everywhere.
- PostgreSQL: CI prepares the service containers with `.github/scripts/postgres-ci-setup.sh` (MD5, cleartext and
trust roles, TLS), so every authentication method and TLS mode of BRIEF §6.3 runs; `TITANO_TEST_PG_TLS=1` makes a
server without TLS fail the TLS tests.