domverse/photoanalyzer
1
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

US03-03 — Generate and Persist Versioned Proposals #17

New Issue
Closed
opened 2026-07-13 13:10:43 +02:00 by domverse · 3 comments
domverse commented 2026-07-13 13:10:43 +02:00
Owner
Copy Link

Source specification: delivery_backlog/stories/US03-03-proposal-generation.md

US03-03 — Generate and Persist Versioned Proposals

Epic: E03

As a user, I want AI-assisted album proposals with rationale and confidence so I can
evaluate suggestions before approving them.

Acceptance criteria

  • A provider adapter receives only the minimum aggregated evidence and returns a
    validated structured proposal.
  • Proposal, evidence version, model/prompt version, rationale, confidence, edits, and
    approval state are durable.
  • Malformed, rate-limited, failed, duplicate, and stale responses are explicit and
    safely retryable.
  • Approval validates the latest proposal version and performs no rename.

Automated tests

  • Deterministic fake-provider tests cover success, malformed output, retry, and failure.
  • API tests cover creation, edits, optimistic conflicts, approval, and restart.

Dependencies

  • US03-01, US03-02
Source specification: [delivery_backlog/stories/US03-03-proposal-generation.md](https://git.domverse-berlin.eu/domverse/photoanalyzer/src/branch/main/delivery_backlog/stories/US03-03-proposal-generation.md) # US03-03 — Generate and Persist Versioned Proposals Epic: [E03](https://git.domverse-berlin.eu/domverse/photoanalyzer/src/branch/main/delivery_backlog/E03-album-proposals.md) As a user, I want AI-assisted album proposals with rationale and confidence so I can evaluate suggestions before approving them. ## Acceptance criteria - A provider adapter receives only the minimum aggregated evidence and returns a validated structured proposal. - Proposal, evidence version, model/prompt version, rationale, confidence, edits, and approval state are durable. - Malformed, rate-limited, failed, duplicate, and stale responses are explicit and safely retryable. - Approval validates the latest proposal version and performs no rename. ## Automated tests - Deterministic fake-provider tests cover success, malformed output, retry, and failure. - API tests cover creation, edits, optimistic conflicts, approval, and restart. ## Dependencies - US03-01, US03-02
domverse added this to the E03 — Album Proposals milestone 2026-07-13 13:10:43 +02:00
domverse added a new dependency 2026-07-13 13:11:21 +02:00
#15 US03-01 — Aggregate Album Evidence
domverse added a new dependency 2026-07-13 13:11:21 +02:00
#16 US03-02 — Define Album Naming Policy
domverse added a new dependency 2026-07-13 13:11:22 +02:00
#18 US03-04 — Review and Approve Proposals in the Browser
domverse added a new dependency 2026-07-13 13:11:22 +02:00
#19 US03-05 — Automate Phase C End-to-End Acceptance
domverse added this to the Photo Analyzer Delivery project 2026-07-13 13:19:45 +02:00
domverse added the status/backlog label 2026-07-13 13:52:48 +02:00
domverse added status/in-progress and removed status/backlog labels 2026-08-15 13:45:17 +02:00
domverse self-assigned this 2026-08-15 13:45:18 +02:00
domverse commented 2026-08-15 13:45:19 +02:00
Author
Owner
Copy Link

Claimed for implementation on branch us/US03-03-generate-and-persist-versioned-proposals.

Claimed for implementation on branch `us/US03-03-generate-and-persist-versioned-proposals`.
domverse added status/review and removed status/in-progress labels 2026-08-15 13:54:53 +02:00
domverse commented 2026-08-15 13:54:54 +02:00
Author
Owner
Copy Link

Submitted for review: #63

Tests passed:

  • work_item/scripts/python -m unittest discover -s work_item/tests -v
  • work_item/scripts/python -m pytest tests -q
  • work_item/scripts/python -m pytest tests/integration/test_album_proposals.py -q
Submitted for review: https://git.domverse-berlin.eu/domverse/photoanalyzer/pulls/63 Tests passed: - `work_item/scripts/python -m unittest discover -s work_item/tests -v` - `work_item/scripts/python -m pytest tests -q` - `work_item/scripts/python -m pytest tests/integration/test_album_proposals.py -q`
domverse added status/done and removed status/review labels 2026-08-15 13:55:11 +02:00
domverse commented 2026-08-15 13:55:12 +02:00
Author
Owner
Copy Link

Completed and merged via PR #63.

Completed and merged via PR #63.
domverse moved this to Done in Photo Analyzer Delivery on 2026-08-16 11:58:39 +02:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/backend
Backend services, jobs, or API
 area/database
Schema, persistence, migration, or queries
 area/filesystem
Filesystem identity, mutation, or storage
 area/frontend
Browser UI and client-side application
 area/integration
External tools or provider integrations
 area/testing
Automated test suites, fixtures, and tooling
 priority/critical
Release-blocking safety or correctness
 priority/high
Important phase outcome
 priority/normal
Normal planned work
 status/backlog
Awaiting dependency eligibility or prioritization
 status/blocked
Cannot proceed without an explicit resolution
 status/done
Merged, tested, and completed
 status/in-progress
Currently being implemented
 status/ready
Eligible to be claimed
 status/review
Submitted in a pull request for review
 type/feature
User-facing or domain capability
 type/hardening
Security, resilience, operations, or release hardening
 type/migration
Donor extraction, migration, or legacy consolidation
 type/test
Automated test infrastructure or acceptance coverage
No Label area/backend area/database area/integration priority/normal status/done type/feature
Milestone
No items
No Milestone E03 — Album Proposals
Projects
Clear projects
No project Photo Analyzer Delivery
Assignees
Clear assignees
domverse
No Assignees domverse
1 Participants
Notifications
Due Date
No due date set.
Blocks
#18 US03-04 — Review and Approve Proposals in the Browser
domverse/photoanalyzer
#19 US03-05 — Automate Phase C End-to-End Acceptance
domverse/photoanalyzer
Depends on
#15 US03-01 — Aggregate Album Evidence
domverse/photoanalyzer
#16 US03-02 — Define Album Naming Policy
domverse/photoanalyzer
Reference: domverse/photoanalyzer#17
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?