Violations
File violations, track notices, add evidence, manage statuses, record fine payments, and understand resident visibility.
Overview
The Violations module documents formal HOA rule enforcement. It should be used after the board has made reasonable attempts to communicate and resolve issues informally.
Violations are visible to the assigned resident in the resident portal. Filing or updating violations can also create resident notifications.
List Page
The list page includes:
- Search by description, category, or homeowner name
- Status filter
- Open, escalated, notified, and resolved counts
- CSV export
- New violation action
- Deleted violation view
- Pagination
The page displays a reminder that violations should be a last resort, not the first response.
Violation Statuses
| Status | Meaning |
|---|---|
| Open | Created but not formally advanced |
| Notified | Resident has been formally notified |
| Escalated | Needs additional board attention or enforcement |
| Resolved | Corrected or fine satisfied |
| Dismissed | Board dismissed the notice |
Changing to resolved saves a resolved date. Escalated violations trigger board notifications.
Creating a Violation
When creating a violation, the board selects:
- Homeowner
- Category
- Description
- Optional fine
- Optional template content
New violations start as open. Creation:
- Logs an audit event.
- Notifies board members of a new violation.
- Notifies the assigned resident when resident violation notifications are enabled.
- Makes the notice visible in the resident portal.
Detail Page
The violation detail page can include:
- Homeowner link
- Category
- Description
- Fine amount
- Status
- Issued/resolved dates
- Evidence photos
- Notes and resident responses
- Workflow timeline
- Fine payment actions
- Generated violation letter/report links
- Audit history
Use the detail page as the case file for a notice.
Notes and Resident Responses
Board notes and resident responses are stored on the violation. Resident responses are flagged as resident-originated and notify the board.
Use notes for:
- Contact attempts
- Evidence comments
- Board decisions
- Resident explanations
- Follow-up deadlines
Evidence Photos
Boards can upload and delete photos on a violation. Files are stored in the community's violation folder and shown through signed URLs.
Deleting a photo removes it from the violation record and deletes the stored file.
Fine Payments
The board can record a violation fine payment. Recording a fine payment:
- Adds an income transaction categorized as fine payment.
- Recalculates total paid for the violation.
- Automatically resolves the violation when paid amount meets or exceeds the fine.
- Revalidates violations and financials.
Online fine payment may also be available to residents when Stripe Connect is active.
Bulk Status Updates
Bulk actions can update selected violations to:
- Open
- Notified
- Resolved
- Escalated
- Dismissed
An optional note can be added to all selected records. Bulk actions are restricted to records in the current community and logged in the audit trail.
Delete and Restore
Presidents can soft-delete violations. Deleted violations are hidden from the default list and homeowner detail, but remain recoverable in the deleted view.
Restore brings the violation back and logs the action.
Automation
If auto-escalation is enabled in Settings, open or notified violations older than the configured threshold are automatically escalated by the daily escalation job. System escalations are logged as automated actions.