A campus freelance marketplace connecting university clients with student freelancers, built for CSE322 Software Engineering (Alexandria University).
unigig/
├── .github/workflows/ # Independent CI pipelines (backend-ci.yml & frontend-ci.yml)
├── unigig-backend/ # Java 25 / Spring Boot 4.1 REST API
├── unigig-frontend/ # Angular SPA + Tailwind CSS (Node 22)
├── docker-compose.yml # Local PostgreSQL 17 database container
└── README.md
- Branches:
devis the active integration branch;mainholds tested milestone releases. - Feature Branches: Always branch off
devusing the Jira ticket key:feat/UG-<id>-short-descriptionfix/UG-<id>-short-description
- Pull Requests: Target
devand includeUG-<id>in the PR title to link Jira automatically. BothBackend CIandFrontend CImust pass before merging.
- Docker Desktop (runs PostgreSQL without native DB setup)
- JDK 25 (Temurin / Oracle)
- Node.js 22 LTS & Angular CLI (
npm install -g @angular/cli)
From the repository root:
docker compose up -d(Starts unigig-postgres on localhost:5432 — database unigig, user/password postgres.)
Ensure unigig-backend/src/main/resources/application.properties points to localhost:5432/unigig with spring.flyway.enabled=true and spring.jpa.hibernate.ddl-auto=validate, then run:
cd unigig-backend
./mvnw spring-boot:run- API Base URL:
http://localhost:8080 - Swagger UI:
http://localhost:8080/swagger-ui.html - Tests / JAR Build:
./mvnw test|./mvnw clean package
cd unigig-frontend
npm install
ng serve- App URL:
http://localhost:4200 - Production Build:
npx ng build --configuration production
| Package | Responsibility |
|---|---|
controller/ |
REST endpoints & @Valid request handling |
dto/ |
Immutable Java record request/response contracts |
service/ |
Business rules, role switching, and @Transactional boundaries |
repository/ |
Spring Data JPA interfaces |
model/ |
JPA @Entity classes & enums mapped to Flyway SQL migrations |
config/ |
Stateless JWT security filter chain, BCrypt encoder, and CORS |
exception/ |
@RestControllerAdvice mapping errors to consistent JSON |
| Folder | Responsibility |
|---|---|
core/ |
Singleton services (AuthService), JWT HttpInterceptorFn, route guards, and TypeScript interfaces |
features/ |
Page views (auth, home, marketplace, dashboard, profile) |
shared/ |
Reusable UI components (navbar, cards, modals) |
- Frontend: Static Angular SPA hosted on GitHub Pages from
main. - Backend & DB: Containerized locally via Docker and exposed over HTTPS using a Cloudflare Tunnel URL configured in
unigig-frontend/src/environments/environment.prod.ts.