Spec-driven FastAPI backend with pytest API tests and codegen-assisted developmentResource management api

[jeevan-puli]

Summary

This PR implements a backend-only FastAPI application following a spec-driven development approach, along with a comprehensive pytest-based API test suite.

The primary focus is on testability, determinism, and clear API contracts rather than feature complexity.

---

Approach

• Defined the feature behavior up front using a written spec
  (SPECS/resource-management-api.md)
• Implemented a minimal FastAPI backend strictly aligned with the spec
• Built a pytest-based API test harness covering:
  • Happy paths
  • Negative and validation scenarios
  • Edge cases (empty state)
• Ensured deterministic tests by isolating in-memory state
• Added lightweight logging to tests to improve diagnosability during local and CI runs

---

Testing Strategy

• API-level tests using fastapi.testclient.TestClient
• Spec-driven tests mapped directly to acceptance criteria
• Negative tests for invalid and malformed input
• Contract validation to ensure response schema stability
• Deterministic execution by clearing shared state between tests

---

Code Generation Usage

Modern code generation tools (ChatGPT / Codex-style models) were used to accelerate:

• Initial API scaffolding
• Pytest test case generation

All generated code was manually reviewed, refined, and extended to ensure correctness, determinism, and meaningful coverage of edge cases.