Verify Immich import compatibility and a standalone Circa archive view #121

Open
opened 2026-07-28 06:06:09 +00:00 by claude-bot · 1 comment

Severity: MEDIUM

Context

The user has confirmed Immich is the intended long-term family-facing home for the collection —
and that Circa should also stand alone. Both need to be true.

Scope

Immich compatibility (a confirmed spec requirement, §16, with nothing verifying it):

  • Verify that exported files and their embedded metadata import cleanly into Immich, with dates
    landing correctly including partial-precision cases.
  • Verify people tags and keywords survive the import.
  • Document the import procedure.
  • A round-trip test against a real Immich instance.

Circa standalone:

  • Circa must remain useful without Immich — meaning a browsable, searchable view of the finished
    collection, not just a review workshop. The histogram, album views, person index, and search
    together mostly deliver this; the gap is a read-oriented mode that presents a finished archive
    rather than a work queue.
  • The viewer role (currently unenforced, see #73) is the natural vehicle: a family member browsing
    approved photos with their dates and stories, without review controls.

Done when

  • An export imports into Immich with dates and tags intact, verified end to end
  • The procedure is documented
  • Circa presents a finished-archive view for non-reviewing family members
  • Neither system is required for the other to be useful

References

  • docs/circa-spec.md §16

Depends on: the export pipeline, #73 (viewer role).

## Severity: MEDIUM ## Context The user has confirmed Immich is the intended long-term family-facing home for the collection — **and that Circa should also stand alone.** Both need to be true. ## Scope **Immich compatibility** (a confirmed spec requirement, §16, with nothing verifying it): - Verify that exported files and their embedded metadata import cleanly into Immich, with dates landing correctly including partial-precision cases. - Verify people tags and keywords survive the import. - Document the import procedure. - A round-trip test against a real Immich instance. **Circa standalone:** - Circa must remain useful without Immich — meaning a browsable, searchable view of the finished collection, not just a review workshop. The histogram, album views, person index, and search together mostly deliver this; the gap is a read-oriented mode that presents a *finished* archive rather than a work queue. - The viewer role (currently unenforced, see #73) is the natural vehicle: a family member browsing approved photos with their dates and stories, without review controls. ## Done when - [ ] An export imports into Immich with dates and tags intact, verified end to end - [ ] The procedure is documented - [ ] Circa presents a finished-archive view for non-reviewing family members - [ ] Neither system is required for the other to be useful ## References - `docs/circa-spec.md` §16 Depends on: the export pipeline, #73 (viewer role).
claude-bot added this to the v0.5.0 milestone 2026-07-28 06:06:09 +00:00
Author

Scope reduced. The standalone Circa archive view has been split into #129 following a product
decision.

The user has rejected the premise that Immich makes a family-facing view in Circa redundant:
Immich is a personal photo library, while Circa's output is a shared family history. Those are
different products, and #129 covers Circa's own presentation layer.

This issue is now Immich interoperability only: verify that exports import cleanly, with dates
landing correctly including partial-precision cases, and people tags and keywords surviving. Then
document the procedure and add a round-trip test.

The "Circa standalone" half of this issue's original scope moves to #129.

**Scope reduced.** The standalone Circa archive view has been split into #129 following a product decision. The user has rejected the premise that Immich makes a family-facing view in Circa redundant: Immich is a personal photo library, while Circa's output is a shared family history. Those are different products, and #129 covers Circa's own presentation layer. **This issue is now Immich interoperability only:** verify that exports import cleanly, with dates landing correctly including partial-precision cases, and people tags and keywords surviving. Then document the procedure and add a round-trip test. The "Circa standalone" half of this issue's original scope moves to #129.
Sign in to join this conversation.
No description provided.