<?php

namespace Modules\Sirsoft\Board\Tests\Feature\User;

// ModuleTestCase를 수동으로 require (autoload 전에 로드 필요)
require_once __DIR__.'/../../ModuleTestCase.php';

use App\Http\Middleware\PermissionMiddleware;
use App\Models\Permission;
use App\Models\Role;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\DB;
use Modules\Sirsoft\Board\Enums\PostStatus;
use Modules\Sirsoft\Board\Models\Board;
use Modules\Sirsoft\Board\Tests\ModuleTestCase;

/**
 * 최근 게시글 API 테스트
 *
 * 홈 페이지에서 사용할 최근 게시글 통합 조회 API의 동작을 검증합니다.
 *
 * @group board
 * @group board-recent-posts
 */
class BoardRecentPostsApiTest extends ModuleTestCase
{
    /**
     * 테스트 환경 설정
     */
    protected function setUp(): void
    {
        parent::setUp();

        // 기존 활성 게시판 비활성화
        Board::where('is_active', true)->update(['is_active' => false]);

        // 캐시 클리어
        Cache::flush();
    }

    /**
     * 테스트 종료 후 정리
     */
    protected function tearDown(): void
    {
        parent::tearDown();
    }

    /**
     * 최근 게시글 API가 올바른 구조로 응답하는지 테스트
     */
    public function test_recent_posts_returns_correct_structure(): void
    {
        // When: 최근 게시글 API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 올바른 구조 반환
        $response->assertStatus(200)
            ->assertJsonStructure([
                'success',
                'data',
            ]);
    }

    /**
     * 기본 limit이 5개인지 테스트
     */
    public function test_recent_posts_default_limit_is_five(): void
    {
        // Given: 게시판과 게시글 생성
        $this->createBoardWithPosts(10);

        // When: limit 없이 API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 5개 반환
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertLessThanOrEqual(5, count($data));
    }

    /**
     * limit 파라미터가 동작하는지 테스트
     */
    public function test_recent_posts_respects_limit_parameter(): void
    {
        // Given: 게시판과 게시글 생성
        $this->createBoardWithPosts(15);

        // When: limit=10으로 API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent?limit=10');

        // Then: 10개 이하 반환
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertLessThanOrEqual(10, count($data));
    }

    /**
     * limit 최대값이 20인지 테스트
     */
    public function test_recent_posts_max_limit_is_twenty(): void
    {
        // Given: 게시판과 게시글 생성
        $this->createBoardWithPosts(30);

        // When: limit=100으로 API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent?limit=100');

        // Then: 20개 이하 반환
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertLessThanOrEqual(20, count($data));
    }

    /**
     * 게시판이 없을 때 빈 배열을 반환하는지 테스트
     */
    public function test_recent_posts_returns_empty_when_no_boards(): void
    {
        // Given: 게시판 없음

        // When: API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 빈 배열 반환
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertIsArray($data);
        $this->assertEmpty($data);
    }

    /**
     * 최신순으로 정렬되는지 테스트
     */
    public function test_recent_posts_sorted_by_created_at_desc(): void
    {
        // Given: 게시판과 게시글 생성
        $this->createBoardWithPosts(5);

        // When: API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 최신순 정렬 확인
        $response->assertStatus(200);
        $data = $response->json('data');

        if (count($data) > 1) {
            // 최신순 정렬: 게시글 0(now)이 가장 먼저, 게시글 1(1분 전)이 다음
            // createBoardWithPosts()에서 제목이 "테스트 게시글 {i}"이고 created_at=now()->subMinutes($i)
            $this->assertStringContainsString('게시글 0', $data[0]['title']);
            $this->assertStringContainsString('게시글 1', $data[1]['title']);
        }
    }

    /**
     * 결과가 캐시되는지 테스트
     */
    public function test_recent_posts_are_cached(): void
    {
        // Given: 게시판 생성
        $this->createBoardWithPosts(3);

        // When: 첫 번째 API 호출
        $response1 = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent?limit=5');
        $response1->assertStatus(200);

        // 캐시 키 확인 (ModuleCacheDriver 접두사 `g7:module.sirsoft-board:` + key)
        $this->assertTrue(Cache::has('g7:module.sirsoft-board:recent_posts_5'));

        // When: 두 번째 API 호출
        $response2 = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent?limit=5');
        $response2->assertStatus(200);

        // Then: 같은 결과 반환
        $this->assertEquals($response1->json('data'), $response2->json('data'));
    }

    /**
     * 비밀글이 포함되어 is_secret 필드가 반환되는지 테스트.
     *
     * 비밀글도 제목은 공개한다(본문만 보호) — 2026-02-04 확정 정책.
     * (게시판별 열람 권한 필터는 별도 — createBoardWithPosts 가 guest read 권한을 부여한다.)
     */
    public function test_recent_posts_includes_secret_posts_with_is_secret_field(): void
    {
        // Given: 공개글 + 비밀글 혼합 생성 (i%2==0 이 비밀글, 게시판에 guest read 권한 부여됨)
        $this->createBoardWithPosts(4, includingSecret: true);

        // When: API 호출 (비로그인)
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: is_secret 필드 포함 및 비밀글도 응답에 포함
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertNotEmpty($data);

        // 모든 게시글에 is_secret 필드가 있어야 함
        foreach ($data as $post) {
            $this->assertArrayHasKey('is_secret', $post);
        }

        // 비밀글이 포함되어 있어야 함 (제목 공개 정책 — 비밀글도 목록/최근글에 표시)
        $secretPosts = array_filter($data, fn ($post) => $post['is_secret'] === true);
        $this->assertNotEmpty($secretPosts, '비밀글이 응답에 포함되어야 합니다(제목 공개).');
    }

    /**
     * 비밀글도 제목이 정상적으로 표시되는지 테스트 (제목 공개 정책 — 본문만 보호).
     */
    public function test_secret_post_title_is_visible_in_recent_posts(): void
    {
        // Given: 비밀글이 있는 게시판 생성 (guest read 권한 부여)
        $board = Board::factory()->create([
            'is_active' => true,
            'name' => ['ko' => '비밀게시판', 'en' => 'Secret Board'],
        ]);
        $this->grantGuestRead($board);

        DB::table('board_posts')->insert([
            'board_id' => $board->id,
            'title' => '비밀 문의입니다',
            'content' => '비밀 내용',
            'author_name' => '홍길동',
            'is_secret' => true,
            'status' => PostStatus::Published->value,
            'ip_address' => '127.0.0.1',
            'created_at' => now(),
            'updated_at' => now(),
        ]);

        // When: API 호출 (비로그인)
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 비밀글 제목이 보여야 함 (마스킹 안 됨 — 제목 공개 정책)
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertNotEmpty($data);
        $secretPost = $data[0];
        $this->assertTrue($secretPost['is_secret']);
        $this->assertEquals('비밀 문의입니다', $secretPost['title']);
    }

    /**
     * 최근 게시글 응답에 created_at(Y-m-d H:i:s 포맷)과 created_at_formatted(표시용) 필드가 포함되는지 확인
     */
    public function test_recent_posts_includes_created_at_and_created_at_formatted(): void
    {
        // Given: 게시판과 게시글 생성
        $this->createBoardWithPosts(1);

        // When: API 호출
        $response = $this->getJson('/api/modules/sirsoft-board/boards/posts/recent');

        // Then: 응답에 created_at/created_at_formatted 필드 포함
        $response->assertStatus(200);
        $data = $response->json('data');

        $this->assertNotEmpty($data);
        $item = $data[0];

        // created_at: 전체 날짜+시간 포맷 (사용자 타임존)
        $this->assertArrayHasKey('created_at', $item);
        $this->assertMatchesRegularExpression('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $item['created_at']);

        // created_at_formatted: 표시용 포맷 (비어있지 않은 문자열)
        $this->assertArrayHasKey('created_at_formatted', $item);
        $this->assertNotEmpty($item['created_at_formatted']);
    }

    /**
     * 게시판과 게시글을 생성하는 헬퍼
     *
     * @param  int  $postCount  생성할 게시글 수
     * @param  bool  $includingSecret  비밀글 포함 여부
     * @return Board 생성된 게시판
     */
    private function createBoardWithPosts(int $postCount, bool $includingSecret = false): Board
    {
        $board = Board::factory()->create([
            'is_active' => true,
        ]);

        // 공개 최근글은 게시판별 열람 권한(posts.read)을 통과한 게시판만 노출한다.
        // 프로덕션에서 공개 게시판은 guest read 권한을 갖도록 생성되므로 동일하게 부여한다.
        $this->grantGuestRead($board);

        for ($i = 0; $i < $postCount; $i++) {
            $isSecret = $includingSecret && ($i % 2 === 0);

            DB::table('board_posts')->insert([
                'board_id' => $board->id,
                'title' => "테스트 게시글 {$i}",
                'content' => "게시글 내용 {$i}",
                'author_name' => '작성자',
                'view_count' => rand(0, 100),
                'is_secret' => $isSecret,
                'status' => PostStatus::Published->value,
                'ip_address' => '127.0.0.1',
                'created_at' => now()->subMinutes($i),
                'updated_at' => now()->subMinutes($i),
            ]);
        }

        return $board;
    }

    /**
     * 게시판에 비회원(guest) 읽기 권한(posts.read)을 부여합니다.
     *
     * 공개 최근글 API 는 게시판별 열람 권한을 응답 시점에 적용하므로,
     * 공개 노출을 기대하는 테스트 게시판은 프로덕션처럼 guest read 권한을 갖춰야 한다.
     *
     * @param  Board  $board  대상 게시판
     */
    private function grantGuestRead(Board $board): void
    {
        $guestRole = Role::where('identifier', 'guest')->first();
        if (! $guestRole) {
            return;
        }

        $perm = Permission::firstOrCreate(
            ['identifier' => "sirsoft-board.{$board->slug}.posts.read"],
            ['name' => ['ko' => 'read', 'en' => 'read'], 'type' => 'user']
        );
        $guestRole->permissions()->syncWithoutDetaching([$perm->id]);

        PermissionMiddleware::clearGuestRoleCache();
    }
}