alldigital/PSA
2
0
Fork 0
Code Issues Pull Requests Actions 15 Packages Projects Releases Wiki Activity
PSA/ee/docs/plans/2026-04-28-workflow-step-quota-accounting/OPERATIONS.md
Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Details
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Details
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
Details
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
Details
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Details
Integration Tests / Check for relevant changes (push) Waiting to run
Details
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Details
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Details
Mobile checks / Mobile unit tests (push) Waiting to run
Details
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Details
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Details
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Details
Temporal Readiness / fast-readiness (push) Waiting to run
Details
Temporal Readiness / docker-parity (push) Waiting to run
Details
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Details
Unit Tests / Skipped-test budget (push) Waiting to run
Details
Unit Tests / Nx affected unit tests (push) Waiting to run
Details
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Details
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Details
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
Details
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Details
Initial import of AlgaPSA codebase from PSA server 
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz

Source: /opt/alga-psa on psa.joliet.tech
2026-06-22 16:12:17 -05:00

1.9 KiB
Raw Permalink Blame History

Workflow Step Quota Operations Notes

Quota Source Resolution

  1. Active Stripe subscription period (trialing, active, past_due, unpaid) with valid current_period_start/current_period_end.
  2. If unavailable, fallback to current UTC calendar month.

Limit precedence:

  1. stripe_prices.metadata.workflow_step_limit
  2. stripe_products.metadata.workflow_step_limit
  3. Tier default (solo=150, pro=750, premium=10000)

workflow_step_limit=unlimited sets unlimited cap (effective_limit = null) while continuing to increment usage.

Pause Behavior

  • Reservation occurs at step start.
  • On exhaustion, run is set to WAITING at current node_path.
  • Quota pause is recorded in workflow_run_waits with wait_type='quota', status='WAITING', and payload including usedCount, effectiveLimit, and period metadata.
  • Quota-blocked step does not create a workflow_run_steps row.

Resume Behavior

Automatic resume:

  • Recurring job workflow-quota-resume-scan scans quota waits.
  • Uses FOR UPDATE SKIP LOCKED and batch sizing.
  • Resumes at most tenant remaining finite capacity per scan.
  • Sets wait to RESOLVED, run to RUNNING, then re-enters runtime execution.

Manual resume:

  • resumeWorkflowRunFromQuotaPauseAction checks tenant ownership + permission.
  • If still exhausted, returns a structured response with usedCount, effectiveLimit, and periodEnd.
  • If eligible, resolves quota wait and resumes through runtime path (no quota bypass).

Reconciliation Procedure

Use workflowStepQuotaService.reconcileUsagePeriod(tenant, periodStart, periodEnd):

  • Counter source: workflow_step_usage_periods.used_count
  • Ledger source: workflow_run_steps joined to workflow_runs for tenant and step started_at inside period
  • Drift: counterUsedCount - ledgerStepCount

Investigate non-zero drift by checking runtime paths that may create step rows without quota reservation.