[C4GT Community]: Beneficiary Manager for ONEST #3
Description
Ticket Contents
Description
Organizations like Haqdarshak and Physics Wallah want to participate in financial support or scheme trials, but lack the bandwidth to engage deeply with protocol nuances.
Beneficiary Manager proposes a simple adapter that exposes a minimal set of REST APIs for beneficiary-side interactions with the ONEST financial support protocol. This makes integration seamless and trial-ready with minimal development effort.
Key functionalities:
-
GetSchemes: Fetch available schemes from the network, with or without search filters.
-
SubmitApplications: Submit user applications along with relevant credentials.
-
GetStatus: Retrieve the current status of schemes and submitted applications.
With only ~10 lines of code, organizations can integrate and begin submitting applications on behalf of beneficiaries.
📘 Reference links:
Expected Timeline: 2–3 weeks
Goals
Goals
-
Design API contracts for GetSchemes, SubmitApplications, and GetStatus
-
Build a stateless Go-based microservice with REST APIs
-
Integrate a lightweight in-service database
-
Dockerize the microservice for easy deployment
-
Provide sample usage code for integration with ~10 LoC
Setup Guide: Will be linked once MVP is implemented.
Expected Outcome from Contributor
A ready-to-use Go-based adapter exposing REST APIs for:
-
Fetching schemes from the network
-
Submitting applications with attached credentials
-
Tracking application and scheme status
The service should be stateless, dockerized, and lightweight, enabling quick integration for partner organizations without deep protocol knowledge.
Expected Outcome from Mentor
NA
Acceptance Criteria
Acceptance Criteria
✅ REST APIs function correctly with and without query parameters
✅ Applications submitted with credentials are properly encoded and pushed
✅ Responses follow protocol specs and gracefully handle errors
✅ Microservice runs in a Docker container and is easy to deploy
✅ Sample client demonstrates integration in under 10 lines of code
Implementation Details
Language: Go
Microservice Architecture: Stateless with REST endpoints
Database: Lightweight DB (PostgreSQL preferred) for caching/querying
Deployment: Docker-based
Security: Headerless (for now), with basic input validation
Protocol Integration: Built per ONEST financial support protocol
Design Focus: Lightweight, clean API surface, trial-ready
Mockups/Wireframes
NA- focus is on backend service with clearly documented API contracts to follow.
Product Name
Beneficiary Manager
Organisation Name
ONEST
Domain
Finance
Tech Skills Needed
Go
Mentorship Status
Mentor Required
Mentor(s)
Complexity
High
Contribution Type
Code contribution
Issue Type
Bounty ticket
Monetary Incentive
INR 10k