Skip to content

chore: establish clean-clone self-hosted release gate and operational readiness #115

Description

@parthrohit22

Task

Create a repeatable clean-clone acceptance gate for the supported self-hosted stack. The audit verified components and CI jobs, but Docker was unavailable locally, Redis-backed behaviour was not exercised, and backup/restore, readiness, and failure recovery were not demonstrated as one deployable workflow.

This issue is a release/operations gate. It does not replace #93's durable job implementation or #110's migration fix.

Rationale

PARTHA's intended private/self-hosted market requires more than passing isolated unit tests. A maintainer must be able to clone the repository, configure the documented environment, start the stack, migrate the database, complete the owner-isolated proof workflow, recover from a restart, and understand what is ready or failing.

References

Implementation Notes

Acceptance Criteria

  • A clean checkout can start the documented stack with one reproducible command sequence.
  • Postgres and Redis paths are exercised in CI or an equivalent isolated acceptance environment.
  • Readiness checks distinguish unavailable, starting, and ready services.
  • Migration up/down or upgrade validation covers percent-encoded database URLs.
  • Auth, owner isolation, and the first proof workflow are exercised end-to-end.
  • Restart/recovery and cleanup behavior are tested without orphaned jobs or data corruption.
  • Backup/restore and retention expectations for sealed snapshots are documented and tested when the snapshot path is live.
  • A self-hosted runbook lists required environment variables, security boundaries, and unsupported deployment modes.

Priority

P1 - High · Phase 0 release-readiness gate.

Dependencies

Coordinate with #93, #95, #109, and #110. This issue verifies the integrated deployable system; it should not duplicate their implementation details.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions