📖 12주차 01강: 대화형 아티산(Artisan) 콘솔, 라라벨 프롬프트(Prompts) & 프로세스(Processes)

<?php

namespace App\Console\Commands;

use App\Models\Book;
use Illuminate\Console\Command;
use function Laravel\Prompts\search;
use function Laravel\Prompts\text;
use function Laravel\Prompts\confirm;
use function Laravel\Prompts\spin;
use function Laravel\Prompts\info;
use function Laravel\Prompts\table;
use function Laravel\Prompts\warning;

class RestockBookCommand extends Command
{
    /**
     * 콘솔 명령어 시그니처 (옵션 및 인자 지정 가능)
     */
    protected $signature = 'shop:restock {--all : 품절 도서 일괄 보충 모드}';

    /**
     * 콘솔 명령어 설명
     */
    protected $description = '대화형 프롬프트를 통해 도서 재고를 보충합니다.';

    /**
     * 명령어 실행 본문
     */
    public function handle(): int
    {
        info('📚 [지니샵 도서 재고 관리 콘솔 시스템]');

        // 1. 도서 검색 및 대화형 선택
        $bookId = search(
            label: '재고를 보충할 도서명을 검색하세요',
            placeholder: '예: 라라벨, 어린왕자...',
            options: fn (string $value) => strlen($value) > 0
                ? Book::where('title', 'like', "%{$value}%")
                    ->pluck('title', 'id')
                    ->all()
                : []
        );

        if (!$bookId) {
            warning('선택된 도서가 없습니다. 작업을 종료합니다.');
            return self::FAILURE;
        }

        $book = Book::findOrFail($bookId);
        info("선택된 도서: [{$book->title}] (현재 재고: {$book->stock}권)");

        // 2. 보충할 수량 입력 (실시간 유효성 검사)
        $quantity = text(
            label: '추가할 입고 수량을 입력하세요',
            placeholder: '10',
            required: true,
            validate: fn (string $value) => match (true) {
                !ctype_digit($value) => '수량은 숫자만 입력할 수 있습니다.',
                (int) $value <= 0 => '1권 이상 입력해야 합니다.',
                (int) $value > 1000 => '1회 최대 입고량은 1,000권입니다.',
                default => null,
            }
        );

        // 3. 최종 확인 컨펌
        $confirmed = confirm(
            label: "'{$book->title}' 도서에 {$quantity}권을 추가 입고하시겠습니까?",
            default: true
        );

        if (!$confirmed) {
            warning('입고 작업이 취소되었습니다.');
            return self::SUCCESS;
        }

        // 4. 로딩 스피너 연출 및 DB 반영
        $oldStock = $book->stock;

        spin(
            callback: function () use ($book, $quantity) {
                usleep(500000); // 0.5초 대기 (스피너 시각 효과)
                $book->increment('stock', (int) $quantity);
                if ($book->stock > 0 && $book->is_sold_out) {
                    $book->update(['is_sold_out' => false]);
                }
            },
            message: '서고 DB에 재고를 반영하고 있습니다...'
        );

        $book->refresh();

        // 5. 완료 결과 요약 표(Table) 출력
        info('✅ 재고 입고가 성공적으로 완료되었습니다!');
        
        table(
            headers: ['도서 ID', '도서명', '기존 재고', '입고 수량', '최종 재고', '품절 여부'],
            rows: [
                [
                    $book->id,
                    $book->title,
                    $oldStock . '권',
                    '+' . $quantity . '권',
                    $book->stock . '권',
                    $book->is_sold_out ? '품절' : '정상 판매'
                ]
            ]
        );

        return self::SUCCESS;
    }
}

use function Laravel\Prompts\progress;

$books = Book::where('stock', '<', 5)->get();

progress(
    label: '안전 재고 미달 도서 발주 목록 생성 중...',
    steps: $books,
    callback: function ($book, $progress) {
        // 입고 발주 전송 로직
        usleep(50000);
    }
);

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Process;

class CheckWarehouseStatusCommand extends Command
{
    protected $signature = 'shop:warehouse-status';
    protected $description = '물류 서버 스토리지 및 외부 프로세스 상태를 점검합니다.';

    public function handle(): int
    {
        $this->info('물류 시스템 외부 프로세스 진단 중...');

        // 1. 단일 동기 프로세스 실행 (타임아웃 10초)
        $result = Process::timeout(10)->run('git status --short');

        if ($result->successful()) {
            $this->info("Git 변경사항:\n" . ($result->output() ?: '깨끗함(Clean)'));
        } else {
            $this->error("명령어 실행 실패: " . $result->errorOutput());
        }

        // 2. 비동기 백그라운드 프로세스 풀(Pool) 동시 실행
        $pool = Process::pool(function ($pool) {
            $pool->as('disk')->run('df -h /');
            $pool->as('uptime')->run('uptime');
        })->start()->wait();

        $this->table(
            ['항목', '결과'],
            [
                ['디스크 용량', trim($pool['disk']->output())],
                ['서버 가동 시간', trim($pool['uptime']->output())],
            ]
        );

        return self::SUCCESS;
    }
}