Qortal-Nextcloud-Integration/docs/engineering/milestone-issue-list.md

# NuQloud Milestone Issue List

Use these as initial issues/epics in `NuQloud-Nextcloud`.

## Milestone 0: Branch and repo bootstrap

### SC-0.1 Create product branch model
- Branch: `nuqloud/bootstrap-branch-model`
- Tasks:
  1. Add `nuqloud` remote.
  2. Create `nuqloud-bootstrap`.
  3. Document merge flow from `origin/main`.
- Done when:
  - Team can ship to product fork without touching core `main`.

### SC-0.2 Add docs baseline
- Branch: `nuqloud/docs-baseline`
- Tasks:
  1. Add PRD + implementation matrix + milestone list.
  2. Link from root `README` (product fork).
- Done when:
  - Product and engineering scope are versioned.

## Milestone 1: Mode framework and naming

### SC-1.1 Implement `SC_MODE` persistence
- Branch: `nuqloud/mode-flag-persistence`
- Tasks:
  1. Add admin setting for `powered|full_qortal`.
  2. Persist and expose mode in app boot payload.
- Done when:
  - UI can render mode-specific behavior.

### SC-1.2 Terminology mapping layer
- Branch: `nuqloud/ui-terminology-map`
- Tasks:
  1. Create string mapping table.
  2. Apply to dashboard, auth, settings, onboarding.
- Done when:
  - Powered mode avoids wallet/seed/node language.

### SC-1.3 Debug mode isolation
- Branch: `nuqloud/debug-mode-gating`
- Tasks:
  1. Admin-only guard.
  2. Add visible warning banner.
- Done when:
  - Debug data inaccessible to standard users.

## Milestone 2: Identity hardening and powered UX

### SC-2.1 NuQloud login UX pass
- Branch: `nuqloud/powered-auth-ux`
- Tasks:
  1. Simplify login/onboarding copy.
  2. Keep full mode untouched.
- Done when:
  - New user flow is understandable without protocol knowledge.

### SC-2.2 Runtime security checks in scripts
- Branch: `nuqloud/script-security-guards`
- Tasks:
  1. Ensure broker token/cors fail-fast checks.
  2. Ensure app receives broker token env where required.
- Done when:
  - Startup/recreate cannot silently run insecure.

### SC-2.3 Claims-language pass
- Branch: `nuqloud/claims-language-policy`
- Tasks:
  1. Replace absolute security claims in UI/docs.
  2. Add standardized trust language.
- Done when:
  - Marketing and technical claims are defensible.

## Milestone 3: NuQloud backup and proofs

### SC-3.1 Backup proof model
- Branch: `nuqloud/backup-proof-model`
- Tasks:
  1. Define backup proof schema.
  2. Store and display proof metadata.
- Done when:
  - Each backup has verifiable proof record.

### SC-3.2 Restore preview integrity gate
- Branch: `nuqloud/restore-preview-integrity`
- Tasks:
  1. Verify integrity before restore action.
  2. Expose status and failure reason.
- Done when:
  - Restore cannot proceed on failed verification.

## Milestone 4: Replication status and packages

### SC-4.1 Replication status dashboard
- Branch: `nuqloud/replication-status-ui`
- Tasks:
  1. Show target replicas vs healthy replicas.
  2. Show degraded/healthy/error states.
- Done when:
  - Admin sees clear replication health at a glance.

### SC-4.2 Package enforcement
- Branch: `nuqloud/package-limits-enforcement`
- Tasks:
  1. Implement tier config + capacity limits.
  2. Enforce limits with actionable UI messaging.
- Done when:
  - Tier limits are consistently enforced.

### SC-4.3 Capacity add-on model
- Branch: `nuqloud/capacity-addon-metering`
- Tasks:
  1. Implement capacity-block accounting hooks.
  2. Add over-capacity warnings and controls.
- Done when:
  - Capacity scaling is predictable and auditable.

### SC-4.4 Payment webhook ingest + idempotency
- Branch: `nuqloud/payment-webhook-ingest`
- Tasks:
  1. Add webhook endpoint with signature verification.
  2. Add idempotent purchase ledger writes using invoice/event ref.
  3. Update entitlements from plan line items.
- Done when:
  - Duplicate webhooks do not double-credit balances.

## Milestone 5: Credits and billing abstraction

### SC-5.1 Credits display abstraction
- Branch: `nuqloud/credits-ui-layer`
- Tasks:
  1. Hide QORT as credits in powered mode.
  2. Keep full mode native.
- Done when:
  - Powered users never need token literacy.

### SC-5.2 Credit ledger core
- Branch: `nuqloud/credit-ledger-core`
- Tasks:
  1. Implement ledger model + event types.
  2. Add admin usage view/export.
- Done when:
  - Consumption events are traceable.

### SC-5.3 Consume/refund transaction safety
- Branch: `nuqloud/credits-consume-refund-atomic`
- Tasks:
  1. Add atomic consume endpoint with idempotent ref key.
  2. Add refund compensation endpoint for failed publishes.
  3. Enforce no-negative-balance invariant under concurrency.
- Done when:
  - Publish retries cannot overcharge or produce negative balances.

## Milestone 6: Marketplace readiness

### SC-6.1 Install flow simplification
- Branch: `nuqloud/install-flow-polish`
- Tasks:
  1. Improve installer prompts and defaults.
  2. Validate secure-by-default paths.
- Done when:
  - Install path is predictable for 8–16GB VM targets.

### SC-6.2 Documentation packs
- Branch: `nuqloud/docs-marketplace-pack`
- Tasks:
  1. Admin quickstart (powered).
  2. Full mode guide.
  3. Security and backup guarantees page.
- Done when:
  - Docs support app-store review and customer onboarding.

### SC-6.3 Intro grant workflow
- Branch: `nuqloud/intro-grant-workflow`
- Tasks:
  1. Add one-time grant request UI and API.
  2. Add management approval/reject actions.
  3. Persist and enforce one-grant-per-instance policy.
- Done when:
  - Intro grants are controlled, auditable, and non-repeatable.

## Suggested branch naming convention

`nuqloud/<milestone-or-area>-<short-topic>`

Examples:

1. `nuqloud/m1-mode-persistence`
2. `nuqloud/m3-backup-proof-schema`
3. `nuqloud/m4-replication-health-panel`