docs: phases 3-8 status, changelog for the desktop workflows, module map of sync, app and UI
STATUS records the finished Library, Archive manager, Import, editor, sync, translation, RTL and accessibility work and what each gate rests on; what remains is the release test. CHANGELOG lists the desktop workflows, localization and accessibility, admin changes and fixes. ARCHITECTURE maps the Sync engine, SequenceTrash, the App areas, Titano.Ui and Titano.Server, the sync data flow, the server's managed render fallback, and the desktop UI rules (direction, radio groups, logical children, live regions, failure sentences, dry runs). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
3 files changed
+123
-16
No files matched your search
+70
-9
@@ -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/<Area>.resx` + `i18n/it/<Area>.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
|
||||
|
||||
@@ -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`.
|
||||
|
||||
+13
-7
@@ -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).
|
||||
Reference in new issue
Block a user