Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
70 lines
9.1 KiB
Markdown
70 lines
9.1 KiB
Markdown
# Status
|
||
|
||
Phase plan: docs/BRIEF.md §22. Windows behaviour is verified on CI (`windows-latest`); everything else also on Linux.
|
||
|
||
| Phase | State |
|
||
|---|---|
|
||
| 0 Bootstrap | Done: solution, rules, Titano.Testing, zero-package guard, i18n, WPF shell, server skeleton, Docker, icons, CI. |
|
||
| 1 Metadata and imaging | Done: metadata parsers, managed codecs, native RAW development (DNG, CR2, NEF, ARW, PEF, RAF), WIC provider and codec inventory, decode tiers, thumbnails and proxies, `diagnose`. Real-camera fixtures wait for verified raw.pixls.us URLs (CI warns per missing sample). |
|
||
| 2 Data layer and archive | Done: SQLite binding, PostgreSQL wire client, migrations, repositories, job engine, archive layout, sidecars, scan, rebuild, verify, duplicates, orphans, adopt, mass rename. Gate measured: a 100,000-frame archive (400 sequences of 250 photos) rebuilds from sidecars into an index identical in every column in 1.8 s on SQLite and 4.7 s on PostgreSQL (budget 120 s). |
|
||
| 3 Library and Archive manager | Done: Library (virtualised grid and list, timeline with year bands, filters, saved views, quick actions, mass bar, *Delete…* into the archive's trash with a dry run, typed confirmation and Undo, cards for server-only sequences), Archive manager (tree, health, statistics charts, maintenance with *Trash…* and restore, verify, duplicates, orphans, adopt, mass rename and move with dry runs), Jobs, Settings, Welcome, Server and About. Gate measured on 500,000 photos: Library open 259 ms on SQLite and 181 ms on PostgreSQL on a new connection pool (warm OS cache; budget 1 s); every filter, search, sort and next page ≤ 6.4 ms (budget 200 ms). |
|
||
| 4 Card import | Done: device detection, card pool and camera profiles, plan with sessions (merge and split), hash-verified copy, post-actions (verified delete, format behind a typed confirmation, eject), auto-import, Archive, Folder and Server destinations. Gate: import from a simulated card folder end to end in tests; delete and format refuse any photo the import did not verify; screenshots on `ci-screenshots`. |
|
||
| 5 Analysis advisor | Done: light and deep analysis, reports and section charts, recommendations with localised reasons, sequence presets, Auto/manual controls and Optimise in the editor. Gate: golden recommendations for synthetic sequences; every reason key exists in `en` and `it` (`i18n check`); deep analysis streams with checkpoints and resumes after a restart. |
|
||
| 6 Engine, encoding, editor | Done: render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 with managed fallbacks; the sequence editor (Frames, Exposure, Camera, Motion and Export tabs, preview tools, section charts, curve editor, undo/redo, batch export) for local and server sequences. Gate: self-test suite green; the in-house inspector validates the containers the tests write; the encoder in use is logged. Playback: MediaPlayer opens the Media Foundation output and a source reader decodes its first frame (Windows tests). The pixel diff of every `--capture` screen against `tests/visual/baselines` (`screenshots diff`, BRIEF §20.2) is wired into CI but not armed: no baseline is committed yet, so the step compares nothing and only warns until the first baselines are accepted from `ci-screenshots` (Next steps). |
|
||
| 7 Server, sync, uploader | Done: server (API, auth, uploads, jobs, render nodes, events, admin panel with light and dark themes, Windows service), Uploader, client sync (sync table, conflicts with *Save both*, proxies kept offline, metered pause), server sequences edited with proxies and rendered where the originals are, this PC as a render node. Gate covered in-process: a sequence uploaded from one PC downloads identically on another, interrupted uploads and downloads resume, server events update a PC, renders run on a node and on the server's managed fallback, jobs resume after a restart, sign-ins and administrative actions are audited. The run with two real PCs and the Uploader against the Docker server is part of the release test. |
|
||
| 8 Release readiness | Release pipeline end to end (installers, portable and server zips, SHA256SUMS, release notes, optional signing, multi-arch GHCR image, public releases repository content), update check with verified download, scrubbed diagnostics bundles (desktop and server), performance gates, 38 cultures (`en`, `it` and 36 machine translations with glossaries and independent reviews), RTL pass (`ar`, `he`: mirrored windows, left-to-right islands for media, charts, numbers and paths; any right-to-left culture added later follows), accessibility pass (names, live regions, keyboard paths for charts and the curve editor). CI installs the packed installers silently on a clean `windows-latest` runner, runs the installed programs, upgrades in place and uninstalls (files, Add/Remove Programs, shortcuts, file type, user data kept, exit codes). Pending: a tagged pre-release published from CI, the interactive install on a real PC, Unraid template validation on a real server. |
|
||
| 9 Monetization | Not started: requires explicit approval (§22). |
|
||
|
||
## Verification (2026-10-12)
|
||
|
||
A full audit against the brief, `CLAUDE.md`, the UI kit, the tests and the Docker and client setups confirmed 71
|
||
defects with independent verifiers. A second pass over the fixes confirmed 37 more (proxies and decode tiers, project
|
||
positions crossing copies through sync, server scans and maintenance, desktop settings and polling, a portable copy
|
||
inside OneDrive, setup and deployment guidance), and a third pass 16 more (editors open while photos arrive, partial
|
||
writers of the index row, image passes after another writer's import, smaller error-text and documentation gaps). All
|
||
are fixed, each with tests (rows dated 2026-10-12 in DECISIONS and
|
||
CHANGELOG), except that the screenshot diff (BRIEF §20.2 visual regression) gates nothing until its first baselines
|
||
are committed (Next steps). The Docker image was built and run with PostgreSQL 17, a fresh archive folder and
|
||
remapped ports; the client installers are installed, run, upgraded and removed on `windows-latest` by the
|
||
`installer` CI job.
|
||
|
||
## How to try it
|
||
|
||
```
|
||
dotnet build Titano.slnx -c Release
|
||
dotnet run --project src/Titano.Server # https://localhost:8443/admin (set TITANO_DATA_PATH/TITANO_ARCHIVE_PATH)
|
||
src/Titano.App/bin/Release/net10.0-windows/Titano.exe # Windows
|
||
src/Titano.Uploader/bin/Release/net10.0-windows/Titano.Uploader.exe # Windows
|
||
docker compose -f deploy/docker/docker-compose.yml up -d # server + PostgreSQL 17
|
||
TITANO_PERF=1 dotnet run --project tests/Titano.Data.Tests -c Release -- --filter category:perf --verbose # performance gates
|
||
src/Titano.App/bin/Release/net10.0-windows/Titano.exe --capture out/screenshots # every screen with sample data, plus Arabic (RTL)
|
||
```
|
||
|
||
- Diagnostics: Settings › Advanced › Diagnostics › *Export bundle* (desktop) or admin panel › Logs › *Diagnostics* (server,
|
||
`GET /api/v1/server/diagnostics`). Open the zip: logs, reports, settings and failed jobs, no passwords or tokens.
|
||
- Update download: About › *Check for updates*, then *Download* when a newer release exists; the verified setup (the
|
||
portable zip in a portable copy) appears in Explorer. *Cancel* stops it; the next *Download* resumes.
|
||
- Import: Import › *Folder…* (any folder of photos stands in for a card) › *Import*; the sequence opens from the
|
||
Library. Delete a sequence with *Delete…* (dry run first) and bring it back from Archive › *Trash…*.
|
||
- Sync: sign in on Server (trust the certificate once); the sync table lists every sequence of both sides. Open a
|
||
server-only sequence from the Library to edit it with proxies; *Render* runs on the server or a render node.
|
||
- Language: Settings › General › *Language* switches at once; Arabic and Hebrew mirror every window.
|
||
- Settings: Import, Analysis and Formats pages; Archive rows edit the open archive's `archive.json`; Advanced ›
|
||
*Restore* picks a daily backup, compares it with the index and restores it at the next start.
|
||
- Project files: Export › *Save project file* writes a `.titano` file; opening it (double-click or `Titano.exe <file>`)
|
||
opens the sequence with those settings in the running Titano.
|
||
- Notifications: minimise Titano and insert a card or finish a job: a Windows notification appears; Ctrl+1…6 and
|
||
Ctrl+, switch sections.
|
||
|
||
## Next steps (Phase 8 gate)
|
||
|
||
1. Arm the screenshot diff: from the `ci-screenshots` commit of the first green `windows-latest` run at the current
|
||
HEAD, run `dotnet run --project src/Titano.Tools -- screenshots accept <dir>` and commit the PNGs to
|
||
`tests/visual/baselines` (its README says how). From then on a visual change, or a screen without a baseline,
|
||
fails CI.
|
||
2. Create the public repository (`<owner>/titano-releases`), add the `RELEASES_TOKEN` secret, push a `v0.x.y-rc.1`
|
||
tag and check the release, the public repository content and the GHCR image (set it public once).
|
||
3. On Windows: install, upgrade over the previous version, uninstall (with and without user data), silent mode.
|
||
4. Unraid: add the template repository, install with the official PostgreSQL template, reach the WebUI.
|
||
5. Native-speaker review of the machine translations where users report wording (`i18n export` per language).
|