BarangayChain

Problem Statement

BarangayChain: Transparency Community Governance on the BlockchainBarangayChain is a blockchain-based platform that transform barangay governance in the Philippines through transparency, accountability, and citizen participation. In the Philippines, barangays often face certain issues such as ghost projects, inflated receipts, and delayed audits that still manifest and even became a norm. BarangayChain addresses these issues by developing decentralized technology that provides a transformative solution for managing community projects, budgets, and decision-making processes. This platform does not only allow barangay officials to manage projects but also create projects with complete transparency, while citizens can actively participate through voting on initiatives and monitoring budget allocation in real-time.Key Features:Project Management: Allows to track community projects from proposal to completion with a progress monitoringBudget Transparency: View detailed budget schedules, fund releases, and even expenditure tracking on a blockchain ledgerCitizen Voting: Exercise your right to vote through secure, verifiable voting on barangay projects and initiativesContractor Management: Transparent in selecting contractor and payment trackingAudit Trail: Complete and clean records of all transactions and decisionsProject Lifecycle:Project Creation Officials create projects with defined milestones and budgets. The treasury validates budget availability and the project becomes visible to whitelisted vendors.Milestone Submission Vendors complete work and submit milestones with supporting documentation (photos, reports) uploaded to IPFS. The milestone enters "Pending Verification" state for citizen voting.Voting & Verification Citizens review the submitted documentation and vote to approve or reject the milestone. A minimum of 5 citizen votes is required for quorum. Each citizen can vote once per milestone.Completion & Fund Release After sufficient verification votes, officials finalize the milestone. The treasury automatically releases PYUSD payment to the vendor, and the milestone is marked as completed. Fund Flow: Treasury → Project Escrow → Vendor PaymentKey States: Projects: Active → In Progress → Completed Milestones: Pending → Submitted → Under Review → CompletedConclusion: By using blockchain technology, BarangayChain minimizes corruption risks, ensures proper utilization if fund and empowers Filipino citizens to fully trust local government operations. It transforms Philippine governance into a trustworthy, transparent, and community-driven in this digital age.

Solution

BarangayChain is designed with a secure yet simple blockchain setup that keeps every project, vote, and fund transparent.Smart Contract Layer:BarangayChain.sol – the core protocol that handles project management, budget releases, and citizen votingCitizenNFT.sol – serves as each citizen’s digital ID, ensuring verified participationTreasury.sol – manages fund allocation and budget releases with built-in transparencyBarangayAccessManager.sol – handles role-based permissions for Admins, Officials, Contractors, and CitizensDeveloped using Solidity with OpenZeppelin libraries for security and access controlBuilt, tested, and deployed through Hardhat, with full verification and extensive test coverage for reliabilityFrontend Application:Powered by Next.js and React for a fast, modern web experienceTypeScript ensures clean and consistent codeWagmi and Viem make blockchain interaction smooth and reliableMaterial UI (MUI) provides a polished, consistent designTanStack Query ensures quick and efficient data fetchingArchitecture:Structured as a monorepo using pnpm workspaces to organize contracts and app packagesMaintains a transparent audit trail, recording every project update, vote, and transaction directly on-chainUses Blockscout to monitor transaction status and send real-time notificationsEmploys an automated treasury system using PYUSD as the stable treasury token for secure and predictable fund managementEnforces role-based access control at the smart contract level, ensuring accountability at every stepTogether, these components create a tamper-proof, transparent, and citizen-friendly governance system that makes community management simple and trustworthy.