# Qortal Nextcloud Integration: Features List

## Admin Features
- Broker connectivity setup and health checks from Nextcloud Admin UI.
- External Auth configuration from Admin UI (base URL, app credentials, node routing values).
- External Auth app registration from Admin UI.
- OIDC setup assistant:
  - Generate setup plan.
  - Run `occ` setup actions from UI.
  - Show effective OIDC policy and overrides.
- Auto-provisioning controls:
  - Policy mode override.
  - Guard override.
  - Invite TTL override.
  - Redirect allowlist override.
- Allowlist management for pre-authorized Qortal addresses.
- Invite token management (create/revoke/list).
- Mapping management:
  - Link/unlink Qortal address to Nextcloud user.
  - List all mappings.
- Wallet operations:
  - List wallets.
  - Create wallet.
  - Create and link wallet.
- Notification workflows:
  - User and group targeting.
  - Email/in-app notices.
  - Queueable notification jobs.
- Q-Apps menu configuration:
  - Enable/disable Q-Apps menu.
  - Approved Q-App list with per-entry icon mode.
  - Optional full-browser mode.
  - Debug panel toggle.

## Personal/User Features
- Import Qortal account from seed phrase and link to current Nextcloud user.
- Import Qortal account from backup JSON and link to current Nextcloud user.
- Create wallet from user settings and link it.
- Backup wallet JSON:
  - Download backup file.
  - Save backup into Nextcloud Files.
- View and unlink own mapped Qortal accounts.
- Q-Apps approval defaults:
  - Request once.
  - Request type for X minutes.
  - Always allow request type.
  - Always allow all request types for current Q-App.
- Persisted approval rules listing and revoke actions.

## Q-Apps Features
- Embedded Q-Apps viewer inside Nextcloud.
- Full-browser mode entry point (optional admin setting).
- In-view browser controls:
  - Back
  - Reload
  - Address bar + Go
  - Open in new tab
  - Close
- Mobile menu behavior for compact controls.
- QDN loading auto-retry detection and refresh logic.
- Gateway proxy routing with theme parameter passthrough.
- Wallet-aware approval modal:
  - Wallet unlock status checks.
  - Password prompt only when wallet is locked.
  - Approval scope controls and persistence options.
- Debug panel with dock/float/minimize/copy/clear.

## Account Dashboard Features
- Mapping overview and linked account visibility.
- Wallet actions needed for self-service management.
- QORT send flow support (address/name resolution and fee controls).

## Broker + Integration Backend Features
- OIDC provider endpoints (`authorize`, `token`, `userinfo`, `jwks`).
- Provisioning endpoints for mapping and account linking.
- Runtime sync bridge from Nextcloud Admin UI to broker/external-auth settings endpoint (best-effort).
- Automatic External Auth session refresh handling on daemon 401.
- Q-Apps request proxy endpoint for authenticated browser->broker->external-auth calls.

## Deployment Features
- Docker stacks:
  - Local dev stack
  - Dev-prod SSL stack
  - Dev-prod no-SSL stack for external reverse proxy
  - PostgreSQL variant
- Bundled optional External Auth container via profile.
- Bundled Qortal node container support with auto API/P2P/QDN port selection.
- Default Qortal node settings template initialization.
- Recreate flow with optional Qortal node recreation flag (`--qortal`).
- Nginx/Apache template configs for exposing Qortal node API/gateway.

## Security/Operational Features
- Role-gated admin actions in Nextcloud app controllers.
- User-scoped mapping/approval operations for personal settings.
- Redaction of sensitive values in client-side debug logs.
- API key support for restricted Qortal node endpoints.
- Containerized local-first topology support for reduced external dependency.