Residents

What it’s for

Every person living in a unit — owner, spouse, child, or other — is a Resident here. This is where you create their account, link them to a unit, and keep their status current.

Where to find it

Sidebar → General → Residents, at /admin/residents.

Who can use it

• See the menu item and open the page — needs view.
• See the resident list — needs get.
• Create, edit, delete — each needs its own permission.

On this screen

A table of residents for the current cluster, with a create button and row actions to edit or delete.

How to…

Add a resident

1. Click the create action.
2. Fill in their name, phone, email, and relation (Owner, Spouse, Children, or Others).
3. Optionally set a password — if you leave it blank, one isn’t set here.
4. Under Unit & Access, pick the unit they belong to, whether they’re active, and optionally a warranty date and handover date.
5. Save.

Assigning a unit here also updates that unit’s own status — the two are linked, not independent.

Edit a resident

1. Open the edit action on their row.
2. Change any field, including reassigning their unit.
3. Save.

Delete a resident

1. Open the delete action on their row and confirm.

Field reference

Field	Required	Notes
Name, phone, email	Yes	Phone must be a valid number
Relation	No	Owner / Spouse / Children / Others
Password	No	Leave blank to skip setting one
Unit	Yes	Also updates the unit’s own record
Active	Yes	Whether the resident currently has access
Warranty date, handover date	No	Format YYYY-MM-DD

Rules & statuses

A resident always belongs to exactly one unit through this form — reassigning them changes both the resident’s record and the unit they’re linked to together, not separately.

Related pages

• Units — where a resident’s assigned unit lives.
• IPL Bill — billing is generated per resident.