Qortal-Nextcloud-Integration/docs/features-list.md

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.