This repository was archived by the owner on Jan 28, 2026. It is now read-only.
Technical Overview
-
Project Name:
Itestra Event Exchange Platform -
Purpose:
Build a modern, smart event platform that enhances internal networking and collaboration at itestra by intelligently matching participants across roles, departments, and locations.
-
Stakeholders:
- It. Event Manager – defines event structure, constraints, and seating goals
- It. Engineers – implement, maintain, and improve the platform
- It. Employees in P&O – register and participate in events (users of the platform)
-
Why This Stack:
The architecture leverages modern, community-backed tools with strong internal familiarity:
- ⚛️ React + Tailwind + Ant Design for a fast, accessible, and consistent UI
- ☕ Spring Boot + PostgreSQL for a robust backend and scalable data model
- 🐳 Docker + GitHub Actions for streamlined local dev and automated CI/CD
- 🧠 Smart matching logic based on business constraints (implemented server-side)
-
This Wiki Covers:
- System architecture and how components interact
- Frontend, backend, and database stacks
- Local development setup and workflows
- CI/CD pipelines and deployment approach
- Data modeling principles and authentication setup
✅ This documentation is intended for developers, stakeholders, and collaborators contributing to the platform.
| Component | Type | Role | Interacts With | Communication |
|---|---|---|---|---|
| React App | Frontend | Client-side UI rendered in browser | Spring Boot API (via Docker network) | HTTP (API Requests/Responses) |
| Spring Boot | Backend | Handles business logic, routes, and API endpoints | React (API calls), PostgreSQL (DB queries) | HTTP (REST) + JDBC (Hibernate) |
| PostgreSQL | Database | Stores persistent application data | Spring Boot backend | SQL (via JDBC/Hibernate) |
| Docker Compose | Container Orchestration | Launches and connects React, Spring Boot, and PostgreSQL containers | All containers within docker-compose.yml | Internal Docker networking |
| GitHub Actions | CI/CD Pipeline | Builds and pushes Docker images, triggers deployment | Docker Hub (or registry), triggers Docker Compose execution | GitHub API, Docker CLI |
| Docker Hub / Registry | Container Registry | Stores built images for backend/frontend services | GitHub Actions (push), Docker Compose (pull if remote) | Docker image transfer |
| User (Itestra) | External Client | Accesses the frontend via HTTPS | React frontend via browser | HTTPS |
✅ Focus is on simplicity, team alignment, fast onboarding, and scalable practices.