Academic web application focused on community waste management, environmental awareness, and citizen participation.
Originally developed under the academic concept, this repository preserves the final delivered implementation under the name WasteManagement.
The project was created as part of a university web development course in Costa Rica and represents a completed academic prototype.
Important
The application is fully functional and available online.
🌍 Website:
https://wastemanagement.betoxprograming.com
The deployed version allows navigation through all implemented modules including reports, collections, education, ranking, user management, and interactive map features.
This repository includes demo records inside the SQL file to make the platform easier to explore after deployment.
The seeded data creates a small interactive environment including:
- Users
- Reports
- Collection requests
- Map locations
All demo users share the same password:
Demo123!
Reserved users:
ID 1 → Base / Administrator user
ID 2 → Anonymous user
Anonymous reports and anonymous collection requests are automatically assigned to the anonymous user.
Users are free to create new accounts and interact with the platform normally.
WasteManagement was created to address community waste-management challenges through a web platform that encourages environmental participation.
The project focuses on:
- Waste reporting
- Community participation
- Recycling awareness
- Educational content
- Environmental initiatives
- Waste collection requests
The original academic proposal was centered around sustainable communities and environmental education.
More detailed analysis is available here:
📄 docs/project-context.md
Note
This repository is completed and closed.
This is not an abandoned project, incomplete prototype, or unfinished implementation.
The repository reflects the intended final delivery and successfully fulfilled the academic objectives defined for the course.
Course goals included:
- Creating an interactive web application
- Using PHP with MySQL
- Building dynamic pages
- Connecting a database
- Implementing interactive modules
- Applying HTML, CSS, and JavaScript fundamentals
The following topics were outside the course scope:
- Advanced UX/UI design
- Production-ready architecture
- Full role systems and administrator flows
- Advanced authentication
- Security beyond basic password handling
- Enterprise deployment patterns
Because of this:
- No administrator role was implemented
- Security remains educational/basic
- Interface design prioritizes functionality over UX specialization
The project fulfilled the expected learning goals successfully.
Users can create reports related to environmental incidents and community waste-management situations.
Examples:
- Improper waste handling
- Collection issues
- Community observations
Collection requests can be registered directly from the application.
Examples:
- Recycling pickup
- Waste collection support
- Community activities
The project includes an environmental map showing:
- Recycling points
- Biodigesters
- Community locations
- Environmental activities
Environmental learning resources including:
- Recycling guides
- Educational material
- Sustainability information
- Videos
Participation system focused on visibility and engagement.
Users can interact with environmental activities and community participation elements.
Several features were implemented voluntarily beyond the class material.
The environmental map became one of the most expanded modules in the project.
Additional work included:
- Leaflet integration
- Environmental point visualization
- Recycling locations
- Biodigester locations
- Community activity points
- JSON-based geographic area representation
- Community boundary visualization
This implementation exceeded the classroom examples and added a stronger interactive component to the academic prototype.
Reusable modal components were incorporated for interactive content presentation.
Examples:
- Educational videos
- Environmental learning resources
- Dynamic visual interactions
The map module evolved beyond simple location markers and explored environmental visualization concepts connected to the community context.
| Category | Technology |
|---|---|
| Backend | PHP |
| Database | MySQL |
| Frontend | HTML5 |
| Styling | CSS3 |
| Client Logic | JavaScript |
| Local Server | XAMPP |
| Database Tool | phpMyAdmin |
| IDE | PhpStorm |
| Data Format | JSON |
To run locally:
- Install XAMPP
- Copy project into:
htdocs/WasteManagement
- Start:
- Apache
- MySQL
- Import database:
db_gestionresiduos
Detailed instructions:
📄 docs/setup-guide.md
| File | Description |
|---|---|
project-context.md |
Problem statement, justification, goals, context |
requirements.md |
Functional requirements and scope |
features.md |
Implemented modules |
database-notes.md |
Database structure |
data-model.md |
Relational model |
setup-guide.md |
Local installation |
Note
This project was developed academically in Costa Rica.
Some database names, fields, source-code identifiers, and UI labels remain in Spanish to preserve the original delivered implementation.
Documentation was expanded in English for repository presentation purposes.
This repository does not include a CONTRIBUTING.md.
The project is closed and finalized.
Future contributions or continuation efforts should refer to the successor project repository inspired by the original EcoVecindario concept.
The repository link will be added once available.
This project was not initially designed as a mobile-first application.
Mobile optimization was outside the scope of the academic course where the project was developed.
A future iteration may include responsive improvements and additional platform support.
The author has already developed responsive projects, including the personal portfolio project, and similar improvements may be implemented in a future repository iteration.
Note
This repository is shared for academic, educational, and learning purposes.
Commercial use is not permitted under the selected license.