https://github.com/makomweb/fullstack-symfony-react
Track game results with this cloud native app. ⚽️ It features Helm and LGTM stack for a full Kubernetes experience.
https://github.com/makomweb/fullstack-symfony-react
clean-architecture cleancode cloud-native docker docker-compose full-stack grafana helm hexagonal-architecture kubernetes mysql opentelemetry php react symfony typescript
Last synced: 3 months ago
JSON representation
Track game results with this cloud native app. ⚽️ It features Helm and LGTM stack for a full Kubernetes experience.
- Host: GitHub
- URL: https://github.com/makomweb/fullstack-symfony-react
- Owner: makomweb
- License: mit
- Created: 2026-03-09T11:32:49.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-04-05T18:09:26.000Z (3 months ago)
- Last Synced: 2026-04-05T20:19:14.287Z (3 months ago)
- Topics: clean-architecture, cleancode, cloud-native, docker, docker-compose, full-stack, grafana, helm, hexagonal-architecture, kubernetes, mysql, opentelemetry, php, react, symfony, typescript
- Language: PHP
- Homepage:
- Size: 343 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Fullstack Demo: React 19 + Symfony 8 + MySQL 8
[](https://codecov.io/github/makomweb/fullstack-symfony-react)
## Purpose
A modern, full-stack, cloud-native game results tracker built on [Event Sourcing](https://martinfowler.com/eaaDev/EventSourcing.html) and [DDD principles](https://www.domainlanguage.com/ddd/).\
Track and analyze game results using an immutable event log with comprehensive
monitoring and observability.
### Tech Stack
| Layer | Technology |
|-------|-----------|
| Frontend | React 19 + MUI |
| Backend | PHP 8.4 + Symfony 8 |
| Database | MySQL 8 |
| DevOps | Docker, Kubernetes, Helm, Open Telemetry, Grafana |
### Architecture Highlights
- **Event Sourcing** – All state changes stored as immutable events
- **Domain-Driven Design (DDD)** – Organized into generic, core, and supporting domains (enforced by [deptrac](https://github.com/deptrac/deptrac))
- **Full Test Coverage** – Easy to achieve high coverage on the core domain
- **Observable** – Built-in OpenTelemetry instrumentation with Grafana dashboard
- **Cloud-Ready** – Deployable to Kubernetes with included Helm charts
## System Architecture
```
┌─────────────────────────────────────────────────────────────────────────┐
│ Client Layer │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ React UI │ │ Classic UI │ │
│ │ (Modern) │ │ (Legacy) │ │
│ │ Port 8090 │ │ Port 8080 │ │
│ └────────┬─────────┘ └────────┬─────────┘ │
│ │ │ │
└───────────┼──────────────────────────────────┼──────────────────────────┘
│ │
└──────────────────┬───────────────┘
│
┌──────────────────────────────▼───────────────────────────────────────────┐
│ API Gateway Layer │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────┐ │
│ │ Nginx (Reverse Proxy) │ │
│ │ Port 8080 │ │
│ └─────────────────────────────────────┘ │
│ │ │
└───────────────────────────────┼──────────────────────────────────────────┘
│
┌───────────────────────────────▼──────────────────────────────────────────┐
│ Backend Application Layer │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ PHP 8.4 + Symfony 8 Application │ │
│ │ - REST API Endpoints │ │
│ │ - Business Logic │ │
│ │ - Event Sourcing │ │
│ └────────┬──────────────────┬─────────────┬──────────────────┘ │
│ │ │ │ │
└───────────┼──────────────────┼─────────────┼─────────────────────────────┘
│ │ │
┌───────▼──────┐ ┌──────▼────────┐ ┌─▼──────────────┐
│ │ │ │ │ │
│ Database │ │ Redis Cache │ │ Message Queue │
│ MySQL 8 │ │ │ │ (Messenger) │
│ Port 3306 │ │ Port 6379 │ │ - Async Tasks │
│ │ │ │ │ - Background │
│ Events & │ │ - Sessions │ │ Jobs │
│ Data │ │ - Cache │ │ │
└──────────────┘ └───────────────┘ └────────────────┘
│
┌────────▼──────────┐
│ Background Worker │
│ (Messenger) │
│ - Process Events │
│ - Async Tasks │
└───────────────────┘
┌──────────────────────────────────────────────────────────────────────────┐
│ Observability Layer (LGTM Stack) │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────┐ ┌─────────┐ ┌─────────────┐ ┌─────────┐ │
│ │ Logs │ │ Traces │ │ Metrics │ │Grafana │ │
│ │ (Loki) │ │ (Tempo) │ │ (Prometheus)│ │Dashboard│ │
│ │ Port 3100 │ │ 3200 │ │ 9090 │ │3000 │ │
│ └────────────┘ └─────────┘ └─────────────┘ └─────────┘ │
│ ▲ ▲ ▲ │
│ └─────────────┴─────────────┘ │
│ OpenTelemetry Collector (Port 4317/4318) │
│ │
└──────────────────────────────────────────────────────────────────────────┘
```
## Prerequisites
- [Make](https://www.gnu.org/software/make/)
- [Docker](https://www.docker.com/)
- [Docker Compose](https://docs.docker.com/compose/)
- (Optional) [Kubernetes](https://kubernetes.io/)
See the [features](FEATURES.md) page for a complete list.
## Getting Started
**Quick Start (5 minutes):**
```sh
make dev # Build development images
make init # Setup DB, schema & fixtures
make up # Start all services
make open # Open dashboard in browser
```
**What's running?**
- Backend API at [http://localhost:8080](http://localhost:8080)
- React UI at [http://localhost:8090](http://localhost:8090)
- Monitoring at [http://localhost:3000](http://localhost:3000)
**Stop everything:**
```sh
make down
```
**For all available commands**, run `make help` or see the [Makefile](./Makefile).
## Services & Access Points
**Frontend**
| Service | URL | Credentials |
|---------|-----|-------------|
| Classic UI | [http://localhost:8080](http://localhost:8080) | — |
| React UI | [http://localhost:8090](http://localhost:8090) | — |
**Backend & API**
| Service | URL | Credentials |
|---------|-----|-------------|
| API | [http://localhost:8080/api/games](http://localhost:8080/api/games) | — |
| API Docs | [http://localhost:8080/api/doc](http://localhost:8080/api/doc) | — |
| Admin UI | [http://localhost:8080/admin](http://localhost:8080/admin) | admin@example.com:secret |
**Monitoring & Observability**
| Service | URL | Credentials |
|---------|-----|-------------|
| Grafana Dashboard | [http://localhost:3000](http://localhost:3000) (Docker Compose) or [http://kubernetes.docker.internal:30300](http://kubernetes.docker.internal:30300) (Kubernetes) | — |
**Data & Infrastructure**
| Service | URL | Credentials |
|---------|-----|-------------|
| Database (Adminer) | [http://localhost:8085](http://localhost:8085) | root:secret |
| Redis Cache | [http://localhost:5540](http://localhost:5540) | — |
| RabbitMQ | [http://localhost:15672](http://localhost:15672) | guest:guest |
| Documentation | [http://localhost:8005](http://localhost:8005) | — |
## Quality Assurance & Development
**Testing**
```sh
make backend-test # Run backend tests
make frontend-test # Run frontend tests
```
**Code Quality**
```sh
make qa # Full QA suite (tests + analysis)
make sa # Static analysis
make cs # Auto-fix code style issues
```
**Utilities**
```sh
make shell # Shell access to PHP container
# Then run: php phploc.phar src/ (lines of code)
```
**All commands:** Run `make help` or see the [Makefile](./Makefile).
## Kubernetes Deployment
**Install with Helm:**
```sh
helm install app ./helm/app
# or with 2 replicas (Pods) each:
helm install app ./helm/app --set frontend.replicas=2 --set backend.replicas=2
# for telemetry:
helm install telemetry ./helm/telemetry
```
**Access Services**
| Service | Internal | Local |
|---------|----------|-------|
| API | http://kubernetes.docker.internal:30100 | http://localhost:30100 |
| Webapp | http://kubernetes.docker.internal:30200 | http://localhost:30200 |
| Dashboard | http://kubernetes.docker.internal:30300 | http://localhost:30300 |
See [helm](./helm/) for configuration details.
## Learning & References
**Architecture & Patterns**
- [Event Sourcing](https://martinfowler.com/eaaDev/EventSourcing.html) – Design pattern reference
- [Domain-Driven Design](https://www.domainlanguage.com/ddd/) – DDD principles
- [Symfony Messenger worker on Kubernetes](https://itnext.io/symfony-messenger-worker-on-kubernetes-77f75725b5ed)
**Observability**
- [OpenTelemetry](https://opentelemetry.io/docs/what-is-opentelemetry/) – Instrumentation fundamentals
- [Grafana LGTM Stack](https://grafana.com/go/webinar/getting-started-with-grafana-lgtm-stack/) – Logs, traces, metrics, profiles
**Examples**
- [Symfony Messenger Example](https://github.com/nielsvandermolen/example-symfony-messenger/blob/master/Dockerfile-php-consume)