Skip to content

CarloMilos/tresa-urban-project

Repository files navigation

🌿 TRESA Urban Nature Reserve Map system

A comprehensive web system and interactive urban mapping solution developed for TRESA (Totterdown Residents Environmental & Social Action) to manage and visualize urban green spaces and nature reserves.

Live map here
image

🖼️ Poster

TRESA POSTER

🎯 Project Overview

This project delivers a tailored mapping and data collection system for TRESA, enabling the organization to:

  • Track and visualize urban green spaces in Totterdown
  • Collect and manage data about private and public nature reserves
  • Engage community members in environmental initiatives
  • Monitor and analyze the distribution of green spaces

🚀 Key Features

  • Interactive Mapping: Custom Google Maps integration showing public and private green spaces
  • Data Collection: User-friendly forms for residents to submit their green space information
  • Admin Dashboard: Comprehensive management system for data verification and analysis
  • Analytics: Visual representation of green space distribution and statistics
  • Privacy Controls: Options for anonymous submissions and data protection
  • Feedback System: Built-in mechanism for user feedback and improvements

🛠️ Technical Stack

  • Frontend: JavaScript, Vue.js, HTML5, CSS3
  • Backend: PHP 8.1.2
  • Database: MySQL (MariaDB 10.4.22)
  • Maps Integration: Google Maps API
  • Visualization: Chart.js
  • Styling: Bootstrap 5
  • Version Control: Git

📋 Project Structure

tresa-urban-project/
├── admin/                 # Admin dashboard components
├── src/                   # Core application source code
├── formimages/           # User-submitted images storage
├── SRS, PID, Docs/       # Project documentation
└── tresadb.sql          # Database schema and initial data

💻 Installation

  1. Clone the repository:
git clone https://github.com/yourusername/tresa-urban-project.git
  1. Configure your web server (Apache/Nginx) to serve the project directory

  2. Set up the database:

mysql -u root -p < tresadb.sql
  1. Configure the database connection in src/config.php:
$host = 'localhost';
$dbname = 'tresadb';
$username = 'your_username';
$password = 'your_password';
  1. Install dependencies:
composer install

🔧 Configuration

Required Environment Variables:

  • Database credentials
  • Google Maps API key
  • File upload paths

Google Maps API Setup:

  1. Obtain an API key from Google Cloud Console
  2. Enable Maps JavaScript API
  3. Add the key to src/config.php

📱 Features

For Users

  • Submit private green space information
  • View interactive map of all green spaces
  • Provide feedback
  • Access analytics and statistics

For Administrators

  • Verify and manage submissions
  • View detailed user data
  • Access feedback responses
  • Generate reports and analytics

🤝 Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Contact

For questions or support, please contact:

🙏 Acknowledgments

  • TRESA organization for their collaboration and support
  • Totterdown community members for their participation
  • Google Maps Platform for mapping capabilities
  • All contributors who have helped shape this project

Client Sign-off and Feedback:

TRESA Sign-OFF

⭐️ If you find this project useful, please consider giving it a star!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •