MWH Minimart & Voucher System

Inspiration

The Muhammadiyah Welfare Home (MWH) provides a safe and nurturing environment for its residents. We aimed to create a system that empowers residents and streamlining administrative processes. The introduction of points, vouchers, and auctions fosters engagement, responsibility, and independence among the residents, enhancing their experience and growth.

What it does

The MWH Minimart & Voucher System includes:

Resident Dashboard: Residents can track points, view available products, and submit order requests.
Point Redemption: Residents earn points by completing tasks or activities and redeem them for products or bid in auctions.
Voucher Management: Admins can assign tasks tied to vouchers, approve or reject voucher requests, and track point issuance. Residents can also request vouchers themselves.
Admin Tools: Robust inventory management with barcode scanning, order approval workflows, and user account management.
Audit Logs and Reporting: Comprehensive tracking of all transactions and the ability to generate detailed inventory and activity reports.

How we built it

The system was built with the following tech stack:

Frontend: React (Vite) and TypeScript for building a dynamic, type-safe, and user-friendly interface; shadcn and TailwindCSS for consistent and modern UI components with fast customization.
Backend: FastAPI for high-performance API endpoints with asynchronous support, SQLAlchemy for database ORM to manage relationships and queries efficiently, Alembic for database migrations, ensuring smooth schema updates.
Database: PostgreSQL for reliable and scalable relational data storage.
Integration: REST API endpoints to connect the frontend and backend seamlessly.
Deployment: Deployed on DigitalOcean