pigui/landing-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Pireon Admin — headless admin panel and public API

Browse Source 
Laravel 13 + Filament 5 admin panel and REST API for a non-profit developer
collective, backed by the Pireon OAuth identity server. The public site is a
separate, server-rendered application consuming /api/public/v1.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Josep Piguillem
2026-08-19 17:55:27 +02:00
commit 3897113313
534 changed files with 64050 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

281
tests/Feature/Git/RepositorySyncTest.php Normal file
View File

@@ -0,0 +1,281 @@
<?php
declare(strict_types=1);
namespace Tests\Feature\Git;
use App\Enums\GitProvider;
use App\Models\Repository;
use App\Services\Git\GitException;
use App\Services\Git\GitManager;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Http;
use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;
/**
* The GitHub driver is kept for mirrors and the odd repository hosted
* elsewhere; Gitea is the collective's own instance (see GiteaSyncTest).
* These tests also stand as the proof that the provider interface really is
* substitutable.
*/
class RepositorySyncTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
// Gitea is the default, so GitHub has to be asked for explicitly.
$this->githubDefaults = ['provider' => GitProvider::GitHub];
}
/** @var array<string, mixed> */
protected array $githubDefaults = [];
/**
* @param array<string, mixed> $repo
* @param array<int, array<string, mixed>> $issues
*/
protected function fakeGitHub(array $repo = [], array $issues = []): void
{
Http::fake([
'api.github.com/repos/*/languages' => Http::response(['PHP' => 90000, 'Blade' => 12000]),
'api.github.com/repos/*/contributors*' => Http::response([['login' => 'a']], 200, [
// GitHub reports the total through the Link header's last page.
'Link' => '<https://api.github.com/repositories/1/contributors?per_page=1&page=7>; rel="last"',
]),
'api.github.com/repos/*/issues*' => Http::response($issues),
'api.github.com/repos/*' => Http::response([
'full_name' => 'colectivo/web',
'html_url' => 'https://github.com/colectivo/web',
'description' => 'La web del colectivo',
'default_branch' => 'main',
'language' => 'PHP',
'license' => ['spdx_id' => 'AGPL-3.0'],
'topics' => ['laravel', 'community'],
'stargazers_count' => 128,
'forks_count' => 9,
'subscribers_count' => 5,
'open_issues_count' => 12,
'archived' => false,
'fork' => false,
'pushed_at' => '2026-08-01T10:00:00Z',
'created_at' => '2024-01-01T00:00:00Z',
...$repo,
]),
]);
}
#[Test]
public function it_mirrors_the_repository_stats(): void
{
$this->fakeGitHub();
$repository = Repository::factory()->create([
...$this->githubDefaults,
'full_name' => 'colectivo/web',
'stars' => 0,
'last_synced_at' => null,
]);
app(GitManager::class)->sync($repository);
$repository->refresh();
$this->assertSame(128, $repository->stars);
$this->assertSame('PHP', $repository->primary_language);
$this->assertSame('AGPL-3.0', $repository->license);
$this->assertSame(['laravel', 'community'], $repository->topics);
$this->assertSame(['PHP' => 90000, 'Blade' => 12000], $repository->languages);
// Contributor count is read from the Link header's last page rather
// than by paging through every contributor.
$this->assertSame(7, $repository->contributors_count);
$this->assertNotNull($repository->last_synced_at);
$this->assertNull($repository->sync_error);
}
#[Test]
public function it_only_mirrors_newcomer_friendly_issues(): void
{
$this->fakeGitHub(issues: [
[
'number' => 1, 'title' => 'Good one', 'html_url' => 'https://x/1',
'labels' => [['name' => 'good first issue']], 'comments' => 2,
'user' => ['login' => 'ada'], 'assignee' => null,
'created_at' => '2026-07-01T00:00:00Z', 'updated_at' => '2026-07-02T00:00:00Z',
],
[
'number' => 2, 'title' => 'Help please', 'html_url' => 'https://x/2',
'labels' => [['name' => 'Help Wanted']], 'comments' => 0,
'user' => ['login' => 'ada'], 'assignee' => ['login' => 'bob'],
'created_at' => '2026-07-01T00:00:00Z', 'updated_at' => '2026-07-02T00:00:00Z',
],
// Ordinary issue: noise for a newcomer, so it is not mirrored.
[
'number' => 3, 'title' => 'Refactor internals', 'html_url' => 'https://x/3',
'labels' => [['name' => 'chore']], 'comments' => 0,
'user' => ['login' => 'ada'], 'assignee' => null,
'created_at' => '2026-07-01T00:00:00Z', 'updated_at' => '2026-07-02T00:00:00Z',
],
// A pull request is not something anyone picks up.
[
'number' => 4, 'title' => 'A PR', 'html_url' => 'https://x/4',
'labels' => [['name' => 'good first issue']], 'pull_request' => ['url' => 'x'],
'user' => ['login' => 'ada'], 'created_at' => '2026-07-01T00:00:00Z',
'updated_at' => '2026-07-02T00:00:00Z',
],
]);
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'colectivo/web']);
app(GitManager::class)->sync($repository);
$this->assertSame(2, $repository->issues()->count());
$this->assertSame(1, $repository->goodFirstIssues()->count());
// Label matching is case-insensitive, per config/git.php.
$helpWanted = $repository->issues()->where('number', 2)->first();
$this->assertTrue($helpWanted->is_help_wanted);
$this->assertSame('bob', $helpWanted->assignee);
$this->assertFalse($helpWanted->isUnclaimed());
}
#[Test]
public function issues_closed_upstream_disappear_here(): void
{
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'colectivo/web']);
$repository->issues()->create([
'number' => 99, 'title' => 'Closed since', 'html_url' => 'https://x/99',
'is_good_first_issue' => true,
]);
$this->fakeGitHub(issues: []);
app(GitManager::class)->sync($repository);
// Advertising an issue that is actually closed wastes a would-be
// contributor's time, so the mirror is replaced, not merged.
$this->assertSame(0, $repository->issues()->count());
}
#[Test]
public function a_missing_repository_is_recorded_and_not_retried(): void
{
Http::fake([
'api.github.com/*' => Http::response(['message' => 'Not Found'], 404),
]);
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'colectivo/gone']);
try {
app(GitManager::class)->sync($repository);
$this->fail('Expected a GitException.');
} catch (GitException $e) {
$this->assertSame(404, $e->status);
$this->assertFalse($e->isTransient);
}
$repository->refresh();
$this->assertStringContainsString('does not exist', $repository->sync_error);
$this->assertSame(1, $repository->sync_failures);
}
#[Test]
public function repeated_failures_flag_the_repository_in_the_panel(): void
{
Http::fake(['api.github.com/*' => Http::response([], 404)]);
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'colectivo/gone']);
foreach (range(1, 3) as $ignored) {
rescue(fn () => app(GitManager::class)->sync($repository));
}
$this->assertSame(3, $repository->fresh()->sync_failures);
$this->assertTrue(Repository::query()->failing()->exists());
}
#[Test]
public function a_rate_limit_is_reported_as_transient(): void
{
Http::fake([
'api.github.com/*' => Http::response(['message' => 'rate limit'], 403, [
'X-RateLimit-Remaining' => '0',
'X-RateLimit-Reset' => (string) (time() + 120),
]),
]);
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'colectivo/web']);
try {
app(GitManager::class)->sync($repository);
$this->fail('Expected a GitException.');
} catch (GitException $e) {
// Transient means the job should back off and retry, not give up.
$this->assertTrue($e->isTransient);
$this->assertSame(429, $e->status);
$this->assertStringContainsString('GITHUB_TOKEN', $e->getMessage());
}
}
#[Test]
public function a_successful_sync_clears_a_previous_error(): void
{
$repository = Repository::factory()->failing()->create([...$this->githubDefaults, 'full_name' => 'colectivo/web']);
$this->fakeGitHub();
app(GitManager::class)->sync($repository);
$repository->refresh();
$this->assertNull($repository->sync_error);
$this->assertSame(0, $repository->sync_failures);
}
#[Test]
public function synced_columns_cannot_be_mass_assigned(): void
{
// A hand-typed star count is a lie waiting to happen, so the sync
// columns are deliberately absent from the fillable list.
$repository = new Repository;
$repository->fill(['full_name' => 'colectivo/web', 'stars' => 9999]);
$this->assertSame('colectivo/web', $repository->full_name);
$this->assertNull($repository->stars);
}
#[Test]
public function a_bare_name_is_qualified_with_the_configured_org(): void
{
config()->set('git.providers.github.default_owner', 'colectivo');
$this->fakeGitHub();
$repository = Repository::factory()->create([...$this->githubDefaults, 'full_name' => 'web']);
app(GitManager::class)->sync($repository);
// The provider's own answer wins, so the record self-corrects.
$this->assertSame('colectivo/web', $repository->fresh()->full_name);
Http::assertSent(fn ($request) => str_contains($request->url(), '/repos/colectivo/web'));
}
#[Test]
public function an_unsupported_provider_fails_clearly(): void
{
$repository = Repository::factory()->create(['provider' => 'gitlab']);
$this->expectException(GitException::class);
$this->expectExceptionMessage('No driver is registered for the [gitlab] provider');
app(GitManager::class)->sync($repository);
}
}