# Land Secure - User Manual

## Table of Contents

1. [Getting Started](#1-getting-started)
2. [User Registration](#2-user-registration)
3. [Dashboard Overview](#3-dashboard-overview)
4. [Managing Lands](#4-managing-lands)
5. [Overlap Alerts](#5-overlap-alerts)
6. [Land Certificates](#6-land-certificates)
7. [Sharing Lands](#7-sharing-lands)
8. [Broker Features](#8-broker-features)
9. [Premium Features](#9-premium-features)
10. [Admin Panel](#10-admin-panel)
11. [Troubleshooting](#11-troubleshooting)
12. [Contact Support](#12-contact-support)

---

## 1. Getting Started

### System Requirements
- Modern web browser (Chrome, Firefox, Safari, Edge)
- Internet connection
- GPS-enabled device (for beacon point collection)

### Accessing the System
1. Open your web browser
2. Navigate to: **https://landsecure.co.tz**
3. You will see the login page

---

## 2. User Registration

### Creating a New Account

1. Click **"Register here"** on the login page
2. Select your account type:
   - **Land Owner** - Register and manage your own lands
   - **Broker/Agent** - Manage lands for multiple clients

3. Select subscription type:
   - **Basic** - Free, standard features
   - **Premium** - Enhanced features, more storage

4. Fill in your details:
   - Full Name
   - Username (letters, numbers, underscores only)
   - Email Address
   - Phone Number
   - Password (minimum 8 characters, mixed case, numbers)

5. If referred by a broker, enter their **Broker Code**

6. Click **"Create Account"**

### Account Approval
- **Land Owners**: Automatically approved, can login immediately
- **Brokers**: Require admin approval (usually within 24 hours)

### Logging In
1. Enter your username or email
2. Enter your password
3. Click **"Sign In"**

### Forgot Password
1. Click **"Forgot Password?"** on login page
2. Enter your email address
3. Check your email for reset link
4. Click the link and create new password

---

## 3. Dashboard Overview

After logging in, you'll see your dashboard with:

### Quick Stats
- **Total Lands** - Number of registered lands
- **Total Area** - Combined area of all lands
- **Pending Alerts** - Unresolved overlap alerts
- **Shared Lands** - Lands shared with you

### Recent Activity
- Latest land registrations
- Recent overlap alerts
- System notifications

### Navigation Menu (Sidebar)
- **Dashboard** - Home/overview page
- **My Lands** - View all your lands
- **Add New Land** - Register new land
- **Overlap Alerts** - View boundary conflicts
- **Shared Lands** - Lands shared with you
- **My Profile** - Account settings
- **Contact Us** - Get support
- **Logout** - Sign out

---

## 4. Managing Lands

### Adding a New Land

1. Click **"Add New Land"** in the sidebar
2. Fill in land details:

**Basic Information**
- **Land Name** - Descriptive name (e.g., "Kijenge Farm Plot")
- **Location** - Area/neighborhood name
- **Region** - Select region from dropdown
- **District** - Select district
- **Ward** - Enter ward name

**Land Details**
- **Plot Number** - Official plot number if available
- **Land Use** - Agriculture, Residential, Commercial, etc.
- **Ownership Type** - Freehold, Leasehold, etc.

**Beacon Points (GPS Coordinates)**
- Click **"Add Beacon"** button
- Enter latitude and longitude for each corner
- Minimum 3 points required for a valid polygon
- Or click on the map to add points

**Images**
- Click **"Choose Files"** to upload images
- Basic accounts: 2 images maximum
- Premium accounts: 5 images maximum
- Supported formats: JPG, PNG, GIF

3. Click **"Save Land"**

### Viewing Land Details

1. Go to **"My Lands"**
2. Click on any land card to view details
3. You'll see:
   - Land information
   - Interactive map with boundaries
   - Beacon point coordinates
   - Uploaded images
   - Certificate option

### Editing a Land

1. Open the land you want to edit
2. Click **"Edit Land"** button
3. Modify any fields
4. Click **"Update Land"** to save

### Deleting a Land

1. Open the land you want to delete
2. Click **"Delete"** button
3. Confirm deletion in the popup
4. **Warning**: This action cannot be undone

---

## 5. Overlap Alerts

### Understanding Overlap Alerts

When your land boundaries overlap with another registered land, the system automatically:
1. Detects the overlap
2. Creates an alert for both parties
3. Notifies you via email (if enabled)

### Viewing Alerts

1. Click **"Overlap Alerts"** in sidebar
2. You'll see a list of all alerts
3. Each alert shows:
   - Alert type (overlap detected)
   - Lands involved
   - Date created
   - Status (pending/resolved)

### Responding to Alerts

1. Open the alert details
2. Review the map showing overlap area
3. Options:
   - **Acknowledge** - Accept there is an issue
   - **Dispute** - Contest the overlap
   - **Contact Admin** - Request administrator review

### Resolving Disputes

Administrators will:
1. Review both land records
2. Compare documentation
3. May request additional proof
4. Make a determination
5. Update land records accordingly

---

## 6. Land Certificates

### Generating a Certificate

1. Open the land you want to certify
2. Click **"Generate Certificate"** button
3. Certificate includes:
   - Unique Certificate ID
   - Land details
   - Owner information
   - Beacon coordinates
   - QR code for verification
   - Issue date

### Printing Certificates

1. Generate the certificate
2. Click **"Print Certificate"**
3. Certificates print in color with official styling
4. Recommended: Use good quality paper

### Verifying Certificates

Anyone can verify a certificate:
1. Scan the QR code on the certificate
2. Or visit: landsecure.co.tz/verify
3. Enter the Certificate ID
4. System displays certificate authenticity

---

## 7. Sharing Lands

### Sharing a Land with Others

1. Open the land you want to share
2. Click **"Share"** button
3. Enter recipient's email address
4. Select permission level:
   - **View Only** - Can only view land details
   - **Can Edit** - Can modify land information
5. Click **"Send Invitation"**

### Managing Shared Access

1. Go to land details
2. Scroll to **"Shared With"** section
3. View all people with access
4. Click **"Remove"** to revoke access

### Viewing Lands Shared With You

1. Click **"Shared Lands"** in sidebar
2. View all lands others have shared with you
3. Click to open and view details

---

## 8. Broker Features

### For Brokers

#### Getting Your Broker Code
After admin approval:
1. Go to **"My Profile"**
2. Your unique 6-digit broker code is displayed
3. Share this code with clients

#### Managing Clients

1. Click **"My Clients"** in sidebar
2. View list of all registered clients
3. See their lands and payment status

#### Adding Land for Clients

1. Select client from dropdown
2. Add land with client as owner
3. Client will see land in their account

### For Clients of Brokers

1. During registration, enter broker's code
2. Broker can manage your lands
3. You retain full access to your account
4. Broker sees your lands in their dashboard

---

## 9. Premium Features

### Premium Benefits

| Feature | Basic | Premium |
|---------|-------|---------|
| Land registrations | Unlimited | Unlimited |
| Images per land | 2 | 5 |
| Overlap alerts | Yes | Yes |
| Email notifications | Basic | Priority |
| Certificate generation | Yes | Yes |
| Customer support | Standard | Priority |
| Offline access | Limited | Full |

### Upgrading to Premium

1. Click **"Go Premium"** in sidebar (for basic users)
2. Review premium benefits
3. Select payment method:
   - M-Pesa
   - Bank Transfer
   - Mobile Money
4. Complete payment
5. Account upgraded immediately upon confirmation

### Payment Instructions

**M-Pesa:**
1. Go to M-Pesa menu
2. Select "Lipa na M-Pesa"
3. Enter Paybill: XXXXXX
4. Account: Your username
5. Amount: 10,000 TZS/month

**Bank Transfer:**
- Bank: [Bank Name]
- Account: [Account Number]
- Reference: Your username

---

## 10. Admin Panel

### Accessing Admin Panel

1. Login with admin credentials
2. Click **"Admin Panel"** in sidebar
3. Admin dashboard opens

### Admin Dashboard Features

#### User Management
- View all registered users
- Approve/reject pending accounts
- Suspend or reactivate users
- Change user passwords
- View user activity

#### Land Management
- View all registered lands
- Review disputed lands
- Access any land details
- Generate reports

#### Overlap Management
- Review all overlap alerts
- Mark alerts as resolved
- Make boundary determinations
- Contact affected parties

#### Payment Management
- View all payments
- Record manual payments
- Generate payment reports
- Track premium subscriptions

#### Reports
- User statistics
- Land registration trends
- Revenue reports
- Activity logs

#### Settings
- Payment settings
- Email configuration
- System preferences

---

## 11. Troubleshooting

### Common Issues

#### Can't Login
- Check username/email spelling
- Ensure Caps Lock is off
- Try "Forgot Password" to reset
- Account may be pending approval

#### Map Not Loading
- Check internet connection
- Refresh the page
- Clear browser cache
- Try different browser

#### Can't Add Beacon Points
- Enable GPS/location services
- Minimum 3 points required
- Points must form valid polygon
- Check coordinate format (decimal degrees)

#### Images Won't Upload
- Check file size (max 5MB each)
- Use supported formats (JPG, PNG, GIF)
- Check your subscription limits
- Try compressing the image

#### Certificate Won't Generate
- Ensure all land details are complete
- At least 3 beacon points required
- Wait for page to fully load
- Try refreshing the page

#### Overlap Alert Incorrect
- Review beacon coordinates
- Check if points are accurate
- Contact admin for review
- Provide supporting documentation

### Clearing Browser Cache

**Chrome:**
1. Press Ctrl+Shift+Delete
2. Select "Cached images and files"
3. Click "Clear data"

**Firefox:**
1. Press Ctrl+Shift+Delete
2. Select "Cache"
3. Click "Clear Now"

**Safari:**
1. Go to Safari > Preferences
2. Click Privacy tab
3. Click "Manage Website Data"
4. Remove landsecure.co.tz data

---

## 12. Contact Support

### Support Channels

**Email:**
info@landsecure.co.tz

**Phone:**
+255 781 115 402

**WhatsApp:**
+255 781 115 402
[Click to chat](https://wa.me/255781115402)

**Website:**
www.landsecure.co.tz/contact

### Support Hours
Monday - Friday: 8:00 AM - 6:00 PM (EAT)
Saturday: 9:00 AM - 1:00 PM (EAT)
Sunday: Closed

### When Contacting Support

Please include:
1. Your username or email
2. Description of the problem
3. Steps to reproduce the issue
4. Screenshots if possible
5. Browser and device used

### Response Times

| Priority | Response Time |
|----------|---------------|
| Basic Users | Within 48 hours |
| Premium Users | Within 24 hours |
| Critical Issues | Within 4 hours |

---

## Quick Reference Card

### Keyboard Shortcuts

| Action | Shortcut |
|--------|----------|
| Save form | Ctrl + S |
| Print | Ctrl + P |
| Search | Ctrl + F |
| Refresh | F5 |

### GPS Coordinate Format

Use **Decimal Degrees** format:
- Latitude: -6.812345 (negative for South)
- Longitude: 37.654321 (positive for East)

### File Size Limits

| File Type | Max Size |
|-----------|----------|
| Images | 5 MB each |
| Total per land | 25 MB |

### Support Quick Links

- Login: landsecure.co.tz
- Register: landsecure.co.tz/register
- Contact: landsecure.co.tz/contact
- Verify Certificate: landsecure.co.tz/verify

---

*Land Secure - Securing Your Land, Securing Your Future*

*Manual Version 2.0 - March 2026*
