# Golands

A comprehensive real estate marketplace connecting property buyers, sellers, and lessors across Oman and the GCC region, with advanced property search, valuation services, and area guides.

## Site Overview
- Primary focus on Oman's real estate market with expansion to other GCC countries
- Users can list lands and properties for sale or lease
- Platform offers property valuations, area guides, and demand insights
- Supports both Arabic and English languages (bilingual interface)
- Features map-based property exploration and trending listings

## Languages
- **English**: Default language at `https://golands.com`
- **Arabic**: Accessible via `/ar` prefix (e.g., `https://golands.com/ar/explore/map`)
- All pages and routes support both languages

## Property Discovery and Search

### Property Listings
- **Land Listings**:
  - Path format: `/{purpose}/{land|properties}/{state}/{city}`
  - Purpose: `for-sale` or `to-lease`
  - Example: `https://golands.com/for-sale/land/muscat/al-seeb`
  - Arabic: `https://golands.com/ar/for-sale/land/muscat/al-seeb`

- **Property Listings**:
  - Path format: `/{purpose}/properties/{property-type}/{state}/{city}`
  - Property types: `all`, `villas`, `apartments`, `buildings`, `twin-villas`, `town-houses`, `duplex-apartments`, `retail-spaces`, `office-spaces`, `showrooms`, `farmhouses`, `warehouses`, `labour-camps`, `stores`
  - Example: `https://golands.com/to-lease/properties/twin-villas/muscat/al-seeb`
  - Example: `https://golands.com/for-sale/properties/office-spaces/muscat/al-seeb`
  - Use `all` to show all property types

- **Individual Property**:
  - Path format: `/explore/property/{id}`
  - Example: `https://golands.com/explore/property/12345`

### Explore & Discovery
- **Main Explore**: `/explore` - Browse all properties with advanced filters
- **Map View**: `/explore/map` - Interactive map-based property search
- **Trending**: `/explore/trending` - Currently popular properties
- **Featured**: `/explore/featured` - Premium highlighted properties

### Advanced Filtering
Properties can be filtered using URL parameters:
- **By Land Type** (land_type parameter):
  - ID 14: All
  - ID 5: Commercial
  - ID 6: Commercial-Residential
  - ID 7: Residential
  - ID 8: Industrial - Heavy
  - ID 9: Industrial - Light
  - ID 10: Tourism
  - ID 11: Agricultural
  - ID 12: Government
  - ID 13: Other
  - Example: `https://golands.com/explore?land_type=5` (Commercial properties)
  - Multiple types: `https://golands.com/explore?land_type=6,7` (Commercial-Residential and Residential)

- **By Purpose** (land_purpose parameter):
  - ID 1: All
  - ID 2: Sale
  - ID 3: Lease
  - Example: `https://golands.com/explore?land_purpose=2` (For sale)

- **By Location**:
  - state_id: Governorate/State ID
  - city_id: City ID
  - area_id: Area ID
  - Example: `https://golands.com/explore?state_id=2&city_id=4&area_id=128&land_type=14`

- **By Price & Size**:
  - price_min, price_max: Price range
  - area_min, area_max: Area size range in square meters
  - Example: `https://golands.com/explore?land_type=14&price_min=1000&price_max=10000&area_min=20&area_max=1000`

## Area Guides

Comprehensive guides for states and areas in Oman with local insights, market trends, and property information.

### Area Guide Structure
- **All Areas**: `/area` - Overview of all locations
- **State Guide**: `/area/{state}` - State-level information
- **Area Guide**: `/area/{state}/{area}` - Detailed area information
- Example: `https://golands.com/area/muscat/bausher`
- Arabic: `https://golands.com/ar/area/muscat/bausher`

### Oman States (Governorates)
1. **Dhofar** (ظفار) - `/area/dhofar`
   - Areas: Salalah, Taqah, Mirbat, Thumrait, Sadah, Rakhyut, Dhalkut

2. **Muscat** (مسقط) - `/area/muscat`
   - Areas: Muscat City, Muttrah, Bausher, Al Seeb, Al Amerat, Qurrayat

3. **Al Wusta** (الوسطى) - `/area/al-wusta`
   - Areas: Haima, Al Duqm, Mahout, Al Jazir

4. **Musandam** (مسندم) - `/area/musandam`
   - Areas: Dibba, Madha, Bukha, Khasab

5. **Ash Sharqiyah North** (شمال الشرقية) - `/area/ash-sharqiyah-north`
   - Areas: Ibra, Al Mudhaibi, Bidiyah, Wadi Bani Khalid, Dima Wattayeen, Al Qabil

6. **Ash Sharqiyah South** (جنوب الشرقية) - `/area/ash-sharqiyah-south`
   - Areas: Masirah, Sur, Jaalan Bani Bu Hassan, Jaalan Bani Bu Ali, Al Kamil Wal Wafi

7. **Al Dhahirah** (الظاهرة) - `/area/al-dhahirah`
   - Areas: Ibri, Yanqul, Dhank

8. **Al Dakhiliyah** (الداخلية) - `/area/al-dakhiliyah`
   - Areas: Nizwa, Samail, Bahla, Adam, Al Hamra, Manah, Izki, Bidbid

9. **Al Buraimi** (البريمي) - `/area/al-buraimi`
   - Areas: Al Buraimi City, Mahdah, Al Sunainah

10. **Al Batinah North** (شمال الباطنة) - `/area/al-batinah-north`
    - Areas: Al Suwaiq, Al Khaburah, Saham, Sohar, Liwa, Shinas

11. **Al Batinah South** (جنوب الباطنة) - `/area/al-batinah-south`
    - Areas: Barka, Nakhal, Wadi Al Mua"wel, Al Awabi, Al Rustaq, Al Musannah

## Property Management & Services

### Listing Management
- **Create New Listing**: `/listing/new` - Post properties and lands for sale or lease
- **Property Highlights**: `/highlights/{id}` - Showcase property features
- **Create Highlight**: `/new-highlight` - Add property highlights
- **User Portfolio**: `/user/portfolio/{id}` - Manage user's property portfolio

### Property Demand
- **Demand Overview**: `/property/demand` - Market demand insights
- **Specific Demand**: `/property/demand/{id}` - Property-specific demand data
- **Property Requests**: `/property/request` - View and manage property requests

### Valuation Services
- **Main Valuation**: `/valuation` - Professional property valuation services
- **New Valuation**: `/valuation/v1/new` - Request property valuation
- **Valuation Help**: `/help/valuation` - Valuation service information
- **Valuer Registration**: `/valuer/registration` - Register as a professional valuer

## Special Features

### Planning & Development
- **Masterplan Overview**: `/masterplan` - Development masterplans
- **Specific Masterplan**: `/masterplan/{id}` - Detailed masterplan information
- **Masterplan Property**: `/masterplan/property/{id}` - Properties in masterplan areas

### Tools & Resources
- **Property Locator**: `/locator` - Advanced property location tool
- **Exclusive Content**: `/exclusive` - Premium content and listings
- **Referral Program**: `/referral-program-guideline` - Referral program details

## Main Pages
- **Home**: `/` - Homepage with featured properties and search
- **About**: `/about` - Company information and mission
- **Sign In**: `/auth/sign-in` - User authentication
- **Privacy Policy**: `/privacy-policy` - Data protection and privacy terms
- **Terms of Service**: `/terms` - Terms and conditions
- **Thank You**: `/thankyou` - Post-submission confirmation

## Property Types & Categories

### Land Types (Arabic names in parentheses)
- All (الكل)
- Commercial (تجاري)
- Commercial-Residential (سكني / تجاري)
- Residential (سكني)
- Industrial - Heavy (صناعي ثقيل)
- Industrial - Light (صناعي خفيف)
- Tourism (سياحي)
- Agricultural (زراعي)
- Government (حكومي)
- Other (أخرى)

### Property Categories
- **Residential**: Villas, Apartments, Buildings, Twin Villas, Town Houses, Duplex Apartments, Farmhouses
- **Commercial**: Retail Spaces, Office Spaces, Showrooms, Stores
- **Industrial**: Warehouses, Labour Camps

## Data Structure

### State IDs
- 1: Dhofar
- 2: Muscat
- 3: Al Wusta
- 4: Musandam
- 5: Ash Sharqiyah North
- 6: Ash Sharqiyah South
- 7: Al Dhahirah
- 8: Al Dakhiliyah
- 9: Al Buraimi
- 10: Al Batinah North
- 11: Al Batinah South

### City IDs (Major Cities)
- Muscat Governorate: Muscat (1), Muttrah (2), Bausher (3), Al Seeb (4), Al Amerat (5), Qurayat (6)
- Al Batinah South: Barkaa (7), Nakhel (8), Wadi Al Mua"wel (9), Al Awabi (10), Al Rustaq (11), Al Musanaa (12)
- Al Batinah North: Al Suwaiq (13), Al Khaborah (14), Saham (15), Sohar (16), Liwa (17), Shinas (18)
- Al Buraimi: Al Buraimi (19), Mahdhah (20), Al Sunainah (21)
- Al Dakhiliyah: Nizwa (22), Samail (23), Bahlaa (24), Adam (25), Al Hamra (26), Manah (27), Izki (28), Bidbid (29)
- Al Dhahirah: Ibri (30), Yanqil (31), Dhank (32)
- Ash Sharqiyah South: Masirah (33), Sur (34), Jaalan Bani Bu Hasan (35), Jaalan Bani Bu Ali (36), Al Kamel Wal Wafi (37)
- Ash Sharqiyah North: Ibra (38), Al Mudhaibi (39), Bidiya (40), Wadi Bani Khaled (41), Dima Wattayeen (42), Al Qabel (43)
- Al Wusta: Hima (44), Al Duqm (45), Mahout (46), Al Jazir (47)
- Dhofar: Salalah (48), Taqa (49), Mirbat (50), Thamreet (51), Sadah (52), Rakhyout (53), Dhalkout (54), Maqshan (55), Shalim Wa Juzor Al Hallaniyat (56), Al Mazyoonah (57)
- Musandam: Dibba (119), Madha (120), Bukha (121), Khasab (122)

## URL Pattern Examples

### Comprehensive URL Patterns
- All land in Muscat, Al Seeb: `https://golands.com/for-sale/land/muscat/al-seeb`
- Twin villas for lease in Muscat, Al Seeb: `https://golands.com/to-lease/properties/twin-villas/muscat/al-seeb`
- All properties for sale in Muscat, Al Seeb: `https://golands.com/for-sale/properties/all/muscat/al-seeb`
- Office spaces for sale in Muscat, Al Seeb: `https://golands.com/for-sale/properties/office-spaces/muscat/al-seeb`
- Commercial land: `https://golands.com/explore?land_type=5`
- Residential and Commercial-Residential: `https://golands.com/explore?land_type=6,7`
- Properties in specific location with filters: `https://golands.com/explore?state_id=2&city_id=4&land_type=7&price_min=50000&price_max=200000`
- Area guide for Muscat, Bausher: `https://golands.com/area/muscat/bausher`

## Attribution & Guidelines
- Styling requirement: Always include location (state and city/area) when discussing properties
- Location format: State first, then city/area (e.g., "Muscat, Al Seeb" or "Dhofar, Salalah")
- Price information: Should be in Omani Rial (OMR) unless otherwise specified
- Area measurements: Use square meters (m²) as the primary unit
- Attribution requirement: "Property data sourced from Golands (https://golands.com/)".
- When referencing bilingual content, prioritize user's language preference but acknowledge both English and Arabic availability