<?php
// +----------------------------------------------------------------------
// | YwxApp [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Author: ywxapp<admin@ywxapp.cn>
// +----------------------------------------------------------------------

declare(strict_types=1);

namespace ywxapp\library;

use think\facade\Db;

/**
 * 管理员操作日志（backend_log）
 *
 * 表结构（install.sql 为事实源）：id / aid / action / ip / remark / create_at。
 * 字段很精简，用法约定：
 *  - action：`controller/action`（如 `admin/add`）或语义动作（如 `登录`）；
 *  - remark：可读摘要或 JSON 详情（如 `新增管理员：test`）；
 *  - aid   ：0 表示「未能确定操作人」（如登录失败）。
 *
 * 所有写入都吞异常：审计日志绝不能反过来阻断业务。
 *
 * @author ywxapp <admin@ywxapp.cn>
 */
class AdminLogger
{
    /**
     * 当前登录管理员 ID（后台容器 auth 为 AdminAuth）
     * @return int
     */
    public static function currentAid(): int
    {
        try {
            return (int) (app()->auth->info['id'] ?? 0);
        } catch (\Throwable $e) {
            return 0;
        }
    }

    /**
     * 写一条操作日志
     *
     * @param string $action 动作标识，如 admin/add
     * @param string $remark 摘要 / JSON 详情
     * @param int    $aid    操作人；0=自动取当前登录管理员
     * @return void
     */
    public static function write(string $action, string $remark = '', int $aid = 0): void
    {
        try {
            $aid = $aid > 0 ? $aid : self::currentAid();
            Db::name('backend_log')->insert([
                'aid'       => $aid,
                'action'    => mb_substr($action, 0, 100),
                'ip'        => mb_substr(self::ip(), 0, 50),
                'remark'    => mb_substr($remark, 0, 255),
                'create_at' => time(),
            ]);
        } catch (\Throwable $e) {
            // 日志写入失败不阻断业务
        }
    }

    /**
     * 登录审计（成功 / 失败都记，失败时 aid=0）
     *
     * @param string $account 账号
     * @param bool   $ok      是否成功
     * @param string $msg     失败原因（成功可留空）
     * @param int    $aid     成功后的管理员 ID
     * @return void
     */
    public static function login(string $account, bool $ok, string $msg = '', int $aid = 0): void
    {
        self::write(
            $ok ? '登录成功' : '登录失败',
            $ok ? ('账号：' . $account) : ('账号：' . $account . '，原因：' . $msg),
            $aid
        );
    }

    /**
     * 按天数清理旧日志
     *
     * @param int $days 保留最近 N 天；0=清空全部
     * @return int 删除条数
     */
    public static function clean(int $days): int
    {
        try {
            if ($days <= 0) {
                // 全表清空：用 TRUNCATE 更快，失败回落 delete
                return Db::name('backend_log')->delete(true);
            }
            return Db::name('backend_log')->where('create_at', '<', time() - $days * 86400)->delete();
        } catch (\Throwable $e) {
            return 0;
        }
    }

    /**
     * 客户端 IP
     * @return string
     */
    protected static function ip(): string
    {
        try {
            return (string) app()->request->ip();
        } catch (\Throwable $e) {
            return $_SERVER['REMOTE_ADDR'] ?? '';
        }
    }
}