newznab-tmux/app/Models/UserActivityStat.php

<?php

declare(strict_types=1);

namespace App\Models;

use App\Services\UserStatsService;
use Carbon\Carbon;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\DB;

class UserActivityStat extends Model
{
    use HasFactory; // @phpstan-ignore missingType.generics

    protected $guarded = [];

    protected $casts = [
        'stat_date' => 'date',
    ];

    /**
     * Collect and store user activity stats for a specific date
     * This aggregates data from user_downloads and user_requests tables
     */
    public static function collectDailyStats(?string $date = null): void
    {
        $statDate = $date ? Carbon::parse($date)->format('Y-m-d') : Carbon::yesterday()->format('Y-m-d');

        // Count downloads for the date
        $downloadsCount = UserDownload::query()
            ->whereRaw('DATE(timestamp) = ?', [$statDate])
            ->count();

        // Count API hits for the date
        $apiHitsCount = UserRequest::query()
            ->whereRaw('DATE(timestamp) = ?', [$statDate])
            ->count();

        // Store or update the stats
        self::updateOrCreate(
            ['stat_date' => $statDate],
            [
                'downloads_count' => $downloadsCount,
                'api_hits_count' => $apiHitsCount,
            ]
        );
    }

    /**
     * Get download stats for the last N days
     *
     * @return array<string, mixed>
     */
    public static function getDownloadsPerDay(int $days = 30): array
    {
        $startDate = Carbon::now()->subDays($days - 1)->format('Y-m-d');

        $stats = self::query()
            ->select('stat_date', 'downloads_count')
            ->where('stat_date', '>=', $startDate)
            ->orderBy('stat_date', 'asc')
            ->get()
            ->keyBy('stat_date');

        // Fill in missing days with zero counts
        $result = [];
        for ($i = $days - 1; $i >= 0; $i--) {
            $date = Carbon::now()->subDays($i)->format('Y-m-d');
            $stat = $stats->get($date);
            $result[] = [
                'date' => Carbon::parse($date)->format('M d'),
                'count' => $stat ? $stat->downloads_count : 0,
            ];
        }

        return $result;
    }

    /**
     * Get API hits stats for the last N days
     *
     * @return list<array<string, int|string>>
     */
    public static function getApiHitsPerDay(int $days = 30): array
    {
        $startDate = Carbon::now()->subDays($days - 1)->format('Y-m-d');

        $stats = self::query()
            ->select('stat_date', 'api_hits_count')
            ->where('stat_date', '>=', $startDate)
            ->orderBy('stat_date', 'asc')
            ->get()
            ->keyBy('stat_date');

        // Fill in missing days with zero counts
        $result = [];
        for ($i = $days - 1; $i >= 0; $i--) {
            $date = Carbon::now()->subDays($i)->format('Y-m-d');
            $stat = $stats->get($date);
            $result[] = [
                'date' => Carbon::parse($date)->format('M d'),
                'count' => $stat ? $stat->api_hits_count : 0,
            ];
        }

        return $result;
    }

    /**
     * Get total downloads across the last N days inclusive of today.
     *
     * Sums closed days from `user_activity_stats` and today's closed hours
     * from `user_activity_stats_hourly`. The current in-progress hour is not
     * included here — callers needing live "today" totals should use
     * {@see UserStatsService::getSummaryStats()} which layers
     * the live tables on top.
     */
    public static function getTotalDownloads(int $days = 7): int
    {
        return self::sumLastNDays($days, 'downloads_count');
    }

    /**
     * Get total API hits across the last N days inclusive of today.
     *
     * @see self::getTotalDownloads() for source-layering notes.
     */
    public static function getTotalApiHits(int $days = 7): int
    {
        return self::sumLastNDays($days, 'api_hits_count');
    }

    private static function sumLastNDays(int $days, string $column): int
    {
        $today = Carbon::now()->startOfDay();
        $weekStart = Carbon::now()->subDays($days - 1)->startOfDay();

        $closedDays = (int) self::query()
            ->where('stat_date', '>=', $weekStart->format('Y-m-d'))
            ->where('stat_date', '<', $today->format('Y-m-d'))
            ->sum($column);

        $todayClosedHours = (int) DB::table('user_activity_stats_hourly')
            ->where('stat_hour', '>=', $today->format('Y-m-d H:00:00'))
            ->where('stat_hour', '<', Carbon::now()->startOfHour()->format('Y-m-d H:00:00'))
            ->sum($column);

        return $closedDays + $todayClosedHours;
    }

    /**
     * Cleanup old stats (keep last N days)
     */
    public static function cleanupOldStats(int $keepDays = 90): int
    {
        $cutoffDate = Carbon::now()->subDays($keepDays)->format('Y-m-d');

        return self::query()
            ->where('stat_date', '<', $cutoffDate)
            ->delete();
    }

    /**
     * Collect and store hourly user activity stats for a specific hour
     * This aggregates data from user_downloads and user_requests tables
     */
    public static function collectHourlyStats(?string $hour = null): void
    {
        $statHour = $hour ? Carbon::parse($hour)->format('Y-m-d H:00:00') : Carbon::now()->subHour()->startOfHour()->format('Y-m-d H:00:00');

        // Count downloads for the hour
        $downloadsCount = UserDownload::query()
            ->where('timestamp', '>=', $statHour)
            ->where('timestamp', '<', Carbon::parse($statHour)->addHour()->format('Y-m-d H:00:00'))
            ->count();

        // Count API hits for the hour
        $apiHitsCount = UserRequest::query()
            ->where('timestamp', '>=', $statHour)
            ->where('timestamp', '<', Carbon::parse($statHour)->addHour()->format('Y-m-d H:00:00'))
            ->count();

        // Store in hourly stats table
        DB::table('user_activity_stats_hourly')->updateOrInsert(
            ['stat_hour' => $statHour],
            [
                'downloads_count' => $downloadsCount,
                'api_hits_count' => $apiHitsCount,
                'updated_at' => now(),
                'created_at' => DB::raw('COALESCE(created_at, NOW())'),
            ]
        );
    }

    /**
     * Get download stats per hour for the last N hours
     *
     * @return array<string, mixed>
     */
    public static function getDownloadsPerHour(int $hours = 168): array
    {
        $startHour = Carbon::now()->subHours($hours - 1)->startOfHour()->format('Y-m-d H:00:00');

        $stats = DB::table('user_activity_stats_hourly')
            ->select('stat_hour', 'downloads_count')
            ->where('stat_hour', '>=', $startHour)
            ->orderBy('stat_hour', 'asc')
            ->get()
            ->keyBy('stat_hour');

        // Fill in missing hours with zero counts
        $result = [];
        for ($i = $hours - 1; $i >= 0; $i--) {
            $time = Carbon::now()->subHours($i)->startOfHour();
            $hourKey = $time->format('Y-m-d H:00:00');
            $stat = $stats->get($hourKey);

            // Format label based on how recent the hour is
            $now = Carbon::now();
            if ($time->isToday()) {
                $label = $time->format('H:i');
            } elseif ($time->isYesterday()) {
                $label = 'Yesterday '.$time->format('H:i');
            } elseif ($time->diffInDays($now) < 7) {
                $label = $time->format('D H:i');
            } else {
                $label = $time->format('M d H:i');
            }

            $result[] = [
                'time' => $label,
                'count' => $stat ? $stat->downloads_count : 0,
            ];
        }

        return $result;
    }

    /**
     * Get API hits stats per hour for the last N hours
     *
     * @return list<array<string, mixed>>
     */
    public static function getApiHitsPerHour(int $hours = 168): array
    {
        $startHour = Carbon::now()->subHours($hours - 1)->startOfHour()->format('Y-m-d H:00:00');

        $stats = DB::table('user_activity_stats_hourly')
            ->select('stat_hour', 'api_hits_count')
            ->where('stat_hour', '>=', $startHour)
            ->orderBy('stat_hour', 'asc')
            ->get()
            ->keyBy('stat_hour');

        // Fill in missing hours with zero counts
        $result = [];
        for ($i = $hours - 1; $i >= 0; $i--) {
            $time = Carbon::now()->subHours($i)->startOfHour();
            $hourKey = $time->format('Y-m-d H:00:00');
            $stat = $stats->get($hourKey);

            // Format label based on how recent the hour is
            $now = Carbon::now();
            if ($time->isToday()) {
                $label = $time->format('H:i');
            } elseif ($time->isYesterday()) {
                $label = 'Yesterday '.$time->format('H:i');
            } elseif ($time->diffInDays($now) < 7) {
                $label = $time->format('D H:i');
            } else {
                $label = $time->format('M d H:i');
            }

            $result[] = [
                'time' => $label,
                'count' => $stat ? $stat->api_hits_count : 0,
            ];
        }

        return $result;
    }

    /**
     * Cleanup old hourly stats (keep last N days)
     */
    public static function cleanupOldHourlyStats(int $keepDays = 30): int
    {
        $cutoffHour = Carbon::now()->subDays($keepDays)->startOfHour()->format('Y-m-d H:00:00');

        return DB::table('user_activity_stats_hourly')
            ->where('stat_hour', '<', $cutoffHour)
            ->delete();
    }
}