Qortal-Nextcloud-Integration/docs/product/v1-functions.md

NuQloud V1 Functions

This is the implementation-oriented V1 function list for nuqloud-bootstrap.

1. Function catalog

ID	Function	Mode	Status
V1-F001	NuQloud/full mode switch	powered + full	in progress
V1-F002	Section-scoped admin saves	powered + full	implemented
V1-F003	Admin request queue (Send, Message, Deny)	powered + full	implemented
V1-F004	Admin operations summary on dashboard	powered + full	implemented
V1-F005	User publishing exposure toggle	powered + full	implemented
V1-F006	App gallery + launch controls	powered + full	implemented
V1-F007	Packaging + credits (CHD managed)	powered + full	in progress
V1-F008	OIDC policy + guard controls	powered + full	in progress
V1-F009	Runtime connectivity + health controls	powered + full	implemented
V1-F010	Initial onboarding notifications	powered + full	in progress

2. V1 functions started in this sprint

V1-F007 Packaging + credits config surface

1. Added persistent settings keys:
   • scBillingEnabled
   • scPackageTier
   • scCreditsBalance
   • scMonthlyCredits
   • scEncryptedCapacityGb
   • scReplicationTarget
2. Added package defaults by tier:
   • free_core: 0 credits, 0 GB, 0 replicas
   • nuqloud_starter: 500 credits, 10 GB, 2 replicas
   • nuqloud_advanced: 2000 credits, 25 GB, 3 replicas
   • nuqloud_pro: 5000 credits, 100 GB, 5 replicas
   • nuqloud_team_starter: 500 credits, 10 GB, 2 replicas
   • nuqloud_team_advanced: 2000 credits, 25 GB, 3 replicas
   • nuqloud_team_pro: 5000 credits, 100 GB, 5 replicas
   • nuqloud_branded: 10000 credits, 150 GB, 5 replicas
   • nuqloud_branded_pro: 25000 credits, 500 GB, 5 replicas
   • nuqloud_branded_enterprise: 100000 credits, 1000 GB, 5 replicas
   • legacy replication_* tiers normalize to the matching NuQloud starter/advanced/pro tiers for backward compatibility
3. Added admin UI section and scoped save action.
4. Added CHD/Paymenter-oriented connector settings:
   • scBillingProvider (default paymenter)
   • scBillingSyncMode (default read_only)
   • scChdBaseUrl, scChdSyncPath, scChdInstanceId, scChdInstanceToken, scChdInstanceSecret
   • scChdCatalogPath, scChdCatalogCategoryId
5. Added read-only connector actions:
   • Test Connector (No Apply)
   • Sync Entitlements From CHD (apply local gates/balances from remote response)
6. Added versioned catalog contract negotiation (sc.billing.catalog.v1) and dynamic product discovery endpoint usage.

3. Next implementation steps

1. Add webhook ingestion endpoint for push updates from CHD connector.
2. Add signed replay protection + nonce window for connector callbacks.
3. Add ledger event model for credits mutations.
4. Keep write flows disabled until sandbox validation is complete.