Documentation / PCCLI / PCCLI Workflow Coverage

PCCLI Workflow Coverage

Practical PanelConfig guidance for PCCLI workflow coverage, with safe workflow, clear records, and operational review notes.

PCCLI Workflow Coverage explains how this part of PanelConfig should be used in a production hosting operation. It focuses on practical decisions, audit visibility, and safe execution rather than marketing language. PCCLI is available at cli/pc and should be documented separately for available commands and workflow-oriented command guides.

Availability: This is PCCLI workflow coverage. It is documented as roadmap guidance only and should not be presented to operators as a live terminal command until php cli/pc help lists it.

Usage

Use this guide when you are configuring, reviewing, or troubleshooting pccli roadmap and workflow guidance for a hosting provider, agency, reseller, or customer account. It is useful during initial setup, operational handover, incident review, and routine maintenance.

Workflow

  1. Open the related PanelConfig page: PCAdmin pages remain the safest GUI equivalent for commands that are not yet exposed in cli/pc..
  2. Confirm the account, domain, user, or server context before changing anything. In provider environments, many records have similar names.
  3. Review current status, ownership, package limits, and any pending jobs before making a change.
  4. Make the smallest safe change first. For destructive or customer-visible operations, keep a ticket or internal note with the reason.
  5. Re-check the page, job queue, audit log, and any affected service status after the operation completes.

Checklist

CheckWhy it matters
OwnershipPrevents changes on the wrong customer, reseller, or hosting account.
Current statusAvoids repeating an action that is already pending, suspended, queued, failed, or completed.
Limits and dependenciesShows whether package limits, DNS state, storage, service health, or credentials affect the result.
Audit trailGives support and operations teams a reliable record of who changed what and why.

Related

PCAdmin: PCAdmin pages remain the safest GUI equivalent for commands that are not yet exposed in cli/pc.

PCUser: PCUser should use the panel for customer-scoped tasks unless the provider exposes a controlled automation wrapper.

Related PCCLI: accounts:create (planned; not exposed by the inspected cli/pc command router)

Records

Typical records involved: jobs, command_runs, command_allowlist, audit_logs plus module tables touched by each command. Some actions only read these records, while write actions may update status fields, create queue records, write audit entries, or refresh timestamps. For integration-ready areas, do not assume an external provider action has completed until the local job and provider-side evidence agree.

Notes

Security and audit notes: use least-privilege access, avoid sharing raw credentials, keep customer-impacting changes tied to a reason, and review Audit Logs or Login History when an action affects authentication, access, DNS, mail flow, backups, SSL, firewall, WAF, or account status.

Troubleshooting

  • If the page is empty, confirm the related database table exists and that the user role has permission to view the module.
  • If a change appears stuck, check Jobs, Job Logs, and Services before repeating the operation.
  • If an external dependency is involved, verify it independently: DNS propagation, ACME challenge visibility, remote backup storage, mail DNS records, or provider API state.
  • If the result is sensitive or customer-visible, capture the exact timestamp, account id, domain, and operator before escalating.

Workflow Coverage Rule

Commands such as account creation, DNS record mutation, mailbox creation, database imports, direct firewall mutation, and detailed worker status are roadmap items unless a future release exposes them in php cli/pc help. Keep planned commands separated from available commands in customer-facing docs.

Roadmap Safety

Do not copy planned command names into production runbooks as if they are available. Confirm the installed release by running php cli/pc help and update customer-facing documentation only after the command router and worker behavior exist.

← Handling Exit Codes