<?php

namespace App\Console\Commands; // 定义命名空间

use App\Models\SiteCount; // 引入 SiteCount 模型
use App\Services\SiteCountService; // 引入 SiteCountService 服务
use Carbon\Carbon; // 引入 Carbon 日期处理库
use Illuminate\Console\Command; // 引入 Laravel 的 Command 基类
use Illuminate\Support\Facades\Cache; // 引入 Cache 门面（未使用，可以考虑移除）

/**
 * 统计站点数据控制台命令
 *
 * 该命令用于统计站点数据，执行时会将统计数据记录到前一天。
 */
class CountSite extends Command
{
    /**
     * 控制台命令的名称和签名
     *
     * @var string
     */
    protected $signature = 'moon:count-site'; // 定义命令的名称和签名

    /**
     * 控制台命令的描述
     *
     * @var string
     */
    protected $description = '统计数据，直接执行会统计到昨天'; // 描述该命令的用途

    /**
     * 创建一个新的命令实例.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct(); // 调用父类构造函数
    }

    /**
     * 执行控制台命令
     *
     * 该方法执行统计逻辑，统计前一天的数据并保存到数据库。
     *
     * @param SiteCountService $service 站点统计服务实例
     * @return mixed
     */
    public function handle(SiteCountService $service)
    {
        // 获取昨天的日期
        $date = Carbon::now()->subDay(1)->toDateString(); // 获取当前日期并减去一天

        /**
         * 防止一天运行多次，所以采用增加
         *
         * @var $site SiteCount
         */
        // 查找或创建一个新的 SiteCount 实例，基于日期
        $site = SiteCount::query()->firstOrNew(compact('date')); // 如果没有记录则创建新记录

        // 使用服务同步数据并保存
        $site = $service->syncByCache($site, true); // 同步数据，传入 $site 实例和强制更新标志
        $site->save(); // 保存统计数据到数据库

        // 记录系统日志
        createSystemLog('系统统计站点数据', $site->toArray()); // 记录操作日志，包含统计的数据
    }
}