🛠️ Dev tech stack & skill

🛠️ Development Tech Stack & Skill Documentation

📋 Project Overview

• Project Name: Space Invaders - Software Development Practices
• Course: CES2024 (25-2-23292)
• Type: 2D Arcade Game (Space Invaders Clone)
• Architecture: MVC Pattern + Entity-Component System

---

🔧 Core Technology Stack

Programming Language

• Java 21 (LTS)
  • Language Level: Java 21
  • Source/Target Compatibility: Java 21
  • Toolchain: Temurin Distribution
  • Encoding: UTF-8

Build System

• Gradle 8.14
  • Build Tool: Gradle Wrapper
  • Plugins:
    • java - Standard Java build tasks
    • application - Application execution support
  • Main Class: engine.Core

Testing Framework

• JUnit 5 (Jupiter) 5.10.0
  • Test Platform: JUnit Platform
  • Test Logging: Enabled (passed, skipped, failed events)

Graphics & UI

• Java Swing / AWT
  • 2D Graphics rendering
  • Custom font: Space Invaders Regular
  • Sprite-based animation system

Audio

• Custom Audio Manager
  • Sound effects (.wav files)
  • Background music support
  • Located in: src/audio/

---

📁 Project Structure

Invaders-SDP-Private/
├── src/                      # Source code
│   ├── audio/               # Audio management
│   ├── engine/              # Core engine
│   │   ├── DTO/            # Data Transfer Objects
│   │   ├── level/          # Level management
│   │   └── renderer/       # Rendering system
│   ├── entity/             # Game entities
│   │   ├── pattern/        # Boss attack patterns
│   │   └── skills/         # Player skills
│   └── screen/             # UI screens
├── test/                    # Unit tests
│   ├── engine/             # Engine tests
│   └── entity/             # Entity tests
├── res/                     # Resources
│   ├── images/             # Sprite images
│   ├── maps/               # Level maps
│   ├── sfx/                # Sound effects
│   └── font.ttf            # Custom font
├── .github/workflows/       # CI/CD configuration
├── build.gradle            # Gradle build config
└── README.md               # Project documentation

---

🔄 CI/CD Pipeline

GitHub Actions Configuration

File: .github/workflows/SDP-ci.yml

Trigger Events:

• Push to master branch
• Push to feature/* branches
• Pull requests to master

Pipeline Steps:

1. Checkout Code - actions/checkout@v4
2. Setup JDK 21 - actions/setup-java@v4 (Temurin distribution)
3. Cache Gradle Packages - actions/cache@v4
   • Caches: ~/.gradle/caches, ~/.gradle/wrapper
4. Grant Execute Permission - chmod +x gradlew
5. Build & Test - ./gradlew build

CI Features:

• ✅ Automated build on push/PR
• ✅ Gradle dependency caching
• ✅ Automated unit test execution

---

🧪 Unit Test Implementation Status

Current Test Coverage

Test File	Lines	Purpose	Status
GameStateTest.java	61	Coin system logic	✅ Implemented
BulletPoolTest.java	75	Bullet pooling system	✅ Implemented
ShipTest.java	183	Player ship mechanics	✅ Implemented
Total	319	-	3 test classes

Test Methods Overview

GameStateTest (5 tests):

• ✅ testAddCoins() - Adding coins
• ✅ testAddNegativeCoins() - Negative coin validation
• ✅ testDeductCoins_Success() - Successful deduction
• ✅ testDeductCoins_InsufficientFunds() - Insufficient funds handling
• ✅ testDeductCoins_Negative() - Negative deduction validation

BulletPoolTest (3+ tests):

• ✅ Bullet pool management
• ✅ Object reuse pattern
• ✅ Performance optimization

ShipTest (8+ tests):

• ✅ Ship movement mechanics
• ✅ Collision detection
• ✅ Health management
• ✅ Power-up system

Testing Limitations

• ❌ Low Coverage - Only 3 test classes for entire codebase
• ❌ No Integration Tests - Only unit tests
• ❌ No Boss Pattern Tests - Complex boss patterns not tested
• ❌ No UI Tests - Screen/rendering not tested
• ❌ No Performance Tests - No benchmarking

---

📊 Code Quality Tools

Currently NOT Implemented:

• ❌ JaCoCo - Code coverage analysis
• ❌ Checkstyle - Code style enforcement
• ❌ SpotBugs - Static bug detection
• ❌ PMD - Code quality analysis
• ❌ SonarQube - Continuous inspection

Recommended Additions:

plugins {
    id 'jacoco'
    id 'checkstyle'
    id 'com.github.spotbugs' version '6.0.0'
}

jacoco {
    toolVersion = "0.8.11"
}

jacocoTestReport {
    reports {
        xml.required = true
        html.required = true
    }
}

---

🏗️ Architecture Patterns

Design Patterns in Use:

MVC (Model-View-Controller)

• Model: entity/, engine/
• View: screen/, engine/renderer/
• Controller: engine/Core

Strategy Pattern

• Boss attack patterns (entity/pattern/)
• Different boss behaviors interchangeable

Object Pool Pattern

• Bullet pooling for performance
• Tested in BulletPoolTest

State Pattern

• Game state management
• Screen transitions

Factory Pattern

• Entity creation
• Level generation

---