User Guide: Compliance Reporting
Last updated: January 15, 2026 Related Stories: Stories 51-52
Overview
Compliance Reporting provides tools for generating reports that meet government audit requirements. This feature enables administrators to track permit processing times, inspection completion rates, fee collection, and other metrics required for regulatory compliance and internal audits.
Prerequisites
Before using Compliance Reporting, ensure:
- User has Administrator or Compliance Officer role
- Access to Entity Manager for data queries
- Calendar App access for inspection metrics
- View permissions for permit records
Accessing Compliance Reports
Navigation
- Log in to the GovAssist Admin Portal
- Navigate to Reports or Dashboard
- Select Compliance from the report categories
- Choose the specific report type
Standard Compliance Reports
Permit Processing Metrics
Track permit application processing performance:
| Metric | Description | Target |
|---|---|---|
| Average Processing Time | Days from submission to approval | < 30 days |
| Backlog Count | Permits pending review | < 50 |
| Completion Rate | Permits processed per month | Based on staffing |
| Rejection Rate | Percentage of denied applications | Monitor trends |
Inspection Compliance
Monitor inspection scheduling and completion:
| Metric | Description | Target |
|---|---|---|
| Inspections Scheduled | Total appointments booked | Track volume |
| Inspections Completed | Successfully finished inspections | > 95% completion |
| Pass Rate | Percentage passing first inspection | Monitor trends |
| Reinspection Rate | Inspections requiring follow-up | < 20% |
| Average Turnaround | Days from request to inspection | < 5 days |
Fee Collection
Track revenue and payment compliance:
| Metric | Description | Target |
|---|---|---|
| Total Fees Collected | Sum of all payments | Budget target |
| Outstanding Balance | Unpaid fees | Minimize |
| Payment Timeliness | Average days to payment | < 30 days |
| Refunds Issued | Total refunds processed | Track trends |
Report Types
Summary Reports
High-level overviews for executive review:
| Report | Contents | Frequency |
|---|---|---|
| Monthly Summary | Key metrics, trends, exceptions | Monthly |
| Quarterly Review | Performance analysis, comparisons | Quarterly |
| Annual Report | Comprehensive yearly statistics | Annually |
Detail Reports
Granular data for operational analysis:
| Report | Contents | Use Case |
|---|---|---|
| Permit Log | All permits with status, dates | Audit trail |
| Inspection Log | All inspections with results | Performance review |
| Payment Log | All transactions with details | Financial audit |
| User Activity | Actions taken by staff | Access audit |
Compliance-Specific Reports
Reports designed for regulatory requirements:
| Report | Purpose | Regulatory Body |
|---|---|---|
| Building Code Compliance | Code adherence tracking | State Building Authority |
| Fire Safety Compliance | Fire inspection completion | Fire Marshal |
| Environmental Compliance | Environmental permit tracking | EPA/State DEP |
| ADA Compliance | Accessibility verification | Federal/State |
Generating Reports
Step 1: Select Report Type
- Navigate to Reports > Compliance
- Choose the report category:
- Permit Processing
- Inspection Metrics
- Fee Collection
- Audit Trails
Step 2: Configure Parameters
| Parameter | Description | Options |
|---|---|---|
| Date Range | Period to analyze | Today, This Week, This Month, Custom |
| Department | Filter by department | All, Building, Fire, etc. |
| Status | Filter by record status | All, Active, Completed, Pending |
| Inspector | Filter by assigned inspector | All, Specific Inspector |
| Permit Type | Filter by permit category | All, Building, Electrical, etc. |
Step 3: Generate Report
- Click Generate Report
- Wait for data processing
- View results in browser or export
Step 4: Export Options
| Format | Description | Use Case |
|---|---|---|
| Formatted document | Official reports, archiving | |
| Excel | Spreadsheet format | Data analysis, manipulation |
| CSV | Comma-separated values | System integration |
| Browser print | Physical copies |
Audit Focus Options
When generating compliance audits, select the focus area:
| Focus | Value | Description |
|---|---|---|
| Compliance Only | compliance_only | Regulatory compliance metrics |
| Budget Only | budget_only | Financial metrics and fees |
| Full Audit | full_audit | Comprehensive all-metrics report |
Key Report Sections
Permit Activity Report
Summary Section:
| Metric | Value | Percentage |
|---|---|---|
| Total Applications | 245 | — |
| Approved | 198 | 80.8% |
| Pending Review | 35 | — |
| Denied | 12 | 4.9% |
| In Progress | 10 | — |
| Withdrawn | 5 | 2.0% |
By Permit Type:
| Permit Type | Count |
|---|---|
| Building | 120 |
| Electrical | 65 |
| Plumbing | 40 |
| Mechanical | 20 |
Processing Times (Days):
| Metric | Value |
|---|---|
| Average | 12.3 |
| Median | 10 |
| Minimum | 2 |
| Maximum | 45 |
Inspection Status Report
Summary Section:
| Metric | Value | Percentage |
|---|---|---|
| Total Scheduled | 450 | — |
| Completed | 435 | 96.7% |
| Cancelled | 10 | — |
| No Show | 5 | 1.1% |
Results:
| Result | Count |
|---|---|
| Pass | 380 |
| Fail | 35 |
| Conditional Pass | 15 |
| Reinspection | 5 |
Inspector Performance:
| Inspector | Inspections Completed |
|---|---|
| John Smith | 85 |
| Sarah Jones | 92 |
| Mike Wilson | 78 |
| Lisa Brown | 90 |
Fee Collection Report
Summary Section:
| Metric | Amount | Percentage |
|---|---|---|
| Total Billed | $125,450 | — |
| Collected | $118,200 | 94.2% |
| Outstanding | $7,250 | — |
| Refunds | $2,100 | — |
By Category:
| Category | Amount |
|---|---|
| Permit Fees | $85,000 |
| Inspection | $28,500 |
| Plan Review | $9,850 |
| Other | $2,100 |
Payment Methods:
| Method | Amount |
|---|---|
| Credit Card | $72,500 |
| ACH/Check | $38,200 |
| Cash | $5,400 |
| Other | $2,100 |
Compliance Metrics Dashboard
Real-Time Indicators
The compliance dashboard displays:
| Indicator | Status Colors | Thresholds |
|---|---|---|
| Processing Backlog | Green/Yellow/Red | Less than 50 / 50-100 / More than 100 |
| Inspection Completion | Green/Yellow/Red | More than 95% / 85-95% / Less than 85% |
| Fee Collection Rate | Green/Yellow/Red | More than 90% / 75-90% / Less than 75% |
| Certification Status | Green/Yellow/Red | All Active/Expiring/Expired |
Risk Assessment
Compliance risk scoring:
| Risk Level | Score | Description |
|---|---|---|
| Low | 90-100% | Meeting all compliance targets |
| Medium | 75-89% | Some targets below threshold |
| High | Below 75% | Multiple compliance concerns |
Scheduled Reports
Configuring Automatic Reports
Set up recurring report generation:
- Navigate to Reports > Scheduled Reports
- Click + Add Schedule
- Configure:
| Setting | Options | Description |
|---|---|---|
| Report Type | Any compliance report | Which report to generate |
| Frequency | Daily, Weekly, Monthly, Quarterly | How often |
| Day/Time | Specific day and time | When to run |
| Recipients | Email addresses | Who receives the report |
| Format | PDF, Excel, CSV | Output format |
Example Schedules
| Report | Frequency | Recipients | Day |
|---|---|---|---|
| Daily Permit Summary | Daily | Operations Manager | Every day, 8 AM |
| Weekly Inspection Report | Weekly | Department Heads | Monday, 9 AM |
| Monthly Compliance Summary | Monthly | Executive Team | 1st of month |
| Quarterly Audit Report | Quarterly | Compliance Officer | 1st of quarter |
Audit Trail Requirements
Required Logging
For compliance, the system logs:
| Event | Data Captured |
|---|---|
| Permit Actions | Create, Update, Delete, Status Change |
| Inspection Events | Schedule, Complete, Cancel, Result |
| Payment Transactions | Charge, Refund, Adjustment |
| User Actions | Login, Logout, Access, Changes |
| Configuration Changes | Settings, Permissions, Entities |
Retention Periods
| Record Type | Retention | Requirement |
|---|---|---|
| Permit Records | 7 years | State requirement |
| Inspection Records | 7 years | State requirement |
| Payment Records | 7 years | Financial requirement |
| Audit Logs | 5 years | Compliance requirement |
Government Reporting Requirements
Building Department Reports
| Report | Frequency | Recipient |
|---|---|---|
| Building Permit Activity | Monthly | State Building Authority |
| Code Compliance Summary | Quarterly | State Building Authority |
| Fee Collection Statement | Annually | County Finance |
Fire Marshal Reports
| Report | Frequency | Recipient |
|---|---|---|
| Fire Inspection Completion | Monthly | State Fire Marshal |
| Fire Code Violations | Quarterly | State Fire Marshal |
| Sprinkler System Compliance | Annually | State Fire Marshal |
Environmental Reports
| Report | Frequency | Recipient |
|---|---|---|
| Environmental Permits Issued | Quarterly | State DEP |
| Violation Tracking | Monthly | State DEP |
| Remediation Status | As required | State DEP |
Custom Report Builder
Creating Custom Reports
For specialized compliance needs:
- Navigate to Reports > Custom Reports
- Click + Create Report
- Select data sources:
- Entities (Permits, Inspections, etc.)
- Date fields
- Status fields
- Calculation fields
Report Elements
| Element | Description |
|---|---|
| Columns | Fields to display |
| Filters | Criteria to apply |
| Grouping | How to aggregate data |
| Sorting | Order of results |
| Calculations | Sums, averages, counts |
| Charts | Visual representations |
Best Practices
Report Management
- Standard Templates: Use consistent report formats
- Scheduled Generation: Automate routine reports
- Archive Reports: Store historical reports for comparison
- Access Control: Limit report access by role
Data Quality
- Regular Audits: Verify data accuracy quarterly
- Exception Review: Investigate outliers
- Trend Analysis: Monitor changes over time
- Cross-Validation: Compare related metrics
Compliance Preparation
- Pre-Audit Review: Run reports before audits
- Documentation: Maintain supporting records
- Gap Analysis: Identify compliance gaps early
- Corrective Actions: Track remediation efforts
Troubleshooting
Common Issues
Q: Report shows no data. A: Check date range parameters. Verify you have permission to view the data. Ensure records exist for the selected criteria.
Q: Metrics don't match expectations. A: Review filter settings. Check for status filtering that may exclude records. Verify calculation methodology.
Q: Cannot export to Excel. A: Check browser pop-up settings. Try a different format. Verify the report size is within limits.
Q: Scheduled report not sending. A: Verify email addresses are correct. Check email server configuration. Review scheduled report logs for errors.
Q: Historical data is missing. A: Check retention policies. Data may have been archived. Contact administrator for archived data access.
Related Documentation
- Audit Logs & History
- Department Manager Dashboard
- Fee Definitions
- Process Library Configuration
- Role-Based Access Control
Technical Reference
Source Components:
- Audit Generator:
apps/govt-assist-frontend/src/pages/admin/AuditGenerator/ - Contract Analysis:
apps/govt-assist-frontend/src/pages/admin/ContractAnalysis/ - Dashboard Service:
apps/calendar-app/src/services/Dashboard/ - Entity Records:
apps/entity-manager-app/src/services/
API Endpoints:
- Appointment Status Distribution:
/appointments/status/distribution - Permit Type Distribution:
/appointments/permit-type/distribution - User Distribution:
/appointments/user/distribution
For additional assistance, contact your System Administrator or Compliance Officer.