/
Unit Test Protocol (Prime VoIP ENVIA)

Unit Test Protocol (Prime VoIP ENVIA)

Unit Test Protocol (Prime VoIP ENVIA)

Manual acceptance checks for nmsprime-provvoipenvia. Use a non-production Envia test tenant when possible.

Environment

Item

Expected

Item

Expected

Package

nmsprime-provvoipenvia installed

Dependency

nmsprime-provvoip active

Credentials

Test Envia endpoint + auth in Global Config

Queue

Workers processing ProvVoipEnvia jobs

Protocol

UT-ENVIA-01 — Module loads

  1. Confirm module appears in NMSPrime module list / sidebar.

  2. Open EnviaOrder / EnviaContract index views without 500 errors.

Pass: Controllers and views render for authorized users.

UT-ENVIA-02 — Availability probe

  1. Run an availability check for a known serviceable test address (UI or EnviaApiAvailabilityJob path).

  2. Confirm a structured success/failure result is stored or shown.

Pass: Result matches Envia test-system expectation; errors are visible, not silent.

UT-ENVIA-03 — Create contract / voip account order

  1. On a test contract with modem + phonenumber prerequisites, create an EnviaOrder for contract/voip-account creation (per nested setup guide).

  2. Process via queue.

  3. Confirm EnviaContract link and order status after success.

Pass: Local EnviaContract ID populated from API; order not stuck in “new” indefinitely.

UT-ENVIA-04 — Phonebook order

  1. Create a phonebook create/update EnviaOrder for a provisioned number.

  2. Process and refresh via provvoipenvia:update_phonebooks if used in your deploy.

Pass: Directory fields mirrored locally after success.

UT-ENVIA-05 — Status refresh commands

  1. Run provvoipenvia:update_envia_orders (and contracts updater) against the test tenant.

  2. Confirm existing orders pick up status changes without corrupting payloads.

Pass: Status fields update; no mass soft-delete of valid orders.

UT-ENVIA-06 — Voice data path

  1. Execute voice-data update (provvoipenvia:update_voice_data) for a period with known CDR/voice items in the test feed.

  2. Confirm Billing-side items appear per Connection to Billing.

Pass: Importable items created/updated; failures logged.

UT-ENVIA-07 — Authorization

  1. Login as a role without Envia permissions.

  2. Attempt order create / config change.

Pass: Denied by ACL; no API call fired.

Evidence to attach

  • Screenshots of successful EnviaOrder status

  • Redacted request/response excerpts from a successful and a failed order

  • Cron/command output for updaters

Out of scope for this protocol

  • Full regression of every Envia SOAP method

  • Production number porting without carrier change window

  • Billing invoice calculation (covered by Billing app tests)