Real Estate Manual
How buyers find a property, how brokers add listings, and how Terratech checks them. Step by step.
Goal: every person can do their own job on a phone. Buyers find and ask. Brokers publish. Reviewers keep the map honest. The screens are English only for now.
About the pictures: they come from a test copy of the system. All names, phone numbers and listings in them are made up.
Who does what
| Person | Login needed | Does |
|---|---|---|
| Buyer | None (saving a search needs a login) | Looks at listings, asks the broker, reports a bad listing |
| Broker | Broker account, made by Terratech after a request | Adds listings, reads enquiries, keeps the profile |
| Reviewer | Terratech reviewer or higher | Approves brokers, listings, photos and logos |
Important: the demo listings (70 made-up listings and 6 made-up agents) are not real. Real brokers add real listings.
Part AFind a property Buyer
- Open the web map. No login is needed. Listings show as pins and as a strip of cards at the bottom.
The filter chips at the top. Tap the ringed chip. - Use the chips: All For sale Rent Land Price 3+ beds. You can also type a place in the search box, use Near a place (500 m, 1 km or 2 km) or Draw an area.
- Tap Price to set a minimum and a maximum.
The price filter. Type a number in the ringed field. - Tap a pin or a card. The popup shows the price and the agent. You can also use Directions, Nearby, Share, Save, Compare.
- To contact the agent, tap Call or WhatsApp. Or tap Ask the agent.
The listing popup. Tap the ringed button to write a message. - Write your name, your phone and a message (up to 500 letters). Tap Send. You do not need to log in. The message goes to the broker under Enquiries. No email is sent. Messages are deleted after 90 days.
The enquiry form with made-up data. - Saving a search needs a login. You can keep up to 10 saved searches.
Report a bad listing
- In the popup tap Report this listing.
- Choose a reason: Wrong price Already sold or rented Fake or spam Wrong place on the map Something else. You may add a note (up to 300 letters).
- Tap Send report. A report does not hide the listing. A reviewer reads it and decides.
The report form. Choose one reason.
Part BAdd and manage listings Broker
1. Ask for a broker account
- Open the web map. Tap Account, then Staff login, then Become a broker.
Tap the ringed button. - Fill in: your name, email and phone. Agency, WhatsApp and a short text about you are optional. There is no password in this form.
- Tap Send request. The request waits for Terratech.
The request form. Made-up data. - When Terratech approves, you get a setup code. Use I have a setup code on the login screen and choose your own password there. Keep the code and the password private.
2. Look at your listings
- Log in. Open Account and tap My listings.
The Account menu after login. - The Overview shows how many listings are live, how many are drafts or waiting, views, saves and new enquiries. The card Your badges can show Verified agent, Fast replies and Active listings. A badge you have not earned says "Not yet" and why. No number is shown to the public. (The badge rules are still a proposal.)
The Overview. The ringed button starts a new listing.
3. Add a new listing
- Tap New listing. Fill in the title, type (house, land ...), for sale or rent, price in USD, rooms, areas, district and address.
The first part of the form. Made-up listing. - Write a description of at least 30 letters. Tick the features that are true (water, electricity, parking ...).
- Set the Property place: tap Pick on map or My location. Optional: draw the Land boundary by clicking or by walking with GPS. Optional: set the Access point (where directions should end).
- Add up to 10 photos with Add photo. Rejected photos do not count.
- Tap Save changes to keep a draft. A new listing is always saved as a draft first. Nobody else sees a draft.
- When ready, tap Publish. To publish you need a price above 0, a description of at least 30 letters and at least 1 photo. The screen tells you what is missing.
The lower part of the form. Tap the ringed button to publish.
Trusted or not: a trusted broker goes live at once. A broker that is not trusted gets the state Waiting for approval until a reviewer approves. An approved listing stays live for 60 days.
4. Keep listings fresh
- Open My listings. Use the filters: All, Draft, Waiting for approval, Active, Sold, Rented, Withdrawn, Deleted.
Each listing has Show on map, Edit and Delete. - Renew adds 60 days to a live listing.
- When the property is gone, use Mark as sold, Mark as rented or Withdraw.
- Delete moves the listing to Deleted listings. You can restore it for 30 days.
- Open Enquiries to read the messages from buyers. Mark them read or closed. Call the buyer yourself.
5. Profile, logo and your page
- Tap Profile and logo. You see your name, agency, phone and WhatsApp. Verified and Trusted are set by Terratech. You cannot change them.
- Tap Upload logo. A logo waits for a reviewer, unless you are trusted.
The profile screen. Made-up data. - Under Your page name type a short name: 3 to 40 letters a-z, digits and single hyphens. A good name is "name-town". The screen says if the name is free. Tap Save name.
Choose a page name, then Save name. - Under Contact numbers write phone and WhatsApp with the country code, for example +252 63 123 4567. A number that starts with 0 is refused.
- Your public page is
/a/<your name>. Use Copy link to share it. A QR code is shown too.Copy the link and share it.
Page not available: the page is public only when you are a verified broker and have at least one active listing. In every other case buyers see "Page not available". If you change the name, the old name goes to the new one for 30 days.
Part CCheck brokers and listings Reviewer
- Log in as a Terratech reviewer. Open the staff panel and choose Review real estate. The tabs are: Today, Sign-ups, Listings, Enquiries, Reports, Brokers, Photos, Logos, Drawings.
- Sign-ups: read the request. Tap Approve to make the broker account. The screen then shows the setup code. Send it to the broker yourself. Or tap Reject.
A pending broker request. Made-up data. - Listings: these are listings of brokers that are not trusted. Look at the price, text, photos and place on the map. Tap Approve to make it public.
A listing that waits. Approve or Reject. - To refuse, tap Reject. You must write a reason (up to 500 letters). The broker can read it, fix the listing and send it again.
The reason is required. - Brokers: tap Trust this broker only after you have seen good listings from them. A trusted broker publishes at once, with no review. You can switch trust off again.
Trust is a strong step. Use it with care. - Photos and Logos wait here too. Reports shows what buyers reported. A report never hides a listing by itself. Enquiries shows messages about demo listings.
Rule: approve only what you have checked. If a listing looks fake, reject it and write why.
Problems
| Problem | What to do |
|---|---|
| Publish says "you still need: at least 1 photo" | Add a photo. Also check the price (above 0) and the description (30 letters or more). |
| My listing says Waiting for approval | You are not trusted yet. A reviewer will check it. Ask Terratech if it takes long. |
| My listing is not on the map | It is a draft, waiting, sold, withdrawn, or older than 60 days. Use Renew. |
| My page says "Page not available" | You need to be verified and have an active listing. Terratech can also switch a page off. |
| Page name refused | Use 3 to 40 letters a-z, digits and single hyphens. Some words are reserved. The name may be taken. Try "name-town". |
| Phone number refused | Start with the country code, for example +252. |
| A buyer wrote but I see nothing | Open My listings, then Enquiries. No email is sent. |
| A buyer reports a good listing | A report does not hide it. The reviewer decides. |
Based on docs/modules/REAL-ESTATE.md, docs/specs/BROKER-BADGES.md (status: proposed) and docs/specs/AGENT-PAGE.md. Standards: ITU-T E.164 for phone numbers; Open Graph for link previews.