# Nextcloud App Roadmap

This roadmap tracks implementation inside `nextcloud/custom_apps/qortal_integration`.
For full cross-service goals and architecture, see `docs/master-goals.md`.

## Current state

- Admin section exists and is functional.
- App settings persist:
  - broker base URL
  - external auth docs URL
  - feature toggles for QDN backups and Q-Mail
- Broker status checks are available from admin UI.
- Admin setup operations now available:
  - list/create wallets through broker
  - list/link identity mappings
  - allowlist Qortal addresses for auto-provision
  - invite token generation and revocation
- Personal user setup operations now available:
  - import existing wallet via seed phrase or backup JSON
  - auto-link imported wallet to current Nextcloud user
  - unlink accidental user mappings
  - list current user's linked identities
- Q-Apps access (gateway proxy) implemented:
  - embedded Q-Apps viewer
  - per-app menu entries
  - optional full Qortal browser link
- Qortal Account dashboard:
  - wallet + balance + names + auth test
  - live refresh

## Milestone 1: Identity operations UI

- Add mapping table:
  - Nextcloud user
  - Qortal address
  - linkage status
  - last update
- Add manual actions:
  - link existing address
  - unlink
  - sync status
- Add wallet-based provisioning form using broker `upsert-from-wallet`.

## Milestone 2: Admin-triggered onboarding campaigns

- Campaign creation UI:
  - target users/groups
  - channel selection (in-app, email, both)
  - reminder schedule
- Campaign execution + status page:
  - invited
  - completed
  - failed
  - retried

## Milestone 3: End-user onboarding UX

- User-facing prompt center:
  - create Qortal account
  - link existing account
- User onboarding state page with clear next actions.
- Notification controls:
  - snooze
  - remind later
  - dismiss (policy-aware)

## Milestone 4: Q-App access surface

- Admin-managed Q-App catalog and group access control.
- User launcher in Nextcloud navigation.
- Secure context handoff token flow via broker.

## Milestone 5: Operations and compliance

- Audit timeline in admin UI.
- Error diagnostics and retry tools.
- Reporting widgets for adoption and auth success rate.