fix(core,board,ecommerce,page,kginicis): 정책값 하드코딩·계약 분리 결함 일괄 수정

관리자 환경설정이 값을 저장은 하지만 실제 동작에는 닿지 않던 결함군을 정리했다.
설정 화면(min/max)·저장 검증(FormRequest)·런타임 적용(Service) 세 계층이 각자
리터럴을 들고 있어 서로 조용히 갈라지던 것이 공통 원인이다.

경계값 SSoT 도입:
- config/core.php `settings_limits` 를 단일 출처로 두고, FormRequest 는 이 값으로
 규칙을 만들고 화면은 설정 응답의 `_meta.limits` 로 같은 값을 받아 바인딩한다.
- 게시판·이커머스도 각 모듈 config 의 limits 를 동일 구조로 노출한다.

적용되지 않던 정책을 실제로 적용:
- 비밀번호 최소 길이·특수문자 필수(신규 지정 7개 경로. 로그인은 제외 — 정책을
 올렸을 때 기존 회원이 자기 계정에 접근조차 못 하는 데드락을 막기 위함)
- 계정 잠금 시간 0 = 무한대(전용 컬럼 분리. timestamp 상한과 NULL 규약 때문에
 기존 컬럼 재사용이 불가능하다) + 관리자 수동 해제 경로
- 업로드 최대 크기·허용 확장자, 게시판 첨부 개수·댓글 깊이, 페이지 첨부 정책,
 장바구니 수량·구매 한도, 마일리지 사용 한도, 주문 부가세

파생 결함:
- 큐 Job(sync 드라이버)이 진행 중인 요청의 Request 바인딩을 덮어써, 뒤이어 실행되는
 훅 리스너가 헤더를 잃고 조용히 건너뛰었다. Job 이 원 바인딩을 복원하도록 고치고,
 전송 헤더가 필요한 리스너는 동기 실행으로 선언한다.
- 확장 업데이트 실패 시 상태만 되돌리고 상태 캐시를 비우지 않아, 그 확장의 관리자
 화면만 캐시 TTL(기본 하루) 동안 404 로 남았다. 실패 경로에도 무효화를 대칭으로
 두고, 빈 목록 자체를 캐시하지 않는다.
- 글 작성 시 첨부 파일이 Service 로 전달되지 않아 검증·권한은 통과하고 첨부만 사라졌다.
- 환경설정 저장 실패 안내가 내부 설정 키를 그대로 노출했다(105개 항목에 라벨 부여).

재발 방지:
- audit 룰 3종(레이아웃 경계 리터럴 / FormRequest 경계 불일치 / Service 재클램프)
- 테스트 실행 범위 강제 훅(check-test-scope)
- 트러블슈팅 사례 2건(큐 Job 요청 오염 / 확장 상태 캐시 고착)

공개 이슈: gnuboard/g7
This commit is contained in:
HeuJung committed 2026-07-30 07:52:24 +09:00
1 parent 5d140dfbe6
commit d17ea28da5
272 files changed
+12431 -1006

No files matched your search

+37 -14
View File
@@ -2,18 +2,17 @@
namespace App\Services;
use App\Contracts\Repositories\RoleRepositoryInterface;
use App\Contracts\Repositories\UserRepositoryInterface;
use App\Enums\UserStatus;
use App\Exceptions\CannotDeleteSuperAdminException;
use App\Extension\HookManager;
use App\Helpers\PermissionHelper;
use App\Models\ActivityLog;
use App\Helpers\TimezoneHelper;
use App\Models\Role;
use App\Models\ActivityLog;
use App\Models\User;
use Exception;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Laravel\Sanctum\PersonalAccessToken;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\DB;
@@ -24,6 +23,7 @@ class UserService
{
public function __construct(
private UserRepositoryInterface $userRepository,
private RoleRepositoryInterface $roleRepository,
private AttachmentService $attachmentService
) {}
@@ -79,7 +79,7 @@ class UserService
// 역할 할당 권한 체크: core.permissions.update 권한 없으면 기본 역할 자동 할당
if (! PermissionHelper::check('core.permissions.update')) {
$defaultRoleId = Role::where('identifier', 'user')->value('id');
$defaultRoleId = $this->roleRepository->findByIdentifier('user')?->id;
$roleIds = $defaultRoleId ? [$defaultRoleId] : null;
}
@@ -156,7 +156,7 @@ class UserService
// 자기잠금 방지: 마지막 admin 역할 사용자가 자기 admin 역할을 제거하려는 경우 차단
if ($roleIds !== null && $authUser && $authUser->id === $user->id) {
$adminRole = Role::where('identifier', 'admin')->first();
$adminRole = $this->roleRepository->findByIdentifier('admin');
if ($adminRole && $user->roles->contains('id', $adminRole->id) && ! in_array($adminRole->id, $roleIds)) {
// admin 역할을 가진 다른 사용자가 있는지 확인
$otherAdminCount = $adminRole->users()->where('users.id', '!=', $user->id)->count();
@@ -372,7 +372,7 @@ class UserService
*/
public function getUserByUuid(string $uuid): ?User
{
$user = User::where('uuid', $uuid)->first();
$user = $this->userRepository->findByUuid($uuid);
if ($user) {
HookManager::doAction('core.user.after_show', $user);
@@ -486,9 +486,9 @@ class UserService
/**
* 사용자의 활동 로그를 조회합니다.
*
* @param int $userId 사용자 ID
* @param int $limit 조회 건수
* @return \Illuminate\Support\Collection
* @param int $userId 사용자 ID
* @param int $limit 조회 건수
* @return \Illuminate\Support\Collection 활동 로그 요약 컬렉션
*/
public function getUserActivityLogs(int $userId, int $limit = 50): \Illuminate\Support\Collection
{
@@ -506,6 +506,31 @@ class UserService
]);
}
/**
* 사용자의 계정 잠금을 해제합니다 (관리자 수동 해제).
*
* 로그인 시도 추적 컬럼을 모두 초기화합니다. 영구 잠금(`locked_permanently`)도 함께
* 해제되며, 이 경로가 없으면 잠금 시간 0(무한대) 으로 잠긴 계정은 성공 로그인 자체가
* 불가하므로 DB 직접 조작 외에 복구 수단이 없습니다.
*
* @param User $user 잠금을 해제할 사용자
* @return User 갱신된 사용자 모델
*/
public function unlockAccount(User $user): User
{
HookManager::doAction('core.user.before_unlock', $user);
$this->userRepository->resetLoginAttempts($user);
$user = $user->fresh();
HookManager::doAction('core.auth.account_unlocked', $user, [
'ip_address' => request()->ip(),
]);
return $user;
}
/**
* 사용자의 마지막 로그인 시간을 현재 시간으로 업데이트합니다.
*
@@ -552,7 +577,7 @@ class UserService
$statusEnum = UserStatus::from($status);
// UUID → 정수 ID 변환 (내부 쿼리용)
$userIds = User::whereIn('uuid', $uuids)->pluck('id')->toArray();
$userIds = $this->userRepository->getIdsByUuids($uuids);
// DB 트랜잭션으로 일괄 업데이트
$updatedCount = DB::transaction(function () use ($userIds, $statusEnum) {
@@ -565,13 +590,11 @@ class UserService
UserStatus::Inactive => $updateData,
};
$count = User::whereIn('id', $userIds)->update($updateData);
$count = $this->userRepository->updateManyByIds($userIds, $updateData);
// Active 외 상태로 변경 시 해당 사용자들의 토큰 전체 삭제
if ($statusEnum !== UserStatus::Active) {
PersonalAccessToken::where('tokenable_type', User::class)
->whereIn('tokenable_id', $userIds)
->delete();
$this->userRepository->deleteTokensByUserIds($userIds);
}
return $count;