new: pkg: add test cases to back-end w/ real database connection in it #10

2026-04-21 17:56:04 +02:00
parent 6bf908b43e
commit d704be5bff
38 changed files with 5429 additions and 17 deletions
--- a/tests/README.md
+++ b/tests/README.md
@@ -0,0 +1,108 @@
+# Tests Directory
+
+This directory contains all test files for the MineSeeker project.
+
+## Quick Start
+
+```bash
+# Run all tests (recommended)
+make test
+
+# Or with PHPUnit directly:
+vendor/bin/phpunit
+
+# Run specific test file
+vendor/bin/phpunit tests/Controller/ProfileControllerTest.php
+
+# Run with filter
+vendor/bin/phpunit --filter testCreateUser
+```
+
+## Documentation
+
+For comprehensive testing documentation, see:
+
+- **[Testing Guide](../docs/testing/TESTING.md)** - Complete testing setup, best practices, troubleshooting
+- **[Factory Documentation](../docs/testing/FACTORIES.md)** - Detailed factory API reference
+
+## Directory Structure
+
+```
+tests/
+├── Controller/          # HTTP endpoint tests
+├── Dto/                 # Data Transfer Object tests
+├── Entity/              # Entity logic tests
+├── Service/             # Service layer tests
+├── Integration/         # Integration tests (example: FactoryExampleTest.php)
+├── Factory/             # Foundry factory classes
+│   ├── UserFactory.php
+│   ├── GamerFactory.php
+│   ├── PlayedGameFactory.php
+│   ├── StepFactory.php
+│   ├── GridFactory.php
+│   ├── GridRowFactory.php
+│   ├── WebAuthnCredentialFactory.php
+│   └── ContactMessageFactory.php
+├── WebTestCase.php      # Base test class (extends this!)
+├── bootstrap.php        # PHPUnit bootstrap
+└── README.md            # This file
+```
+
+## Quick Factory Examples
+
+```php
+use App\Tests\Factory\UserFactory;
+use App\Tests\Factory\PlayedGameFactory;
+use App\Tests\WebTestCase;
+
+class MyTest extends WebTestCase
+{
+    public function testExample(): void
+    {
+        /** Create user */
+        $user = UserFactory::createOne();
+
+        /** Create game with registered players */
+        $game = PlayedGameFactory::new()
+            ->withRegisteredPlayers()
+            ->redWins()
+            ->create();
+
+        /** Create multiple entities */
+        UserFactory::createMany(5);
+
+        /** Access repository */
+        $users = UserFactory::repository()->findAll();
+    }
+}
+```
+
+## Important Notes
+
+- **Always extend `App\Tests\WebTestCase`** - provides database isolation
+- **Use factories** - don't manually create entities with `new Entity()`
+- **Test database** - Tests run on `mineseeker_test`, never production
+- **Automatic rollback** - Each test is wrapped in a transaction
+
+## Test Database Setup (One-time)
+
+```bash
+# Create test database
+bin/console dbal:run-sql "CREATE DATABASE mineseeker_test"
+
+# Run migrations
+bin/console doctrine:migrations:migrate --env=test --no-interaction
+```
+
+## Troubleshooting
+
+### Tests interfering with each other?
+→ Make sure your test extends `App\Tests\WebTestCase`
+
+### Database schema out of sync?
+→ Run `bin/console doctrine:migrations:migrate --env=test`
+
+### Memory limit errors?
+→ Run `php -d memory_limit=512M vendor/bin/phpunit`
+
+For more troubleshooting, see [Testing Guide](../docs/testing/TESTING.md#troubleshooting).