Lost Item Portal

A full-stack lost-item reporting portal with:

• Frontend: React + TypeScript + Vite + MUI
• Backend: Spring Boot (Java 21) + JPA
• Database: PostgreSQL
• Orchestration: Docker Compose

Features

• View all lost item reports
• Create a new report
• Edit an existing report
• Delete a report

Project structure

lost_item_portal/
├── backend/        # Spring Boot REST API
├── frontend/       # React app
├── docker-compose.yml
├── .env.example
└── README.md

Environment variables

Copy .env.example to .env and adjust values as needed:

DB_USER=postgres
DB_PASS=your_password_here
DB_NAME=lost_items
DB_PORT=5432
VITE_API_URL=http://localhost:8080/api
APP_CORS_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000

If port 5432 is already used on your machine, set DB_PORT to another port (for example 5433).

Run with Docker Compose (recommended)

docker compose up --build -d

Access:

• Frontend: http://localhost:3000
• Backend API: http://localhost:8080/api/lost-items
• PostgreSQL: localhost:${DB_PORT}

Stop:

docker compose down

Run locally (without Docker)

Backend

cd backend
sh ./mvnw spring-boot:run

Frontend

cd frontend
npm install
npm run dev

Quality checks

Frontend

cd frontend
npm run lint
npm run build

Backend tests (Java 21 required)

cd backend
sh ./mvnw test