diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 3636cdd1..a565bfba 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -9,7 +9,7 @@ Companion to `docs/BRIEF.md` (scope, behaviour) and `docs/ui/DESIGN.md` (looks). |---|---|---| | `src/Titano.Core` | net10.0 | Engine shared by every program: metadata, codecs, imaging, analysis, advisor, motion, render, video containers and managed encoders, archive format, naming, import planning, packaging, localization runtime, diagnostics, brand mark | | `src/Titano.Core.Windows` | net10.0-windows | WIC decoders and codec inventory, Media Foundation encoders, DXGI adapters, removable devices, DPAPI, shell launcher, window chrome, power (P/Invoke/COM only) | -| `src/Titano.Data` | net10.0 | `IDatabase`, SQLite binding, PostgreSQL wire client, migrations, repositories, the job engine, the archive engine (`Archiving`) and the analysis/render engine (`Processing`) | +| `src/Titano.Data` | net10.0 | `IDatabase`, SQLite binding, PostgreSQL wire client, migrations, repositories, the job engine, the archive engine (`Archiving`), the analysis/render engine (`Processing`) and the client sync engine (`Sync`) | | `src/Titano.Protocol` | net10.0 | API v1 DTOs, source-generated JSON context, typed `TitanoClient` with certificate pinning and bandwidth limiting | | `src/Titano.Server` | net10.0 (Web SDK) | ASP.NET Core minimal API, auth, uploads, sync, jobs, render nodes, events, embedded admin panel, Windows service host | | `src/Titano.Ui` | net10.0-windows (WPF) | Theme (DESIGN tokens), icons, standard and custom controls, visuals (charts, filmstrip, preview, curve editor, virtualizing grid), `Loc` markup extension, MVVM helpers | @@ -56,19 +56,47 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S | `Migrations/{sqlite,postgres}/NNNN_name.sql` | Embedded, applied in one transaction at open (`MigrationRunner`) | | `Repositories` | `TitanoDatabase` facade: archives, sequences, frames, tags, renders, jobs, cards, users, tokens, uploads, render nodes, settings, audit | | `Jobs` | `JobEngine`, `IJobHandler`, `IJobHandlerProvider`, `JobContext` (progress, checkpoints, follow-up jobs) | -| `Archiving` | `ArchiveService` (create/adopt/open), `ArchiveIndexer` (scan, rebuild), `ArchiveIngest` (uploads and imports), `ImportService`, `ArchiveVerifier`, `ArchiveImages`, `ArchiveMaintenance`, `MassRenamer`, job handlers | +| `Archiving` | `ArchiveService` (create/adopt/open), `ArchiveIndexer` (scan, rebuild), `ArchiveIngest` (uploads and imports), `ImportService`, `ArchiveVerifier`, `ArchiveImages`, `ArchiveMaintenance`, `MassRenamer`, `SequenceTrash` (delete into the archive's hidden trash with a dry run, restore; the folder moves back when the index step fails), job handlers | | `Processing` | `ProcessingService`, `SequenceAnalyser`, `SequenceRender`, `ProjectStore`, `RenderNodeClient`, job handlers | +| `Sync` | `SyncService` (sync table of one server: compare, link by content, settle conflicts, enqueue transfers), `SyncRules` (status, settings merge and differences, no I/O), `SyncLinkStore` (`sync_links`, `sync_state`), `SyncTransfers` and `SyncJobHandler` (resumable, hash-verified uploads and downloads as jobs; downloads commit through the archive ingest), `SyncAgent` (background comparison, server events, backoff, offline proxies), `ProxyCache` and `RemoteSequence` (server sequences opened with proxies), `ISyncRemote` (the server calls; `TitanoSyncRemote` over `TitanoClient`) | -### 2.3 Hosts +### 2.3 Titano.App areas + +| Folder | Content | +|---|---| +| `Shell` | `MainWindow`, `ShellViewModel` (rail, sections, first run), dialogs, `ErrorText` (the sentence of an error toast), `ScreenCapture` (`--capture` scenes), `SectionTemplates.xaml` (view model → view) | +| `Sections` | One `XxxView.xaml` + `XxxViewModel` per screen: Welcome, Library, Sequence (editor), Import, Archive, Jobs, Server, Settings, About | +| `Library` | Filter, facets, pager, timeline, saved views, quick and mass actions, remote cards and thumbnails, thumbnail cache, list export | +| `Editor` | `EditorSession` (project, undo/redo, saving, merges), `ISequenceSource` (`LocalSequenceSource`, `RemoteSequenceSource`), tabs (Frames, Exposure, Camera, Motion, Export), `PreviewRenderer`, `ExportPlanner`, `ExportSync`, `SavedCopies`, `SequenceJobs` | +| `Import` | `CardPool` (inserted cards, remembered cards, folders), camera profiles, plans and choices, destinations (archive, folder, server through `ServerImportSink`), card actions (verified delete, format, eject) | +| `Archive` | `CurrentArchive`, `ArchiveTree`, figures for the charts, maintenance reports, mass rename and move, delete and trash dialogs (`SequenceDeletion`, `DeletePlans`), `ArchiveFailures` | +| `Server` | `ServerSession`, `ConnectFlow` (trust on first use), `SyncHost` (sync engine, agent, metered hold, editor connections, Export Sync), sync table, `RemoteSequenceApi` | +| `Jobs`, `Settings`, `About` | Job list and buffering; settings rows, encoder inventory, language catalog, naming preview; update check and download | +| `Infrastructure` | `AppServices` (composition root), `AppSettings`, `AppEnvironment` (installed or portable), `UiLanguage`, `LiveRegion`, `RenderNodeHost`, `DiagnosticsBundle`, `ShellActions` (BRIEF §8.6), device monitor | +| `DesignTime` | `SampleData`: the archive, jobs and server the screenshots and smoke tests run on | + +### 2.4 Titano.Ui and Titano.Server + +| Folder | Content | +|---|---| +| `Ui/Themes`, `Ui/Theming` | DESIGN tokens (light, dark), typography, control styles, `ThemeManager` | +| `Ui/Controls` | `TitanoWindow` (chrome, language direction), `NavRail`, `JobBar`, `ToastHost`, `Field` (placeholder, icon, error), `Chip`, `AutoSlider`, `StatusGlyph`, `EmptyState`, `Icon`, `Bidi` (right-to-left rules) | +| `Ui/Visuals` | `DrawingElement` (hover readout, item keyboard and activation) and its charts (`BarChart`, `SeriesChart`, `StackedBar`, `HeatmapStrip`, `TimelineBands`), `Filmstrip`, `PreviewViewport`, `CurveEditor`, `SequenceCard`, `VirtualizingWrapPanel`, `SegmentedControl`, `SplitButton` | +| `Server/Api`, `Server/Events` | Endpoint groups (`XxxEndpoints.Map`), API errors, the WebSocket `EventHub` | +| `Server/Security` | Accounts, password hashing, tokens, session cookies, login guard, access rules, audit log | +| `Server/Storage`, `Server/Jobs` | Archive and processing modules, uploads, render store; `JobEngineHost`, render node service, monitor and availability | +| `Server/Hosting`, `Server/Admin/web` | `ServerHost`, certificates, discovery beacon, embedded static files, Windows service; the admin panel (ES modules, one per page) | + +### 2.5 Hosts | Host | Composition root | What it runs | |---|---|---| -| Titano (desktop) | `App/Infrastructure/AppServices` | SQLite index in `%LOCALAPPDATA%\Titano` (or `.\data` when portable); `ArchiveService` with WIC first, then managed decoders; `ProcessingService` with Media Foundation, then managed encoders; one `JobEngine` with the handlers of both; thumbnails; `ServerSession`; the render node while opted in and signed in; update check and download (`About/UpdateCheck`, `About/UpdateDownload`, `About/UpdateFlow`: the setup, or the portable zip for a portable copy, verified against `SHA256SUMS`, resumable, cancellable, failing after 60 s without data); diagnostics bundle | -| Titano Server | `Server/Hosting/ServerHost.Build` | Options from `server.json` + `TITANO_*`; PostgreSQL (or SQLite on Windows); `ArchiveModule` then `ProcessingModule` register job handler providers; `JobEngineHost` (never claims renders); `RenderNodeService`/`RenderNodeMonitor`; `UploadService`; `EventHub` (WebSocket); embedded admin panel; LAN discovery beacon; Windows service host | +| Titano (desktop) | `App/Infrastructure/AppServices` | SQLite index in `%LOCALAPPDATA%\Titano` (or `.\data` when portable); `ArchiveService` with WIC first, then managed decoders; `ProcessingService` with Media Foundation, then managed encoders; one `JobEngine` with the handlers of both; thumbnails; `ServerSession`; `SyncHost` while signed in (sync engine and agent, upload and download handlers, metered hold, editors of server sequences); the render node while opted in and signed in; update check and download (`About/UpdateCheck`, `About/UpdateDownload`, `About/UpdateFlow`: the setup, or the portable zip for a portable copy, verified against `SHA256SUMS`, resumable, cancellable, failing after 60 s without data); diagnostics bundle | +| Titano Server | `Server/Hosting/ServerHost.Build` | Options from `server.json` + `TITANO_*`; PostgreSQL (or SQLite on Windows); `ArchiveModule` then `ProcessingModule` register job handler providers; `JobEngineHost` (renders only managed formats and MP4 jobs no render node can take, BRIEF §14.7); `RenderNodeService`/`RenderNodeMonitor`; `UploadService`; `EventHub` (WebSocket); embedded admin panel; LAN discovery beacon; Windows service host | | Titano Uploader | `Uploader/App.xaml.cs` | `TitanoClient`, persisted queue, watch folders; no database | | Titano Setup | `Setup/Program` | TPK1 payload extraction, registry, shortcuts, silent mode, uninstaller | -### 2.4 Job kinds and their handlers +### 2.6 Job kinds and their handlers | `JobKind` | Handler (Titano.Data) | Desktop | Server | |---|---|---|---| @@ -78,8 +106,9 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S | `Thumbs`, `Proxies` | `Archiving/Jobs/ImageJobHandler` | yes | yes | | `Maintenance` | `Archiving/Jobs/MaintenanceJobHandler` | yes | yes | | `LightAnalyse`, `DeepAnalyse` | `Processing/Jobs/AnalyseJobHandler` (via `ProcessingService.CreateJobHandlers`) | yes | yes | -| `Render` | `Processing/Jobs/RenderJobHandler` | yes | no: render nodes claim them (`Server/Jobs/RenderNodeService`) | -| `UploadCommit`, `Duplicates`, `Orphans`, `Adopt`, `Move` | none: done synchronously (upload completion, `ArchiveService` queries and actions) | — | — | +| `Render` | `Processing/Jobs/RenderJobHandler` | yes | managed formats, and MP4 jobs no render node can take (`RenderNodeAvailability`); render nodes claim the others (`Server/Jobs/RenderNodeService`) | +| `UploadCommit`, `Download` | `Sync/SyncJobHandler` (via `SyncService.CreateJobHandlers`): this PC's uploads to and downloads from its server | yes | no: an upload completes synchronously on the server | +| `Duplicates`, `Orphans`, `Adopt`, `Move` | none: done synchronously (`ArchiveService` queries and actions) | — | — | A job engine claims only kinds it has handlers for. Light analysis is queued by the engine (`JobContext` follow-up) after an import or a scan that indexed something; screens never queue it again. @@ -103,7 +132,7 @@ after an import or a scan that indexed something; screens never queue it again. │ ▼ Render job: RenderPlan → RenderPipeline (FrameWindow, motion, deflicker…) → IVideoEncoderProvider - │ desktop: Media Foundation → managed; server: render node (GPU PC) + │ desktop: Media Foundation → managed; server: render node (GPU PC) → managed ▼ output file (temp → rename) + renders row ``` @@ -111,6 +140,13 @@ after an import or a scan that indexed something; screens never queue it again. The sidecars are the truth; the index is derived and can always be rebuilt (`ScanMode.Rebuild`, using the index snapshot when fresh). Writers coordinate through lease files, so a desktop and a server may share an archive. +Sync (desktop ↔ server, BRIEF §14.5) reuses the same paths: `SyncService` compares the local index with the server's +listing (settings and tags carry version counters), uploads go through the chunked protocol into the server's +`ArchiveIngest`, downloaded originals are verified and committed through the local `ArchiveIngest`, and proxies land +in the `ProxyCache`. A server sequence opens in the editor as a `RemoteSequence` through `RemoteSequenceSource`: +settings are saved with the version they were made from, a 409 merges or asks the user, and analyses and renders +run as server jobs whose progress comes from the events. + ## 4. Extension points | To add | Implement / register | @@ -125,6 +161,7 @@ snapshot when fresh). Writers coordinate through lease files, so a desktop and a | A UI string | `i18n/en/.resx` + `i18n/it/.it.resx` (other languages via `i18n missing`/`import`) | | An admin page | ES module in `Server/Admin/web/pages`, strings in the `Admin` area | | A CLI command | `ICommand` in `Tools/Commands`, listed in `Tools/Program.cs` | +| A desktop screen | `Sections/XxxView.xaml` + `XxxViewModel`, its `DataTemplate` in `Shell/SectionTemplates.xaml`, the property and rail entry in `ShellViewModel`, a scene in `Shell/ScreenCapture` with sample data, a smoke test in `Titano.App.Tests/Windows` | ## 5. Conventions @@ -152,6 +189,30 @@ snapshot when fresh). Writers coordinate through lease files, so a desktop and a (`ShellActions` in the App), the format-volume dialog (`Core.Windows/Devices`). Downloaded updates (the setup, or the portable zip for a portable copy) are shown in Explorer, never started. +### 5.1 Desktop UI (WPF) + +- Every string comes from the catalog (`Loc.L`, `{l:Loc}`); labels ≤ 3 words, explanations only in tooltips. Every + actionable control has a tooltip, and an icon-only one a two-word accessible name: the screen smoke tests check + both on every screen. +- Windows derive from `TitanoWindow`, which takes the UI language's direction at creation and on every switch; + screens never set `FlowDirection` for the language. Photos, charts, numbers, paths and templates are left-to-right + islands on the smallest element holding them; directional icons mirror by themselves (`IconData.IsDirectional`, + overridden per subtree with `Bidi.IsDirectional`); left-to-right fragments inside a right-to-left sentence go + through `BidiText`. +- Radio buttons group by their parent panel. `GroupName` is shared by every window whose visual root is not known + yet, so it is used only where the bindings are one-way (chips generated by item templates, the rail). +- Content a control presents through its template from a dependency property other than `Content` is made a logical + child of the control (`AddLogicalChild` and `LogicalChildren`), so it inherits the data context and resolves + `ElementName` and ancestor bindings (`PreviewViewport.ToolsContent`). +- Status lines that change are live regions (`LiveRegion.Text` with `AutomationProperties.LiveSetting`); inputs + without a validating binding show errors with `Field.Error`; failure toasts set `Toast.IsError`, which screen + readers hear as important. Charts expose their items to automation and take the keyboard only when an item can + be activated. +- Failures reach the user as one sentence chosen by cause (`ErrorText`, `ArchiveFailures`, `ImportFailures`) with + one action; the exception text goes to the tooltip and the log only. +- Destructive actions show their dry run first; irreversible ones ask for a typed confirmation and keep Cancel as + the default button. An explicit dry run stops any debounced one still pending. + ## 6. Tests - Framework: `Titano.Testing`. Test classes are `public sealed`; constructor may take `TestContext` (temp diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index ff29bf56..580506a4 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -61,11 +61,45 @@ commits follow Conventional Commits (release notes are generated from them by `T users, archive, jobs, settings, logs, about), audit log, LAN discovery, Windows service. - Server diagnostics: `GET /api/v1/server/diagnostics` (ManageArchive, audited) and a *Diagnostics* button in admin › Logs. +- Admin panel: light and dark themes following the browser with a toggle, plural-aware counts, audit filter by + several actions, password change, typed confirmations, right-to-left layout; an administrator cannot reset their + own password from Users (409). `DELETE /api/v1/sequences/{id}` moves the sequence to the archive's trash and + answers 409 or 503 with a reason when it cannot. - Titano Uploader: tray program with resumable persisted queue, session grouping, watch folders, bandwidth limit, verified-only source deletion. - Titano Setup: one-screen installer, per-user or all-users, components, shortcuts, file types, upgrade in place, silent mode, uninstaller that keeps user data unless asked. +#### Desktop workflows +- Library: timeline with year bands (keyboard), saved views, quick actions reachable by keyboard, mass actions bar, + *Delete…* into the archive's trash (dry run, typed confirmation, progress, Undo), Rendered / Not rendered / Synced + and Origin filters, and cards for server-only sequences whose Render and Analyse run on the server. +- Archive manager: tree by capture year, health with duplicate groups and *Mark copies*, statistics charts with + values for screen readers, maintenance, *Trash…* with restore, mass rename and move behind a dry run; failures as + one-sentence toasts with Retry, dialog errors inline, Cancel as the default button. +- Import: devices and card pool, camera profiles, plan with sessions (merge, split, titles), hash-verified copy into + the archive, a folder or the server, verified delete, format behind a typed confirmation, eject, auto-import. +- Sequence editor: Frames, Exposure, Camera, Motion and Export tabs with the advisor's Auto values and reasons, + Optimise, preview tools, section charts, curve editor (keyboard included), undo/redo and saving shortly after + each change; *Set hero* updates the Library thumbnail; batch export with size and time estimates. +- Server sequences open in the editor with proxies: saved, analysed and rendered on the server, with cancel and + retry of server jobs, a read-only mode for accounts without Edit, and an explicit prompt when the same setting + changed on the server; Export *Sync* sends local renders to the server; *Save both* copies can be restored from + the Export tab. +- Client sync (Server screen): sync table with filters, conflicts settled with *Keep mine*, *Take server* or *Save + both*, uploads and downloads as resumable jobs that check the free space first, proxies kept offline, uploads paused + on metered connections; this PC as a render node while signed in. + +#### Localization and accessibility +- 38 cultures: `en`, `it` and 36 machine translations with per-language glossaries and an independent review. +- Right-to-left: windows mirror from startup and on every language switch (`TitanoWindow`), directional icons + mirror with them, photos, charts, numbers, paths and templates stay left-to-right islands, category charts lay + out from the reading side. +- Accessibility: automation peers for sliders, filmstrip, curve editor, preview, charts, split buttons and the job + bar; live regions for status lines; toasts announced (failures as errors); `Field.Error` for inputs without + validation; charts take the keyboard (arrows, Home/End, Enter) where an item can be activated; two-word names for + icon-only toggles. + #### Distribution and CI - Docker image (multi-arch, PUID/PGID, health check), compose file with PostgreSQL 17, Unraid template. - CI: Windows + Linux build and tests, PostgreSQL 16/17, Docker smoke test, screenshots branch, i18n, XAML lint, @@ -78,6 +112,12 @@ commits follow Conventional Commits (release notes are generated from them by `T - `Titano.Tools.Tests`: the fixtures command's warning annotations and exit codes. ### Fixed +- Server: downloading the current log while it was being written aborted the response (Content-Length mismatch); it + now serves the bytes listed at request time. +- Mass rename and move: a dry run asked for right after typing was replaced by the pending debounced one, so *Apply* + stayed disabled; the explicit dry run now cancels it. +- Radio groups leaked between windows not shown yet (the Setup's capture overflowed the stack); screenshots of + right-to-left windows were mirrored twice. - Release workflow: signing and the public-repository publish never ran (step conditions cannot read the step's own secrets); the publish job lacked the .NET SDK for `make-icon`; re-publishing an existing tag failed; the portable zip lacked `portable.txt`. diff --git a/docs/STATUS.md b/docs/STATUS.md index 63efda06..24d21803 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -7,12 +7,12 @@ Phase plan: docs/BRIEF.md §22. Windows behaviour is verified on CI (`windows-la | 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 | Library, Jobs, Settings, Welcome, Server and About screens done; Archive manager screen in progress. 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 | Engine done (plan, sessions, hash-verified copy, verified erase, import jobs); screen in progress. | -| 5 Analysis advisor | Engine done (light and deep analysis, advisor, presets, analysis jobs); editor integration in progress. | -| 6 Engine, encoding, editor | Render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 done; sequence editor in progress. | -| 7 Server, sync, uploader | Server (API, auth, uploads, jobs, render nodes, events, admin panel, Windows service) and Uploader done; client sync in progress. | -| 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, machine translations. Pending: remaining languages, RTL and accessibility passes, a tagged pre-release published from CI, install/upgrade/uninstall test on Windows, Unraid template validation on a real server. | +| 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 in Windows Media Player is part of the release test. | +| 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). Pending: a tagged pre-release published from CI, install/upgrade/uninstall test on Windows, Unraid template validation on a real server. | | 9 Monetization | Not started: requires explicit approval (§22). | ## How to try it @@ -24,12 +24,18 @@ 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. ## Next steps (Phase 8 gate) @@ -37,4 +43,4 @@ TITANO_PERF=1 dotnet run --project tests/Titano.Data.Tests -c Release -- --filte tag and check the release, the public repository content and the GHCR image (set it public once). 2. On Windows: install, upgrade over the previous version, uninstall (with and without user data), silent mode. 3. Unraid: add the template repository, install with the official PostgreSQL template, reach the WebUI. -4. Remaining languages, RTL pass (`ar`, `he`, `fa`, `ur`), accessibility pass. +4. Native-speaker review of the machine translations where users report wording (`i18n export` per language).