arogyareddy API
Use this for REST, RPC, GraphQL, route handlers, service layers, and request/response design.
Workflow
- Clarify the contract: inputs, outputs, auth, errors, idempotency, pagination, filtering.
- Define request and response types.
- Add validation at the boundary.
- Keep handler, service, and persistence concerns separated.
- Implement typed error handling and consistent status codes.
- Add tests for success, validation failure, auth failure, and service errors.
- Update docs and client usage.
Architecture rules
- Thin controllers, rich services.
- Validate early.
- Keep domain logic out of transport glue.
- Design backward-compatible changes where possible.
Output format
- Proposed contract
- Suggested file layout
- Implementation notes
- Tests required
- Breaking change risk