Project Proposal - Mushroom Guardians - Example
Project Proposal - Mushroom Guardians - Example
ICS 2309 - Commercial Programming & BCT 2315 - Computer Systems Project
Team Members and Admin Numbers | April 2025
1. Project Title
Mushroom Guardians – A Smart, FIWARE-Powered Platform for Intelligent Mushroom
Farming
Farming remains the bedrock of many rural livelihoods in Kenya. Among various agricultural
ventures, mushroom farming offers a high-value opportunity for youth and women in semi-
urban and rural areas. However, its delicate nature demands consistent and precise monitoring
of environmental conditions such as temperature, humidity, and carbon dioxide levels.
Unfortunately, most mushroom growers rely on manual observation, which is error-prone,
time-consuming, and insufficient in offering predictive insights. Crop failure rates are
consequently high, and the learning curve for new entrants is steep.
Mushroom Guardians emerges as a solution to bridge this critical gap. Built on the powerful
FIWARE open-source platform, this system leverages Internet of Things (IoT) sensors,
context-aware data analytics, and cloud technologies to deliver a real-time monitoring and farm
management experience. The system does not merely offer data—it provides actionable
intelligence. With instant alerts, trend visualization, and adaptive feedback, Mushroom
Guardians transforms traditional farming into smart farming. This project is not only
technically stimulating but socially transformative, targeting SDGs such as Zero Hunger,
Decent Work, and Innovation.
3. Team Members and Roles
The team meets bi-weekly for sprint planning and retrospectives, and daily check-ins are
conducted on Slack. Project progress is tracked using Trello boards and GitHub issues.
5. Project Objectives
This project aligns with the course's objectives to build deployable, commercial-grade software
and includes the following goals:
• Design and build a smart farm management system tailored for mushroom production.
• Integrate real-time environmental data collection via FIWARE’s Orion Context Broker
and IoT Agents.
• Store and analyze time-series data using QuantumLeap and TimescaleDB.
• Implement secure user management with role-based access controls.
• Deploy the application on cloud infrastructure using DevOps practices such as GitHub
Actions and Docker.
• Produce detailed documentation, from architecture to user manuals, and publish a
research paper analyzing the impact and technical implementation.
• Validate the system through real-world piloting and feedback collection from active
mushroom farms.
• Propose and explore monetization strategies for commercial sustainability.
6. Functional Overview
The application comprises multiple functional modules, each designed with both the farmer
and system administrator in mind. At its core is the monitoring dashboard—a clean, responsive
interface that visualizes real-time sensor data. This includes temperature, humidity, and CO₂
levels collected via connected sensors. Alerts are generated when any parameter crosses a
critical threshold. These alerts are not limited to on-screen notifications but can also be sent via
SMS or WhatsApp for offline or low-connectivity areas.
Administrators can add new farms, configure sensor thresholds, and manage user roles. For
research and long-term farm planning, the platform also stores historical data. Through
interactive charts and downloadable reports, farmers can analyze trends, identify productivity
bottlenecks, and make informed decisions. All modules are protected by JWT-based
authentication, and the design follows MVC principles for maintainability.
7. Technical Methodology
We adopt Agile as our primary software development methodology. Work is broken down into
six sprints, each delivering a tangible output. CI/CD pipelines using GitHub Actions ensure
that every commit is tested and deployed seamlessly. Docker containers ensure consistent
environments across development, staging, and production. Our backend is built on Node.js
and Express for its lightweight, asynchronous architecture, while PostgreSQL and
TimescaleDB are used for relational and time-series data, respectively.
The frontend is developed using React.js with TailwindCSS for styling. We use Figma for
prototyping and gathering user feedback before implementation. Data from sensors is pushed
via FIWARE IoT Agents into Orion Context Broker, which maintains a digital twin of each
farm environment. QuantumLeap exports this data to TimescaleDB for historical analysis. The
entire system is deployed on Heroku during development, with plans to move to AWS upon
scaling.
Digital marketing efforts will include social media campaigns, YouTube tutorials in local
languages, and farmer workshops. We also plan to partner with agricultural extension officers
and host demo days in partnership with county governments.
9. Resource Requirements
The initial phase of the project requires both human and technical resources. Team members
contribute time and expertise, while hardware and cloud services require funding.
Raspberry Pi Kits Sensor kits with CO₂, temp & humidity 30,000
Total 45,000
Project risks are proactively addressed in planning. Key risks include hardware malfunction,
software integration challenges, and external delays such as internet outages or shipment
delays. We mitigate hardware issues by performing rigorous lab testing before field
deployment. Software modules are built and tested in isolation before being integrated,
ensuring that bugs are caught early. We’ve adopted a strict MVP definition to avoid scope
creep and maintain focus on core features.
Security is another critical area. We are embedding secure coding practices from day one—
sanitizing inputs, hashing passwords with bcrypt, and enforcing HTTPS-only traffic. A
penetration test will be conducted during Sprint 5.
Each sprint is time-boxed to two weeks, and every sprint ends with a deliverable that
contributes to the final product.
The source code will be released under the MIT License, allowing open community use and
adaptation. Commercial rights will be managed through JHUB Africa. We plan to document
our work extensively on GitHub and may create a developer handbook to support open
contributions.
14. References