Files
Gnuboard7/database/seeders/IdentityMessageDefinitionSeeder.php
T
HeuJung 28d6a7752c fix(core,message_bizppurio): 브랜치 검증 발견 결함 4건 — 스냅샷 회귀·조건부 skip·낡은 주석
출시 전 /validate-branch 통합 검증에서 발견한 결함을 처리한다.

- BindingShape 라우팅 diff 스냅샷이 중간 상태에서 구워져 HEAD 가 red 였다.
 발산 517건을 덤프해 신규 41건이 전부 객체·배열 리터럴 바인딩(구 정규식
 오판 계열)이고 유해 지점 스냅샷은 이미 green 임을 확인한 뒤 기록값을 맞춘다.
- 채널 잔재 정리 검증이 게시판 모듈 활성 환경에서만 실행돼 대부분의 실행에서
 미검증으로 남았다. 정리 로직이 소유자를 묻지 않는 실제 계약대로 모듈 소유
 정의를 테스트 안에서 구성해 무조건 실행되게 한다.
- activity_log 주석이 폐기된 설계(조회 전용 전환·콘솔 위임)를 서술하고 있어
 현행 사실로 정정한다. 사용자 문구는 바뀌지 않는다.
- 설정성 테이블의 상한 없는 조회 근거와 seeder 반환 키 타입을 코드에 남긴다.
2026-08-24 17:03:42 +09:00

119 lines
4.5 KiB
PHP

<?php
namespace Database\Seeders;
use App\Extension\Helpers\IdentityMessageSyncHelper;
use App\Extension\HookManager;
use Illuminate\Database\Seeder;
/**
* IDV 메시지 정의 시더.
*
* config/core.php 의 `identity_messages` 블록을 SSoT 로 읽어 DB 로 동기화합니다.
* IdentityPolicySeeder / NotificationDefinitionSeeder 와 동일한 config-기반 패턴.
*
* 운영자가 관리자 UI 에서 수정한 값은 user_overrides 로 보존되어 재시딩 시 덮어써지지 않습니다.
*
* @since 7.0.0-beta.4
*/
class IdentityMessageDefinitionSeeder extends Seeder
{
/**
* 시드 실행.
*
* @return void
*/
public function run(): void
{
$this->command?->info('코어 IDV 메시지 정의 시딩 시작...');
$helper = app(IdentityMessageSyncHelper::class);
$definitions = $this->getDefaultDefinitions();
// 언어팩 시스템: 활성 코어 언어팩의 seed/identity_messages.json 으로 다국어 키 병합.
// NotificationDefinitionSeeder 와 동일 패턴.
$definitions = HookManager::applyFilters('seed.identity_messages.translations', $definitions);
$definedScopes = [];
if (empty($definitions)) {
$this->command?->warn('config/core.php 에 identity_messages 선언이 없습니다.');
return;
}
foreach ($definitions as $data) {
$definition = $helper->syncDefinition($data);
$definedScopes[] = [
'provider_id' => $definition->provider_id,
'scope_type' => $definition->scope_type->value,
'scope_value' => $definition->scope_value,
];
$definedChannels = [];
foreach ($data['templates'] as $template) {
$helper->syncTemplate($definition->id, $template);
$definedChannels[] = $template['channel'];
}
$helper->cleanupStaleTemplates($definition->id, $definedChannels);
$this->command?->info(" - {$definition->provider_id} | {$definition->scope_type->value} | {$definition->scope_value} 등록 완료");
}
$helper->cleanupStaleDefinitions('core', 'core', $definedScopes);
$this->command?->info('코어 IDV 메시지 정의 시딩 완료 ('.count($definitions).'종)');
}
/**
* 코어 기본 메시지 정의 데이터를 config/core.php 에서 조회합니다.
*
* `extension_type='core'` / `extension_identifier='core'` 자동 주입.
* `variables: '__common__'` 마커는 commonVariables() 로 expand.
*
* @return array<string, array<string, mixed>> config 복합 키('mail.purpose.signup' 등) => 정의
*/
private function getDefaultDefinitions(): array
{
$messages = config('core.identity_messages', []);
$result = [];
foreach ($messages as $key => $data) {
if (($data['variables'] ?? null) === '__common__') {
$data['variables'] = $this->commonVariables();
}
$data['extension_type'] = 'core';
$data['extension_identifier'] = 'core';
// config 복합 키('mail.purpose.signup' 등)를 보존 — 언어팩 주입 필터
// (seed.identity_messages.translations)가 이 키로 seed 를 매칭한다.
// 리스트로 만들면 전 항목이 매칭 불가로 스킵되어 팩 로케일이 오류 없이
// 주입되지 않는다 (#597 에서 실측·교정 — IdentityMessageTemplateService
// ::loadCoreMessageDefinitions 의 동형 보존과 짝을 이룬다).
$result[$key] = $data;
}
return $result;
}
/**
* 표준 변수 메타데이터 (모든 mail 정의 공통).
*
* config/core.php 에서 `'variables' => '__common__'` 마커로 참조됩니다.
*
* @return array<int, array{key: string, description: string}>
*/
protected function commonVariables(): array
{
return [
['key' => 'code', 'description' => '인증 코드 (text_code 흐름)'],
['key' => 'action_url', 'description' => '검증 링크 URL (link 흐름)'],
['key' => 'expire_minutes', 'description' => '만료까지 남은 분'],
['key' => 'purpose_label', 'description' => '인증 목적 라벨 (다국어)'],
['key' => 'app_name', 'description' => '사이트명'],
['key' => 'site_url', 'description' => '사이트 URL'],
['key' => 'recipient_email', 'description' => '수신자 이메일'],
];
}
}