# 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.