NEXUS SDLC Agentic Framework

A complete hackathon-ready full-stack application that carries a feature requirement through a deterministic, traceable SDLC workflow.

Architecture

• Frontend: React, Vite, Material UI, React Router, Recharts, Axios
• Backend: Spring Boot 3, Java 17, Maven, Spring Data JPA, H2
• Ports: frontend 5173, backend 8082 (8080 is reserved by Jenkins and 8081 by Oracle)
• Storage: file-backed H2 database under backend/data

Prerequisites

• Node.js 20 or newer
• Java 17 or newer

Maven does not need to be installed globally because the backend includes Maven Wrapper scripts.

Run locally

Open two terminals from the project root.

Backend

cd backend
.\mvnw.cmd spring-boot:run

Frontend

npm install
npm run dev

Open http://localhost:5173. The H2 console is available at http://localhost:8082/h2-console using:

• JDBC URL: jdbc:h2:file:./data/nexus-sdlc
• User: sa
• Password: blank

End-to-end demo

1. Open Requirement Intake to create or edit the active requirement.
2. Open Workflow Simulator.
3. Select Run End-to-End Agent Flow.
4. The frontend sequentially invokes Requirement → BRD → Stories → Sprint → Code → Review → Testing → QA → Knowledge Graph.
5. Open each lifecycle page to inspect the persisted artifact.

The generated content is deterministic mock business logic designed for a self-contained hackathon demo. No external LLM keys are required.

REST APIs

Method	Endpoint	Purpose
POST	/api/requirements	Create and normalize a requirement
GET	/api/requirements	List requirements
GET/PUT	/api/requirements/{id}	Read or update a requirement
POST	/api/brd/generate	Generate and save a BRD
GET	/api/brd/{id}	Read a BRD
POST	/api/backlog/generate	Generate epics, stories, criteria, and estimates
POST	/api/sprint/create	Create a sprint plan
POST	/api/code/generate	Create a code plan and implementation stub
POST	/api/review/run	Run quality and security review
POST	/api/testing/run	Run deterministic test validation
POST	/api/qa/generate	Generate QA handoff and release notes
GET	/api/knowledge-graph/{requirementId}	Read traceability graph

Agent POST bodies use:

{ "requirementId": 1 }

Verification

cd backend
.\mvnw.cmd test

cd ..
npm run lint
npm run build