Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Record Community transition refund preparation
rcourtman8bbde3f35472
diff --git a/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md b/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.mdnew file mode 100644index 0000000000..f540062d9b--- /dev/null+++ b/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md@@ -0,0 +1,71 @@+# Community transition refund preparation++25 October 2026. Commercial preparation under L2 and L3. This slice adds an+admin-only calculation of an annual transition refund from proposed announcement+and release dates. It does not activate a programme, change the published offer,+remove runtime gates or authorize payment actions.++## Prepared boundary++`pulse-pro:license-server/v6_commercial_refunds.go` binds the requested+subscription and invoice to a configured annual Pulse price, one complete annual+line, its paid payment intent and exact captured charge. Customer, subscription,+price, invoice, payment and currency must agree throughout. Missing, ambiguous,+prorated, disputed or contradictory evidence stops the preview. A release+outside the selected paid period requires reconciliation.++Amounts use actual captured minor units rather than list prices or converted+currency. The calculation requires at least 30 days between proposed notice and+release, and reports the 60-day claim deadline. Its version identifies the+calculation policy, not an activated customer programme. Both current annual+prices and grandfathered recurring annual prices work without a v6 licence row.+The preview is explicitly unexecutable.++Prior refunds produce only a cash-bounded ceiling and a reconciliation status.+The preview cannot infer whether an earlier refund was a transition remedy,+goodwill or a price adjustment. An invoice balance adjustment similarly+withholds an additional-refund recommendation. The separate recent-first-+purchase remedy is explicitly not evaluated, and monthly payments are out of+scope. Unsupported cohorts have private 422 reasons, distinct from unavailable+provider evidence.++All provider operations are GETs. No subscription, refund, local licence,+commercial projection, revocation event or customer email is changed. Existing+full-refund and support-cancellation paths retain their current semantics.++## Remaining implementation++Keep the public free-feature change out of the automatic release train until+the notice and effective release are coordinated. Community history, remote+probes and ordinary accounts must not regain removed restrictions through old+grants or lapse. Preserve configured physical retention and existing data.+Pro retains supported investigation/actions, custom roles and reporting at+protected prices. The proposed Business checkout pause must be coherent with+public copy and preserve original rights and support promises.++Before offering the annual exit, extend the existing commercial transition+authority with a durable quote bound to the adopted programme, exact invoice+and charge, and the applicable local licence generations. Re-read financial+evidence before execution. A known pre-mutation failure differs from an+uncertain financial outcome. Do not reclaim or automatically retry uncertain+cancellation or refund work.++Confirmed cancellation must terminate paid rights through the canonical local+projection and version-floor path, including matching legacy entitlements.+Partial refund webhooks alone do not perform that termination. Prove event+order, replay, renewal between preview and execution, lack of unintended+credits/invoices, and customer-runtime convergence before activation. Full+recent-first-purchase remedies remain distinct from unused annual time.++These are active residuals in `community-commercial-transition-cutover`.+This record does not close the external commercial transition proof or claim+that the free-feature release or complete refund executor has shipped.++## Verification++The standalone license-server Go suite includes+`v6_commercial_refunds_test.go` for exact-payment admission, grandfathered and+current annual prices, currency preservation, partial/full prior refunds,+integer rounding, malformed evidence, interrupted reads, admin-only admission+and absence of a public route. The source is prepared independently of any+production deployment or provider test-mode mutation.diff --git a/docs/release-control/v6/internal/status.json b/docs/release-control/v6/internal/status.jsonindex 36fbdbe6a7..c7768b6b5e 100644--- a/docs/release-control/v6/internal/status.json+++ b/docs/release-control/v6/internal/status.json@@ -5161,6 +5161,10 @@{"kind": "lane-followup","id": "cloud-commercial-transition-external-proof"+ },+ {+ "kind": "lane-followup",+ "id": "community-commercial-transition-cutover"}]},@@ -9564,6 +9568,24 @@"subsystem_ids": ["deployment-installability"]+ },+ {+ "id": "community-commercial-transition-cutover",+ "summary": "Complete the notice-bound Community transition remedy through the commercial authority: adopted policy, exact-payment annual preview, durable quote/apply, prior-refund reconciliation, cross-generation entitlement termination and external event/runtime proof before customer activation.",+ "owner": "project-owner",+ "status": "planned",+ "recorded_at": "2026-10-25",+ "lane_ids": [+ "L3"+ ],+ "subsystem_ids": [+ "cloud-paid"+ ],+ "repo_ids": [+ "pulse",+ "pulse-pro"+ ],+ "cross_repo": true}],"coverage_gaps": [diff --git a/docs/release-control/v6/internal/subsystems/cloud-paid.md b/docs/release-control/v6/internal/subsystems/cloud-paid.mdindex 2d9c6e506c..b1515f340a 100644--- a/docs/release-control/v6/internal/subsystems/cloud-paid.md+++ b/docs/release-control/v6/internal/subsystems/cloud-paid.md@@ -15,6 +15,26 @@## Purpose+### Community transition refund preparation++`pulse-pro:license-server/v6_commercial_refunds.go` owns the admin-only annual+transition refund preview. Its proposed announcement and release dates do not+activate a programme. It reads an exact configured annual subscription,+invoice, payment intent and captured charge, in the charge's original integer+currency units. Both grandfathered recurring and current prices use the existing+commercial catalog without requiring a migrated v6 licence. The preview is not+an executable transition quote and never cancels, refunds, changes entitlements+or sends customer mail.++The Community history/probe/seat boundary and Business sales pause remain+pending the notice-bound cutover. Before a refund exit is offered, the existing+commercial authority still needs a durable, policy-bound quote and one-attempt+execution with exact cancellation, original-payment refund, cross-generation+entitlement termination, version-floor invalidation and reconciliation proof.+No payment effect may be inferred from an unsigned preview or its dates. The+preparation record is+`docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md`.+### Reporting measurement precedes commercial feature decisionsSchema-v20 reporting usage exports only aggregate generation by closed report@@ -303,6 +323,7 @@ establish Compose mounts, tenant provisioning or installed provider recovery.88. `pulse-pro:license-server/README.md`89. `pulse-pro:license-server/entrypoint.sh.template`90. `pulse-pro:license-server/secrets.env.template`+91. `pulse-pro:license-server/v6_commercial_refunds.go`## Shared Boundariesdiff --git a/docs/release-control/v6/internal/subsystems/registry.json b/docs/release-control/v6/internal/subsystems/registry.jsonindex c1aaa3bd4e..fbf77b6e7d 100644--- a/docs/release-control/v6/internal/subsystems/registry.json+++ b/docs/release-control/v6/internal/subsystems/registry.json@@ -3711,6 +3711,7 @@"pulse-pro:license-server/secrets.env.template","pulse-pro:license-server/self_hosted_feature_catalog.generated.go","pulse-pro:license-server/v6_checkout.go",+ "pulse-pro:license-server/v6_commercial_refunds.go","pulse-pro:license-server/v6_commercial_transitions.go","pulse-pro:license-server/v6_grants.go","pulse-pro:license-server/v6_handlers.go",@@ -4500,6 +4501,7 @@"pkg/licensing/activation_store_test.go","pkg/licensing/grant_refresh_test.go","pkg/licensing/installation_status_poll_test.go",+ "pulse-pro:license-server/v6_commercial_refunds_test.go","pulse-pro:license-server/v6_status_test.go"]},@@ -4567,6 +4569,19 @@"pulse-pro:license-server/main_test.go","pulse-pro:scripts/tests/test_grandfathered_recurring_cutover_preview.py"]+ },+ {+ "id": "community-transition-refund-preview",+ "label": "read-only exact-payment annual transition refund calculation proof",+ "match_prefixes": [],+ "match_files": [+ "pulse-pro:license-server/v6_commercial_refunds.go"+ ],+ "allow_same_subsystem_tests": false,+ "test_prefixes": [],+ "exact_files": [+ "pulse-pro:license-server/v6_commercial_refunds_test.go"+ ]}],"match_files": null