Missing Error Response Schema

[fenar]

Severity: Medium
Affected Services: All

Problem:
No standard error response format defined across services.

Resolution:
Define standard error schema:

{
  "error": {
    "code": "INVALID_BID_AMOUNT",
    "message": "Bid amount exceeds work budget",
    "details": {
      "bid_amount": 1.50,
      "max_budget": 1.00
    },
    "request_id": "req_abc123",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

[parlakisik]

Status: In progress (deferred for incremental migration)

193 http.Error() calls across 14 files need to be migrated to a standard JSON error response format:

{
  "error": {
    "code": "INVALID_BID_AMOUNT",
    "message": "Bid amount exceeds work budget",
    "details": { "bid_amount": 1.50, "max_budget": 1.00 },
    "request_id": "req_abc123",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Planned approach: create shared respondError() helper, migrate service-by-service.

Branch: feat/aca

[parlakisik]

Implemented in feat/aca branch (commit d8ad824).

All 193 http.Error() plain-text responses replaced with structured JSON across all 13 services:

{
  "error": {
    "code": "INVALID_BID_AMOUNT",
    "message": "Bid amount exceeds work budget",
    "timestamp": "2026-04-06T12:00:00Z"
  }
}

Error codes use UPPER_SNAKE_CASE: BAD_REQUEST, UNAUTHORIZED, NOT_FOUND, METHOD_NOT_ALLOWED, CONFLICT, GONE, INTERNAL_ERROR, BAD_GATEWAY, plus service-specific codes (WORK_ID_REQUIRED, BID_EXPIRED, CONTRACT_EXPIRED, etc.)

17 files changed, +365/-232 lines. All tests passing.