A Django web platform for tracking ecological restoration sites, managing carbon credit verification, and monitoring environmental impact across East Africa.
# Ecosystem Restoration Platform — Carbon Kenya
A Django-based web platform for tracking ecological restoration progress, verifying carbon credits, and monitoring environmental impact. Built for smallholder farmers and project managers across East Africa.
---
## Project Status
**Phase 4 Complete — Deployment Ready**
All MVP Core phases are complete. The application is functional, deployment-configured, and running in production mode.
---
## Features
- Site creation via interactive map (click-to-place using LeafletJS)
- Photo evidence uploads linked to individual restoration sites
- Site listing and per-user site management
- User accounts: registration, login, and logout
- Role-based access control
- Responsive UI built with Bootstrap 5
- REST-ready Django backend
---
## Stack
| Layer | Technology |
| :--- | :--- |
| Backend | Django 5.0 |
| Database | SQLite (default), PostgreSQL-compatible |
| Frontend | Bootstrap 5, HTML/CSS |
| Mapping | LeafletJS |
| Static Files | Whitenoise |
| Web Server | Gunicorn |
| Deployment | Render / Heroku (Procfile included) |
---
## Getting Started
### Prerequisites
- Python 3.10+
- Git
### Installation
```bash
git clone
cd CARBON
```
```bash
# Windows
python -m venv venv
venv\Scripts\activate
# Linux/Mac
python3 -m venv venv
source venv/bin/activate
```
```bash
pip install -r requirements.txt
```
### Database Setup
```bash
python manage.py migrate
```
### Run Locally
```bash
python manage.py runserver
```
Visit `
127.0.0.1`
---
## Deployment (Render / Heroku)
1. Push code to GitHub.
2. Connect the repository to your platform (Render or Heroku).
3. Set the following environment variables:
- `SECRET_KEY` — a secure random string
- `DEBUG` — set to `False`
4. Deploy. The included `Procfile` handles server initialization automatically.
---
## Project Structure
```
CARBON/
├── config/ # Django project settings and URL routing
├── restoration_app/ # Core application: models, vi …