Troubleshooting guide for school management, ERP, and SIS

Describe the symptom precisely

Troubleshooting begins with a reproducible symptom: a student is missing from a class, a payment is unreconciled, a family cannot see an approved result, a report is wrong, or a notification failed. Record the user, role, record, date, period, action, expected result, and observed result.

Do not start by changing data. Preserve the evidence and identify the accountable workflow owner.

Check the common causes

Check source of truth, identity match, required values, calendar or period, role, approval, publishing state, integration delivery, and support configuration. Compare a controlled working example with the failing case.

• Wrong or duplicated identity
• Missing or stale data
• Incorrect role or relationship access
• Unapproved or unpublished state
• Failed exchange, notification, or reconciliation

Escalate without broadening risk

Give support enough context to reproduce the issue without sending unnecessary student, guardian, payment, or staff data. GOV.UK guidance recommends minimum necessary data, access control, security, supplier responsibility, subprocessors, incident notification, and data return or deletion.

The U.S. Department of Education data governance checklist connects quality, access, security, lifecycle, sharing, disposal, and monitoring. A workaround that fixes visibility by creating a broad export may create a larger problem.

Handle continuity and recovery

For an outage or possible corruption, identify who authorizes temporary work, how access is controlled, what changes are recorded, and how reconciliation occurs after service returns. Do not share accounts or create an unowned spreadsheet as the default recovery route.

Ask suppliers for incident, support, backup, restore, export, and contract-end responsibilities. Record what is verified and what remains unknown.

Close the loop

Classify the root cause as definition, data quality, permission, training, workflow, integration, supplier, policy, or product fit. Record the correction, owner, evidence, and review date. Revisit repeated issues at 30, 60, and 90 days.

Apply the guidance to one school decision

Before approving this guidance for troubleshooting guide for school management software, translate it into one school-specific decision record. State the workflow, roles, data fields, permissions, evidence, support route, calendar constraint, and condition that would hold the next phase.

Run the decision with controlled data and the people who will operate the workflow. Record what was observed, what remains unknown, who owns the unresolved item, and when it will be reviewed. Revisit the record after launch at 30, 60, and 90 days.

Keep product capability, school responsibility, legal advice, and measured outcome as separate questions. If evidence is incomplete, narrow the claim and the release rather than turning an assumption into a promise.

Keep the final result readable to operators and reviewers. It should state what is approved, what is deferred, what remains manual, and how a person reports a problem without creating an uncontrolled copy of school data.

Use a small, representative test set and document its limits. A successful demonstration with ideal data does not establish readiness for transfers, corrections, late payments, absent staff, changed guardians, or a new academic period.

Before publication or rollout, ask an accountable reviewer to challenge the strongest claim. Replace broad language with the exact evidence, population, date, and limitation that the school can stand behind.

Finally, make the handoff explicit. The person who operates the workflow should know where the approved definition lives, which changes require review, how to raise an exception, and which temporary records must be reconciled or removed. This is the difference between advice that sounds complete and guidance that can be used safely during a busy school term.