RSRG Arboretum ITMS

Intelligent Tree Management System - Documentation

RSRG Arboretum ITMS

Intelligent Tree Management System for Digital Arboretum Management

A comprehensive platform for managing tree inventories, interactive mapping, and community engagement at DeKUT Arboretum.

Interactive Mapping

Real-time tree location tracking with GIS integration and visual mapping interface.

Comprehensive Database

Complete tree inventory with maintenance history and growth tracking.

Community Engagement

Newsletter system and feedback collection for community involvement.

Secure Authentication

Custom user authentication with role-based access control.

Mobile Responsive

Fully responsive design optimized for all devices and screen sizes.

System Architecture

Backend Technologies

  • Django 5.1 Framework
  • PostgreSQL with PostGIS
  • Django REST Framework

Frontend Technologies

  • HTML5 & CSS3
  • JavaScript ES6+
  • Tailwind CSS
  • Responsive Design
10+
Core Features
4
Django Apps
15+
API Endpoints
100%
Mobile Ready

Installation Guide

Prerequisites

System Requirements

  • • Python 3.10 or higher
  • • PostgreSQL 12+ with PostGIS extension
  • • 4GB RAM minimum (8GB recommended)
  • • 10GB disk space

Required Software

  • • Git for version control
  • • Node.js (for frontend build tools)
  • • GDAL libraries for geospatial support
  • • Redis (optional, for caching)

Step 1: Clone the Repository

git clone https://github.com/itsrugut/RSRG_Arboretum_ITMS.git
cd RSRG_Arboretum_ITMS

Step 2: Create Virtual Environment

# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux/Mac
python3 -m venv .venv
source .venv/bin/activate

Step 3: Install Dependencies

pip install -r requirements.txt

Note: GDAL wheels are included in the GDAL_wheels/ directory for Windows users.

Step 4: Database Setup

# Create PostgreSQL database
createdb arboretum_db

# Create PostGIS extension
psql arboretum_db -c "CREATE EXTENSION postgis;"

# Run migrations
python manage.py migrate

# Create superuser
python manage.py createsuperuser

Step 5: Environment Configuration

Create a .env file in the project root:

SECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
CSRF_TRUSTED_ORIGINS=http://localhost:8000

DB_ENGINE=django.contrib.gis.db.backends.postgis
DB_NAME=arboretum_db
DB_USER=your_db_user
DB_PASSWORD=your_db_password
DB_HOST=localhost
DB_PORT=5432

Step 6: Run the Development Server

python manage.py runserver

The application will be available at http://localhost:8000/RSRGA_ITMS/

Docker Installation (Alternative)

# Build and run with Docker Compose
docker-compose up -d

# Run migrations
docker-compose exec web python manage.py migrate

# Create superuser
docker-compose exec web python manage.py createsuperuser

Quick Start Guide

Getting Started in 5 Minutes

Follow this guide to get your RSRG Arboretum ITMS up and running quickly.

1

Initial Setup

After installation, log in to the admin panel to configure your system:

http://localhost:8000/RSRGA_ITMS/admin/
2

Add Tree Types

Configure tree species in your arboretum:

  • • Navigate to Tree Management → Tree Types
  • • Add common name, scientific name, and description
  • • Upload representative images for each tree type
3

Configure User Roles

Set up user accounts and permissions:

  • • Create staff accounts for arboretum managers
  • • Configure user groups and permissions
  • • Test authentication system
4

Import Tree Data

Add your existing tree inventory:

  • • Use the CSV upload feature in Tree Inventory
  • • Or manually add trees through the Interactive Map
  • • Include GPS coordinates for accurate mapping
5

Test Core Features

Verify system functionality:

  • • Test the Interactive Map visualization
  • • Check the Newsletter subscription system

First Steps Checklist

Tree Management System

Tree Inventory Management

The Tree Inventory system allows you to maintain a comprehensive database of all trees in your arboretum.

Key Features

  • • Complete tree cataloging with detailed information
  • • GPS coordinate tracking for precise location
  • • Maintenance history and care logs
  • • Tree health status monitoring
  • • Planter and caretaker assignment
  • • Export functionality for reporting

Data Fields

  • • Tree ID and Point Name
  • • Tree Type (Common and Scientific Names)
  • • Geographic Location (Latitude/Longitude)
  • • Planting Date and Planter Information
  • • Current Status (Healthy, Diseased, etc.)
  • • Maintenance Records

Tree Type Configuration

Manage tree species information and reference materials.

Tree Profile Images

Each tree type can have a representative image that helps users identify the species. These images appear in tree details pages with a zoom feature for better viewing.

Field Description Required
Common Name The common name of the tree species Yes
Scientific Name The botanical/scientific name No
Local Name Regional or local name No
Description Detailed description of the tree No
Uses Traditional or practical uses No
Profile Image Representative image of the tree type No

Maintenance History Tracking

Keep detailed records of all maintenance activities performed on trees.

Routine Care

  • • Watering schedules
  • • Pruning activities
  • • Fertilizer application

Health Monitoring

  • • Disease treatment
  • • Pest control measures
  • • Health assessments

Special Care

  • • Storm damage repair
  • • Soil amendments
  • • Growth support systems

Data Import and Export

CSV Import

Bulk import tree data using CSV files with the following format:

Point Name,Tree Type,Latitude,Longitude,Date Planted,Planter,Status
TREE001,Oak Tree,1.2345,-36.7890,2023-01-15,John Doe,Healthy

Data Export

Export tree inventory data for reporting and analysis:

  • • CSV format for spreadsheet applications
  • • Filtered exports based on criteria
  • • Include maintenance history
  • • Statistical summaries

Interactive Mapping System

GIS-Powered Tree Mapping

The Interactive Mapping system provides real-time visualization of tree locations using advanced GIS technology powered by PostGIS and Django's GeoDjango framework.

Mapping Features

  • • Real-time tree location visualization
  • • Interactive markers with detailed tree information
  • • Layer-based filtering (by species, status, etc.)
  • • Satellite and street map views
  • • Distance and area measurement tools
  • • Export map views as images

Navigation Tools

  • • Zoom and pan controls
  • • Search trees by location or name
  • • GPS coordinate display
  • • Clustering for dense tree areas
  • • Full-screen map mode
  • • Mobile-responsive touch controls

Map Layers and Filtering

Tree Layers

  • • All Trees
  • • By Species Type
  • • By Health Status
  • • By Planting Year
  • • Recently Added

Base Maps

  • • Satellite View
  • • Street Map
  • • Terrain Map
  • • Hybrid View
  • • Dark Mode

Map Tools

  • • Measure Distance
  • • Measure Area
  • • Add New Tree
  • • Export View
  • • Print Map

Adding Trees via Map Interface

1

Click "Add Tree" Button

Activate the tree addition mode from the map toolbar.

2

Click on Map Location

Click on the exact location where the tree is planted to capture GPS coordinates.

3

Fill Tree Information

Complete the tree details form with species, planting date, and other relevant information.

4

Save and Verify

Save the tree record and verify its appearance on the map with correct positioning.

Technical Implementation

Backend Technologies

  • • PostGIS for spatial database operations
  • • Django GeoDjango for geometry handling
  • • GDAL libraries for geospatial data processing
  • • RESTful API endpoints for map data

Frontend Integration

  • • Leaflet.js for interactive mapping
  • • AJAX for real-time data updates
  • • Responsive design for mobile devices
  • • Custom markers and popups

Authentication & Security

Custom Authentication System

The RSRG Arboretum ITMS implements a robust custom authentication system with email-based login, role-based access control, and comprehensive security measures.

Security Features

  • • Email-based authentication (no usernames)
  • • Strong password requirements
  • • Rate limiting for login attempts
  • • Secure password reset via email
  • • Session security and timeout
  • • CSRF protection on all forms

Access Control

  • • Role-based permissions system
  • • Admin, staff, and regular user roles
  • • Feature-specific access controls
  • • API token authentication
  • • Secure middleware implementation
  • • Audit logging for sensitive actions

User Registration Process

1

Account Creation

Users register with email, first name, last name, and secure password.

2

Email Verification

Optional email verification process for enhanced security.

3

Role Assignment

Administrators assign appropriate roles and permissions.

4

System Access

Users can log in and access features based on their assigned permissions.

Password Security Requirements

Password Criteria

  • • Minimum 8 characters length
  • • Must contain uppercase and lowercase letters
  • • Must include at least one number
  • • Must contain at least one special character
  • • Cannot be similar to personal information
  • • Cannot reuse last 5 passwords

API Authentication

The system provides token-based authentication for API access.

Getting an API Token

POST /RSRGA_ITMS/auth/api/token-auth/
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "userpassword"
}

Response:
{
  "token": "9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b"
}

Using the Token

GET /RSRGA_ITMS/api/trees/
Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b

Account Deletion

⚠️ Warning

Account deletion is permanent and cannot be undone. All user data will be permanently removed from the system.

How to Delete Your Account

1

Access Your Profile

Click on your profile button in the top-right corner and select "Your Profile"

2

Find the Danger Zone

Scroll to the bottom of your profile page to the "Danger Zone" section

3

Click Delete Account

Click the "Delete Account" button and you'll be taken to a confirmation page

4

Confirm Deletion

Enter your password and type "DELETE" (in capital letters) to confirm

5

Account Deleted

Your account is immediately deleted and you'll be logged out

What Gets Deleted

Permanently Removed:

  • • Personal profile information
  • • Email and authentication credentials
  • • User preferences and settings
  • • Uploaded content and images
  • • Activity history and logs
  • • API tokens and sessions

Before Deleting:

  • • Consider deactivating instead
  • • Export your data if needed
  • • Update privacy settings
  • • Change password if security concern
  • • Contact support for help
  • • Review alternatives available

Security Measures

  • Password verification required
  • Typed confirmation ("DELETE") required
  • Cannot be done via API or automated tools
  • Multiple warnings before final confirmation
  • Easy cancel option at every step

Need Help?

If you're having issues with your account or considering deletion, please contact our support team first. We may be able to help resolve your concerns without deleting your account.

Deployment Guide

Production Deployment

This guide covers deploying the RSRG Arboretum ITMS to a production environment.

Server Requirements

Minimum Specifications

  • • 4 CPU cores
  • • 8GB RAM
  • • 100GB SSD storage
  • • Ubuntu 20.04+ or CentOS 8+

Recommended Specifications

  • • 8+ CPU cores
  • • 16GB+ RAM
  • • 500GB+ SSD storage
  • • Load balancer setup

Environment Setup

# Install system dependencies
sudo apt update
sudo apt install python3-pip python3-venv postgresql postgresql-contrib
sudo apt install postgis postgresql-postgis-scripts
sudo apt install nginx redis-server

# Install GDAL
sudo apt install gdal-bin libgdal-dev

# Create application user
sudo useradd -m -s /bin/bash arboretum
sudo usermod -aG sudo arboretum

Troubleshooting Guide

Common Issues and Solutions

Database Connection Issues

Problem:

Cannot connect to PostgreSQL database

Solutions:

  • • Check if PostgreSQL service is running: sudo systemctl status postgresql
  • • Verify database credentials in .env file
  • • Ensure PostGIS extension is installed
  • • Check firewall settings for database port

Frequently Asked Questions

General Questions

What is the RSRG Arboretum ITMS?

The RSRG Arboretum Intelligent Tree Management System (ITMS) is a comprehensive digital platform for managing tree inventories, providing interactive mapping, and community engagement features for arboretum management.

Who can use the system?

The system is designed for arboretum staff, researchers, students, and the general public. Different user roles have access to different features, with administrators having full management capabilities.

Changelog

Version 2.1.0

Current

Released: September 2025

New Features

  • • Added tree profile images with zoom functionality
  • • Implemented comprehensive documentation system
  • • Enhanced mobile responsiveness
  • • Added AI model performance monitoring
  • • Introduced batch processing for tree identification