Software Engineering Quizzes (swe-quizzes)

A full-stack quiz platform covering any topics. Built with Spring Boot (backend) and Angular (frontend), deployed as separated services on AWS (emulated locally by Floci).

Stack

• Backend: Spring Boot 3, Spring Data JPA, Flyway, PostgreSQL
• Frontend: Angular 21
• Deployment: Terraform → AWS via Floci (S3 + ECS/Fargate + ALB + RDS)

Prerequisites

• Java 21
• Node 20+ / npm
• Docker

---

Running locally

1. Start PostgreSQL

docker compose up -d

2. Run the backend

cd backend
./mvn spring-boot:run

API available at http://localhost:8080/api/quizzes

3. Run the frontend (dev server with API proxy)

cd frontend
npm install
npm start

App available at http://localhost:4200. All /api requests are proxied to the backend — no CORS setup needed in development.

---

Running tests

Backend

cd backend
./mvn test

Backend — generate coverage report (JaCoCo)

cd backend
./mvn verify

Report is generated at backend/target/site/jacoco/index.html.

Frontend

cd frontend
npm test

---

Building for production

docker build -t swe-quizzes .
docker run -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://<host>:5432/swequizzes \
  -e SPRING_DATASOURCE_USERNAME=<user> \
  -e SPRING_DATASOURCE_PASSWORD=<password> \
  swe-quizzes

Deploy to AWS (via Floci)

The frontend and backend are deployed separately to AWS, emulated locally by Floci. See FLOCI-README.md for the full deploy and rebuild guide. In short:

docker compose -f floci-compose.yml up -d   # start the emulated AWS
./deploy-floci.sh                           # provision + build + deploy everything

---

Database migrations

Flyway runs automatically on startup. Migration files live in backend/src/main/resources/db/migration/:

File	Description
V1__create_tables.sql	Creates quiz, question, answer tables
V2__seed_data.sql	Seeds 3 quizzes with questions and answers

---

API

Method	Endpoint	Description
GET	/api/quizzes	List all quizzes
GET	/api/quizzes/{id}	Get a quiz with questions and answers