Houses and residents

There are two ways into the same data, and it's worth knowing which to use.

  • Admin → Houses — start from a property. "Who lives at 12A Jalan Mawar?"
  • Admin → Users — start from a person. "Which houses does Ahmad belong to?"

Use Houses for day-to-day work. Use Users when someone owns more than one property, or when you're chasing a person whose house you don't know.

Houses

New house takes a house number and a street. You can edit both later.

Keep street names consistent — "Jalan Mawar 1" and "Jln Mawar 1" will read as two separate streets forever, and nothing will warn you.

The house detail screen shows its members and lets you add, edit, or remove them.

Members

Add member takes a name, a phone number, and a role:

  • Owner — can add and remove other members of their household themselves.
  • Tenant — can use everything else, but can't change who lives there.

Delegate. Add the owner, mark them main contact, and let them add their own household. For a community of any size this is far less work than doing it yourself, and the owner knows their own tenants better than you do.

The phone number is the account

There's no invitation to accept and no password to issue. The resident signs in with WhatsApp using that number, and they're in.

Which means a wrong number is an invisible failure: the resident just can't get in, sees nothing explaining why, and eventually complains. Check numbers when you enter them.

Main contact

One member per house should be the main contact. They receive the community's invoices.

A house with no main contact is skipped when you create a collection. You'll see a count of skipped houses right after creating one, but not who they were — so it's much easier to get this right up front than to reconcile later. Set a main contact on every house as you create it.

Users

Admin → Users lists everyone with any standing in the community, including admins and guards.

Add user creates a person without attaching them to a house yet. If the phone number already belongs to an existing Teras user — someone who lives in another community using Teras — they're added to yours without their existing name being overwritten.

From a user's detail screen you can assign them to a house, change their role in a house, or remove the assignment. This is the path for someone who owns two units, or a committee member who needs admin access but doesn't live on site.

Moving someone out

Remove them from the house. Their access to that household — passes, visitors, bills, vehicles — goes immediately.

One caveat worth knowing: removing a member drops their standing in the community outright. If that person is also a guard, or belongs to another house, check their Users entry afterwards to confirm you haven't removed access you meant to keep.