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
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.
Initial Setup
After installation, log in to the admin panel to configure your system:
http://localhost:8000/RSRGA_ITMS/admin/
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
Configure User Roles
Set up user accounts and permissions:
- • Create staff accounts for arboretum managers
- • Configure user groups and permissions
- • Test authentication system
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
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
Click "Add Tree" Button
Activate the tree addition mode from the map toolbar.
Click on Map Location
Click on the exact location where the tree is planted to capture GPS coordinates.
Fill Tree Information
Complete the tree details form with species, planting date, and other relevant information.
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
Account Creation
Users register with email, first name, last name, and secure password.
Email Verification
Optional email verification process for enhanced security.
Role Assignment
Administrators assign appropriate roles and permissions.
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
Access Your Profile
Click on your profile button in the top-right corner and select "Your Profile"
Find the Danger Zone
Scroll to the bottom of your profile page to the "Danger Zone" section
Click Delete Account
Click the "Delete Account" button and you'll be taken to a confirmation page
Confirm Deletion
Enter your password and type "DELETE" (in capital letters) to confirm
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
CurrentReleased: 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