https://github.com/dr-rompecabezas/urban-tree-observatory
Urban Tree Observatory: Data-Driven Monitoring & Conservation in Ibagué, Colombia
https://github.com/dr-rompecabezas/urban-tree-observatory
angular data-science django docker geodjango gis postgis postgresql python
Last synced: 7 months ago
JSON representation
Urban Tree Observatory: Data-Driven Monitoring & Conservation in Ibagué, Colombia
- Host: GitHub
- URL: https://github.com/dr-rompecabezas/urban-tree-observatory
- Owner: dr-rompecabezas
- License: mit
- Created: 2025-03-23T02:56:25.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-23T19:03:11.000Z (7 months ago)
- Last Synced: 2025-03-23T20:19:41.384Z (7 months ago)
- Topics: angular, data-science, django, docker, geodjango, gis, postgis, postgresql, python
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```bash
git clone
cd urban-tree-observatory
```
2. Start the development environment:
```bash
docker-compose up
```
3. Access the different components:
- Django backend:
- Django admin:
- Angular frontend:
- PostgreSQL database: localhost:5432
- PgAdmin:
### First-Time Setup
After starting the containers for the first time, you'll need to create a superuser:
```bash
docker-compose exec backend python manage.py createsuperuser
```
You can also load initial data fixtures:
```bash
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
```bash
# 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:
- ReDoc:
## Deployment
For production deployment, see the instructions in `docs/deployment/`.