Files
sam-api/app/Swagger/v1/AuditLogApi.php
hskwon 785e367472 feat: 통합 감사 로그 도입 및 조회 API/스케줄러 추가
- DB: 감사 로그 테이블(audit_logs) 마이그레이션 및 인덱스 추가
- Config: audit.php 추가(AUDIT_RETENTION_DAYS, AUDIT_LOG_READS 토글)
- Model/Service: AuditLog 모델, AuditLogger 서비스 생성
- 도메인 훅: ModelVersion.release(released), BomTemplate upsert/update/delete/replaceItems/clone 기록, diff 조회는 설정 기반 기록
- API: GET /api/v1/design/audit-logs 추가(FormRequest/Service/Controller, 필터 page/size/target_type/target_id/action/actor_id/from/to/sort/order)
- Swagger: 감사 로그 조회 문서 추가(Design Audit 태그)
- Console: audit:prune 커맨드 추가 및 스케줄러 매일 03:10 실행 등록(시스템 크론 schedule:run 필요)
- Fix: PruneAuditLogs import 충돌 제거(Google ServiceControl AuditLog 제거)
2025-09-11 14:39:55 +09:00

55 lines
2.3 KiB
PHP

<?php
namespace App\Swagger\v1;
/**
* @OA\Tag(
* name="Design Audit",
* description="Design-time audit logs"
* )
*/
class AuditLogApi
{
/**
* @OA\Get(
* path="/api/v1/design/audit-logs",
* tags={"Design Audit"},
* summary="List audit logs",
* security={{"ApiKeyAuth": {}, "BearerAuth": {}}},
* @OA\Parameter(name="page", in="query", @OA\Schema(type="integer", minimum=1)),
* @OA\Parameter(name="size", in="query", @OA\Schema(type="integer", minimum=1, maximum=200)),
* @OA\Parameter(name="target_type", in="query", @OA\Schema(type="string")),
* @OA\Parameter(name="target_id", in="query", @OA\Schema(type="integer")),
* @OA\Parameter(name="action", in="query", @OA\Schema(type="string")),
* @OA\Parameter(name="actor_id", in="query", @OA\Schema(type="integer")),
* @OA\Parameter(name="from", in="query", @OA\Schema(type="string", format="date-time")),
* @OA\Parameter(name="to", in="query", @OA\Schema(type="string", format="date-time")),
* @OA\Response(
* response=200,
* description="List",
* @OA\JsonContent(
* type="object",
* @OA\Property(property="success", type="boolean"),
* @OA\Property(property="message", type="string"),
* @OA\Property(property="data", type="object",
* @OA\Property(property="current_page", type="integer"),
* @OA\Property(property="data", type="array", @OA\Items(type="object",
* @OA\Property(property="tenant_id", type="integer"),
* @OA\Property(property="target_type", type="string"),
* @OA\Property(property="target_id", type="integer", nullable=true),
* @OA\Property(property="action", type="string"),
* @OA\Property(property="before", type="object", nullable=true),
* @OA\Property(property="after", type="object", nullable=true),
* @OA\Property(property="actor_id", type="integer", nullable=true),
* @OA\Property(property="ip", type="string", nullable=true),
* @OA\Property(property="ua", type="string", nullable=true),
* @OA\Property(property="created_at", type="string", format="date-time")
* ))
* )
* )
* )
* )
*/
public function docs() {}
}