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

PersonLogin neededDoes
BuyerNone (saving a search needs a login)Looks at listings, asks the broker, reports a bad listing
BrokerBroker account, made by Terratech after a requestAdds listings, reads enquiries, keeps the profile
ReviewerTerratech reviewer or higherApproves 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

  1. Open the web map. No login is needed. Listings show as pins and as a strip of cards at the bottom.
    The web map with filter chips. A red ring marks the For sale chip.
    The filter chips at the top. Tap the ringed chip.
  2. 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.
  3. Tap Price to set a minimum and a maximum.
    The Price filter with Min and Max fields. A red ring marks the Max field.
    The price filter. Type a number in the ringed field.
  4. Tap a pin or a card. The popup shows the price and the agent. You can also use Directions, Nearby, Share, Save, Compare.
  5. To contact the agent, tap Call or WhatsApp. Or tap Ask the agent.
    A listing popup with Call, More details, Ask the agent and Report this listing. A red ring marks Ask the agent.
    The listing popup. Tap the ringed button to write a message.
  6. 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 Ask the agent form with name, phone and message. A red ring marks the Send button.
    The enquiry form with made-up data.
  7. Saving a search needs a login. You can keep up to 10 saved searches.

Report a bad listing

  1. In the popup tap Report this listing.
  2. 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).
  3. Tap Send report. A report does not hide the listing. A reviewer reads it and decides.
    The report form with the reasons. A red ring marks the Fake or spam reason.
    The report form. Choose one reason.

Part BAdd and manage listings Broker

1. Ask for a broker account

  1. Open the web map. Tap Account, then Staff login, then Become a broker.
    The staff login screen. A red ring marks the Become a broker button.
    Tap the ringed button.
  2. Fill in: your name, email and phone. Agency, WhatsApp and a short text about you are optional. There is no password in this form.
  3. Tap Send request. The request waits for Terratech.
    The broker request form with made-up data. A red ring marks the Send request button.
    The request form. Made-up data.
  4. 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

  1. Log in. Open Account and tap My listings.
    The Account menu of a logged-in broker. A red ring marks the My listings button.
    The Account menu after login.
  2. 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 broker Overview with counters and the New listing button. A red ring marks New listing.
    The Overview. The ringed button starts a new listing.

3. Add a new listing

  1. Tap New listing. Fill in the title, type (house, land ...), for sale or rent, price in USD, rooms, areas, district and address.
    The listing form with title, type, price, rooms and district. A red ring marks the Title field.
    The first part of the form. Made-up listing.
  2. Write a description of at least 30 letters. Tick the features that are true (water, electricity, parking ...).
  3. 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).
  4. Add up to 10 photos with Add photo. Rejected photos do not count.
  5. Tap Save changes to keep a draft. A new listing is always saved as a draft first. Nobody else sees a draft.
  6. 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 listing form with the map, boundary, access point, Save changes and Publish buttons. A red ring marks Publish.
    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

  1. Open My listings. Use the filters: All, Draft, Waiting for approval, Active, Sold, Rented, Withdrawn, Deleted.
    The list of own listings with Show on map, Edit and Delete buttons. A red ring marks Edit.
    Each listing has Show on map, Edit and Delete.
  2. Renew adds 60 days to a live listing.
  3. When the property is gone, use Mark as sold, Mark as rented or Withdraw.
  4. Delete moves the listing to Deleted listings. You can restore it for 30 days.
  5. Open Enquiries to read the messages from buyers. Mark them read or closed. Call the buyer yourself.

5. Profile, logo and your page

  1. Tap Profile and logo. You see your name, agency, phone and WhatsApp. Verified and Trusted are set by Terratech. You cannot change them.
  2. Tap Upload logo. A logo waits for a reviewer, unless you are trusted.
    The profile screen with Verified and Trusted. A red ring marks the Upload logo button.
    The profile screen. Made-up data.
  3. 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.
    The page name field with the text sample-homes-hargeisa. A red ring marks the Save name button.
    Choose a page name, then Save name.
  4. 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.
  5. Your public page is /a/<your name>. Use Copy link to share it. A QR code is shown too.
    The link of the agent page with a Copy link button. A red ring marks Copy link.
    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

  1. 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.
  2. 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.
    The Sign-ups tab with a pending request. A red ring marks the Approve button.
    A pending broker request. Made-up data.
  3. 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.
    The Listings tab with a listing waiting for approval. A red ring marks the Approve button.
    A listing that waits. Approve or Reject.
  4. 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 reject form with the reason box. A red ring marks the Send rejection button.
    The reason is required.
  5. 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.
    The Brokers tab. A red ring marks the Trust this broker button.
    Trust is a strong step. Use it with care.
  6. 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

ProblemWhat 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 approvalYou are not trusted yet. A reviewer will check it. Ask Terratech if it takes long.
My listing is not on the mapIt 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 refusedUse 3 to 40 letters a-z, digits and single hyphens. Some words are reserved. The name may be taken. Try "name-town".
Phone number refusedStart with the country code, for example +252.
A buyer wrote but I see nothingOpen My listings, then Enquiries. No email is sent.
A buyer reports a good listingA 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.