Urban Tree Observatory Project

Project Overview

The Urban Tree Observatory is a data-driven platform for monitoring and conserving urban trees in Ibagué, Colombia. The project centralizes tree data, enables citizen reporting, and tracks conservation efforts.

Development Environment Setup

Prerequisites

• Docker and Docker Compose
• Git

Getting Started

1. Clone this repository:

   git clone <omdena-repository-url>
   cd urban-tree-observatory

2. Start the development environment:

   docker-compose up

3. Access the different components:

   • Django backend: http://localhost:8000/
   • Django admin: http://localhost:8000/admin/
   • Angular frontend: http://localhost:4200/
   • PostgreSQL database: localhost:5432
   • PgAdmin: http://localhost:5050/

First-Time Setup

After starting the containers for the first time, you'll need to create a superuser:

docker-compose exec backend python manage.py createsuperuser

You can also load initial data fixtures:

docker-compose exec backend python manage.py loaddata species

Project Structure

Backend (Django REST API)

• backend/ - Django project
  • config/ - Django project settings
  • apps/ - Django apps
    • core/ - Shared utilities
    • accounts/ - User management
    • trees/ - Tree data management with GIS
    • reports/ - Citizen reporting system
    • analysis/ - Environmental impact analysis

Frontend (Angular)

• frontend/ - Angular application
  • src/app/ - Angular components and modules
    • core/ - Core functionality
    • shared/ - Shared components
    • features/ - Feature modules
      • map/ - Map visualization
      • trees/ - Tree management interfaces
      • reports/ - Reporting interface
      • analysis/ - Data analysis dashboards

Database

• PostgreSQL with PostGIS for geospatial data

Development Workflow

1. Run the application with Docker Compose
2. Make changes to your code (the development server will auto-reload)
3. Run tests to verify your changes
4. Commit and push your changes

Running Tests

# Backend tests
docker-compose exec backend python manage.py test

# Frontend tests
docker-compose exec frontend ng test

API Documentation

The API documentation is available at:

• Swagger UI: http://localhost:8000/api/v1/swagger/
• ReDoc: http://localhost:8000/api/v1/redoc/

Deployment

For production deployment, see the instructions in docs/deployment/.