flow-pie/chamaa.api

Create Contributions Endpoint

Open

#18 opened on Nov 1, 2025

View on GitHub
 (1 comment) (0 reactions) (0 assignees)HTML (4 forks)auto 404
good first issuehelp wanted

Repository metrics

Stars
 (3 stars)
PR merge metrics
 (PR metrics pending)

Description

Develop a POST /api/v1/contributions endpoint for recording member contributions. Requirements:

Request body:

{ "member_id": "uuid", "amount": "number", "date": "ISO8601 string" }

Validate that member_id exists

Auto-generate contribution reference (e.g. CHM-2025-0001)

Return created contribution details

Add authentication middleware

Contributor guide

Research direction
Implement a POST endpoint to create contributions. Validate member id exists in the database, auto generate a reference (e.g., CHM 2025-0001) using a sequence, and return the created resource. Ensure authentication middleware is applied.
Tech stack
None
Domain
backendapi
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitREST APIAuthentication middleware
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60