https://github.com/c-elkins/it-asset-management
IT asset management app (Spring Boot + React). Dockerized, CI, health checks, and E2E tests.
https://github.com/c-elkins/it-asset-management
docker github-actions itam react spring-boot vite
Last synced: 9 months ago
JSON representation
IT asset management app (Spring Boot + React). Dockerized, CI, health checks, and E2E tests.
- Host: GitHub
- URL: https://github.com/c-elkins/it-asset-management
- Owner: C-Elkins
- Created: 2025-09-24T01:20:23.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-24T03:16:03.000Z (9 months ago)
- Last Synced: 2025-09-24T03:28:10.484Z (9 months ago)
- Topics: docker, github-actions, itam, react, spring-boot, vite
- Language: Java
- Size: 281 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# IT Asset Management System
Production-ready IT asset management app with a Spring Boot backend and a
Vite + React frontend.
## Features
- Asset inventory, categories, maintenance records
- Auth flow with protected routes and inline errors
- Robust error boundaries and guarded UI state
- Stable JSON API with pagination-ready services
- Dockerized stack (Postgres, backend, frontend) with health checks
- CI for backend (Maven) and frontend (Node) + E2E smoke test (Playwright)
## Project structure
- `backend/` — Spring Boot (Java 17+, Maven) REST API
- `frontend/` — React 19 (Vite) SPA served by nginx in prod
- `docker-compose.yml` — Compose stack for DB + API + Web
## Quick start
1. Backend (dev)
- Requirements: Java 17+, Maven 3.9+
- Build and run:
```bash
mvn spring-boot:run
```
2. Frontend (dev)
- Requirements: Node.js 20+
- Install and start:
```bash
npm install
npm run dev
```
3. Docker (prod-like)
Build and run all services:
```bash
docker compose up -d --build
```
Services:
- Frontend: (nginx serving Vite build)
- Backend: internal on 8080 in the Compose network
- Postgres: localhost:5432 (user/pass: iam/iam)
Health:
- Frontend:
- Backend: (inside network)
## Environment
- Frontend dev proxy: `VITE_API_BASE=/api` (see `frontend/.env.development`)
- Nginx runtime env: `BACKEND_ORIGIN` (defaults to `http://backend:8080`)
## E2E smoke tests (Playwright)
Run locally:
```bash
cd frontend
npm run build && npm run test:e2e
npm run test:e2e:report # optional
```
## Dev modes
- Local dev (hot reload):
- Backend: `./mvnw spring-boot:run` in `backend`
- Frontend: `npm run dev` in `frontend` →
- API proxied via Vite `/api` →
- Containerized dev:
- `docker compose up -d --build`
- Frontend →
- Backend (Compose network) → `http://backend:8080`
- Nginx proxy uses BACKEND_ORIGIN env (default `http://backend:8080`)
## VS Code tasks
Tasks are available under Terminal → Run Task:
- dev:start backend — starts Spring Boot (scripted)
- dev:start frontend — starts Vite dev server
- dev:start all — runs both in parallel
## CI
CI builds:
- Backend: Maven on Temurin 21
- Frontend: Node 20 build + Playwright smoke tests
- Triggers: push and PR to main
## Contributing and Security
- See [CONTRIBUTING.md](./CONTRIBUTING.md)
- See [SECURITY.md](./SECURITY.md)