Merge pull request 'chore: Update some README's' (!280) from update-readmes into main
Reviewed-on: #280
This commit is contained in:
commit
fc60cfb3d5
2 changed files with 217 additions and 51 deletions
|
|
@ -1,59 +1,137 @@
|
||||||
# Starter für das LF08 Projekt
|
# Casino Gaming Platform - Backend API
|
||||||
|
|
||||||
## Requirements
|
A Spring Boot backend application providing REST APIs for a casino gaming platform with multiple games, user management, authentication, and payment processing.
|
||||||
* Docker https://docs.docker.com/get-docker/
|
|
||||||
* Docker compose (bei Windows und Mac schon in Docker enthalten) https://docs.docker.com/compose/install/
|
|
||||||
|
|
||||||
## Endpunkt
|
## Features
|
||||||
```
|
|
||||||
http://localhost:8080
|
|
||||||
```
|
|
||||||
## Swagger
|
|
||||||
```
|
|
||||||
http://localhost:8080/swagger
|
|
||||||
```
|
|
||||||
|
|
||||||
|
### Games
|
||||||
|
- **Blackjack** - Classic card game with deck management
|
||||||
|
- **Coinflip** - Simple heads/tails betting game
|
||||||
|
- **Dice** - Dice rolling game
|
||||||
|
- **Slots** - Slot machine with symbols and payouts
|
||||||
|
- **Lootboxes** - Reward system with configurable prizes
|
||||||
|
|
||||||
# Postgres
|
### User Management
|
||||||
### Terminal öffnen
|
- User registration and authentication
|
||||||
für alles gilt, im Terminal im Ordner docker/local sein
|
- OAuth2 integration (Google, GitHub)
|
||||||
|
- Email verification and password reset
|
||||||
|
- Balance management and transaction history
|
||||||
|
|
||||||
|
### Payment System
|
||||||
|
- Deposit functionality with webhook support
|
||||||
|
- Transaction tracking and status management
|
||||||
|
- Balance updates and fund validation
|
||||||
|
|
||||||
|
## Tech Stack
|
||||||
|
- **Java 17** with Spring Boot
|
||||||
|
- **Spring Security** with JWT authentication
|
||||||
|
- **Spring Data JPA** with PostgreSQL
|
||||||
|
- **OAuth2** for social login
|
||||||
|
- **Email service** for notifications
|
||||||
|
- **OpenAPI/Swagger** for API documentation
|
||||||
|
|
||||||
|
## Build & Run
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
- Java 17+
|
||||||
|
- Gradle
|
||||||
|
- Docker & Docker Compose (for PostgreSQL)
|
||||||
|
|
||||||
|
### Build Commands
|
||||||
```bash
|
```bash
|
||||||
|
# Build the application
|
||||||
|
./gradlew build
|
||||||
|
|
||||||
|
# Clean build
|
||||||
|
./gradlew clean build
|
||||||
|
|
||||||
|
# Run the application
|
||||||
|
./gradlew bootRun
|
||||||
|
|
||||||
|
# Generate JAR file
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
### Testing
|
||||||
|
```bash
|
||||||
|
# Run all tests
|
||||||
|
./gradlew test
|
||||||
|
|
||||||
|
# Run specific test class
|
||||||
|
./gradlew test --tests "FullyQualifiedClassName"
|
||||||
|
|
||||||
|
# Run checkstyle
|
||||||
|
./gradlew checkstyleMain checkstyleTest
|
||||||
|
```
|
||||||
|
|
||||||
|
## API Endpoints
|
||||||
|
|
||||||
|
The application runs on `http://localhost:8080`
|
||||||
|
|
||||||
|
### API Documentation
|
||||||
|
- **Swagger UI**: `http://localhost:8080/swagger-ui.html`
|
||||||
|
- **OpenAPI Spec**: `http://localhost:8080/v3/api-docs`
|
||||||
|
|
||||||
|
### Main Endpoints
|
||||||
|
- `/api/auth/**` - Authentication and user management
|
||||||
|
- `/api/games/blackjack/**` - Blackjack game operations
|
||||||
|
- `/api/games/coinflip/**` - Coinflip game operations
|
||||||
|
- `/api/games/dice/**` - Dice game operations
|
||||||
|
- `/api/games/slots/**` - Slot machine operations
|
||||||
|
- `/api/lootboxes/**` - Lootbox management
|
||||||
|
- `/api/deposits/**` - Payment and deposit handling
|
||||||
|
- `/api/users/**` - User profile management
|
||||||
|
- `/api/health` - Health check endpoint
|
||||||
|
|
||||||
|
## Database Setup
|
||||||
|
|
||||||
|
### PostgreSQL with Docker
|
||||||
|
```bash
|
||||||
|
# Start PostgreSQL container
|
||||||
cd docker/local
|
cd docker/local
|
||||||
```
|
|
||||||
### Postgres starten
|
|
||||||
```bash
|
|
||||||
docker compose up
|
docker compose up
|
||||||
```
|
|
||||||
Achtung: Der Docker-Container läuft dauerhaft! Wenn er nicht mehr benötigt wird, sollten Sie ihn stoppen.
|
|
||||||
|
|
||||||
### Postgres stoppen
|
# Stop PostgreSQL container
|
||||||
```bash
|
|
||||||
docker compose down
|
docker compose down
|
||||||
```
|
|
||||||
|
|
||||||
### Postgres Datenbank wipen, z.B. bei Problemen
|
# Reset database (if needed)
|
||||||
```bash
|
|
||||||
docker compose down
|
docker compose down
|
||||||
docker volume rm local_lf8_starter_postgres_data
|
docker volume rm local_lf8_starter_postgres_data
|
||||||
docker compose up
|
docker compose up
|
||||||
```
|
```
|
||||||
|
|
||||||
### Intellij-Ansicht für Postgres Datenbank einrichten
|
### Database Configuration
|
||||||
```bash
|
Database connection settings are configured in `src/main/resources/application.properties`
|
||||||
1. Lasse den Docker-Container mit der PostgreSQL-Datenbank laufen
|
|
||||||
2. im Ordner resources die Datei application.properties öffnen und die URL der Datenbank kopieren
|
|
||||||
3. rechts im Fenster den Reiter Database öffnen
|
|
||||||
4. In der Database-Symbolleiste auf das Datenbanksymbol mit dem Schlüssel klicken
|
|
||||||
5. auf das Pluszeichen klicken
|
|
||||||
6. Datasource from URL auswählen
|
|
||||||
7. URL der DB einfügen und PostgreSQL-Treiber auswählen, mit OK bestätigen
|
|
||||||
8. Username lf8_starter und Passwort secret eintragen (siehe application.properties), mit Apply bestätigen
|
|
||||||
9. im Reiter Schemas alle Häkchen entfernen und lediglich vor lf8_starter_db und public Häkchen setzen
|
|
||||||
10. mit Apply und ok bestätigen
|
|
||||||
```
|
|
||||||
# Keycloak
|
|
||||||
|
|
||||||
### Keycloak Token
|
### IntelliJ Database Setup
|
||||||
1. Auf der Projektebene [GetBearerToken.http](../GetBearerToken.http) öffnen.
|
1. Start the PostgreSQL Docker container
|
||||||
2. Neben der Request auf den grünen Pfeil drücken
|
2. Open `application.properties` and copy the database URL
|
||||||
3. Aus dem Reponse das access_token kopieren
|
3. In IntelliJ, open the Database tab (right panel)
|
||||||
|
4. Click the database icon with key in the toolbar
|
||||||
|
5. Click the plus (+) icon
|
||||||
|
6. Select "Datasource from URL"
|
||||||
|
7. Paste the database URL and select PostgreSQL driver
|
||||||
|
8. Enter credentials (username: `lf8_starter`, password: `secret`)
|
||||||
|
9. In Schemas tab, uncheck all except `lf8_starter_db` and `public`
|
||||||
|
10. Apply and confirm
|
||||||
|
|
||||||
|
## Authentication
|
||||||
|
|
||||||
|
The application supports multiple authentication methods:
|
||||||
|
- JWT-based authentication
|
||||||
|
- OAuth2 (Google, GitHub)
|
||||||
|
- Email/password with verification
|
||||||
|
|
||||||
|
### Getting Bearer Token
|
||||||
|
For API testing, use the provided HTTP client file:
|
||||||
|
1. Open `GetBearerToken.http` at project root
|
||||||
|
2. Execute the request
|
||||||
|
3. Copy the `access_token` from the response
|
||||||
|
4. Use in Authorization header: `Bearer <token>`
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
Key configuration files:
|
||||||
|
- `application.properties` - Main application configuration
|
||||||
|
- `SecurityConfig.java` - Security and CORS settings
|
||||||
|
- `OpenAPIConfiguration.java` - API documentation setup
|
||||||
|
|
@ -1,18 +1,106 @@
|
||||||
# Casino Gaming Platform - Frontend
|
# Casino Gaming Platform - Frontend
|
||||||
|
|
||||||
This is the frontend application for the Casino Gaming Platform. It's built with Angular 18 and TailwindCSS, providing a responsive and modern UI for the casino gaming experience.
|
A modern Angular 20 casino gaming platform featuring multiple games including Blackjack, Coinflip, Dice, Slots, and Lootboxes. Built with Angular 20, TailwindCSS 4, and powered by Bun for fast development.
|
||||||
|
|
||||||
## Development
|
## 🎮 Features
|
||||||
|
|
||||||
### Commands
|
- **Multiple Games**: Blackjack, Coinflip, Dice, Slots, Lootboxes
|
||||||
|
- **User Authentication**: OAuth2, email verification, password recovery
|
||||||
|
- **Real-time Gaming**: Interactive game mechanics with animations
|
||||||
|
- **Payment Integration**: Stripe integration for deposits
|
||||||
|
- **Responsive Design**: Mobile-first design with TailwindCSS
|
||||||
|
- **Audio Experience**: Game sounds and audio feedback
|
||||||
|
- **Transaction History**: Complete betting and transaction tracking
|
||||||
|
|
||||||
- **Build**: `bun run build` or `bunx @angular/cli build`
|
## 🚀 Getting Started
|
||||||
- **Start Dev Server**: `bun run start` or `bunx @angular/cli serve --proxy-config src/proxy.conf.json`
|
|
||||||
- **Format Code**: `bun run format` or `prettier --write "src/**/*.{ts,html,css,scss}"`
|
### Prerequisites
|
||||||
- **Lint**: `bun run lint` or `ng lint`
|
|
||||||
- **Test**: `bun run test` or `bunx @angular/cli test`
|
- [Bun](https://bun.sh/) (recommended) or Node.js 18+
|
||||||
|
- Angular CLI 20+
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
bun install
|
||||||
|
|
||||||
|
# Start development server
|
||||||
|
bun run start
|
||||||
|
```
|
||||||
|
|
||||||
|
The app will be available at `http://localhost:4200`
|
||||||
|
|
||||||
|
## 📋 Commands
|
||||||
|
|
||||||
|
### Development
|
||||||
|
- **Start Dev Server**: `bun run start` - Starts dev server with proxy configuration
|
||||||
|
- **Build**: `bun run build` - Production build
|
||||||
|
- **Watch Build**: `bun run watch` - Development build with file watching
|
||||||
|
|
||||||
|
### Code Quality
|
||||||
|
- **Format**: `bun run format` - Format code with Prettier
|
||||||
|
- **Format Check**: `bun run format:check` - Check code formatting
|
||||||
|
- **Lint**: `bun run lint` - Run ESLint
|
||||||
|
- **OxLint**: `bun run oxlint` - Run OxLint with strict warnings
|
||||||
|
|
||||||
|
### Testing
|
||||||
|
- **Test All**: `bun run test` - Run all tests with Karma/Jasmine
|
||||||
- **Test Single File**: `bunx @angular/cli test --include=path/to/test.spec.ts`
|
- **Test Single File**: `bunx @angular/cli test --include=path/to/test.spec.ts`
|
||||||
|
|
||||||
|
## 🛠️ Technology Stack
|
||||||
|
|
||||||
|
### Core
|
||||||
|
- **Angular 20**: Latest Angular framework with standalone components
|
||||||
|
- **TypeScript 5.8**: Strongly typed JavaScript
|
||||||
|
- **RxJS 7.8**: Reactive programming for HTTP and state management
|
||||||
|
|
||||||
|
### Styling & UI
|
||||||
|
- **TailwindCSS 4**: Utility-first CSS framework
|
||||||
|
- **PostCSS**: CSS processing and optimization
|
||||||
|
- **FontAwesome**: Icon library with Angular integration
|
||||||
|
|
||||||
|
### Animation & Interaction
|
||||||
|
- **GSAP**: High-performance animations
|
||||||
|
- **CountUp.js**: Number animation effects
|
||||||
|
- **Custom Audio Service**: Game sound effects and feedback
|
||||||
|
|
||||||
|
### Development Tools
|
||||||
|
- **Bun**: Fast JavaScript runtime and package manager
|
||||||
|
- **ESLint + Angular ESLint**: Code linting with Angular-specific rules
|
||||||
|
- **OxLint**: Fast Rust-based linter
|
||||||
|
- **Prettier**: Code formatting
|
||||||
|
- **Karma + Jasmine**: Testing framework
|
||||||
|
|
||||||
|
### Payment & APIs
|
||||||
|
- **Stripe**: Payment processing integration
|
||||||
|
- **Custom HTTP Interceptors**: API communication and error handling
|
||||||
|
|
||||||
|
## 🏗️ Architecture
|
||||||
|
|
||||||
|
### Project Structure
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
├── app/
|
||||||
|
│ ├── feature/ # Feature modules
|
||||||
|
│ │ ├── auth/ # Authentication (login, register, OAuth2)
|
||||||
|
│ │ ├── game/ # Game modules (blackjack, coinflip, dice, slots)
|
||||||
|
│ │ ├── lootboxes/ # Lootbox system
|
||||||
|
│ │ └── deposit/ # Payment and deposits
|
||||||
|
│ ├── model/ # Data models and interfaces
|
||||||
|
│ ├── service/ # Core services (auth, user, transaction)
|
||||||
|
│ └── shared/ # Shared components, directives, services
|
||||||
|
├── environments/ # Environment configurations
|
||||||
|
└── public/ # Static assets (images, sounds)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Key Components
|
||||||
|
- **Game Components**: Modular game implementations with services
|
||||||
|
- **Shared Components**: Reusable UI components (navbar, footer, modals)
|
||||||
|
- **Services**: Business logic and API communication
|
||||||
|
- **Guards**: Route protection and authentication
|
||||||
|
- **Interceptors**: HTTP request/response handling
|
||||||
|
|
||||||
## Style Guide
|
## Style Guide
|
||||||
|
|
||||||
### Color Palette
|
### Color Palette
|
||||||
|
|
|
||||||
Reference in a new issue