<?php
/**
 * Customer stats module.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Modules\CustomerStats;

use Rahkar\WP\Contracts\HasSettings;
use Rahkar\WP\Customers\Stats;
use Rahkar\WP\Customers\StatsFill;
use Rahkar\WP\Customers\StatsWatcher;
use Rahkar\WP\Modules\BaseModule;
use Rahkar\WP\Plugin;
use Rahkar\WP\Support\Hooks;
use Rahkar\WP\Support\Settings;

defined( 'ABSPATH' ) || exit;

/**
 * Each customer's order count, purchase days and personal buying cycle, kept in
 * the plugin's own tables (Customers\Stats) for the modules that time a message
 * by them: second purchase, win-back, replenishment.
 *
 * Free, because the core's send rules use it too: a customer who bought in the
 * last week does not enter a new promotional flow.
 *
 * Cost on a page view: none. The hooks fire only when an order is saved, and the
 * work waits for `shutdown`.
 */
final class CustomerStatsModule extends BaseModule implements HasSettings {

	// Spelled out: reading Stats::SLUG would load that class on every request.
	public const SLUG = 'customer_stats';

	/**
	 * {@inheritDoc}
	 */
	public function slug(): string {
		return self::SLUG;
	}

	/**
	 * {@inheritDoc}
	 */
	public function name(): string {
		return __( 'شاخص‌های مشتری', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function description(): string {
		return __( 'برای هر مشتری شمار خرید، روزهای خرید و چرخه‌ی خرید شخصی‌اش را نگه می‌دارد، با همان حسابی که داشبورد راهکار فروش می‌کند. ماژول‌های خرید دوم، بازگشت مشتری و یادآور خرید مجدد پیامشان را با همین عددها زمان‌بندی می‌کنند، و قاعده‌ی «خرید تازه» هم به آن نیاز دارد.', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function defaults(): array {
		return [
			'sale_statuses' => Stats::DEFAULT_SALE_STATUSES,
		];
	}

	/**
	 * {@inheritDoc}
	 */
	public function settingsSchema(): array {
		return [
			'sale_statuses' => [
				'type'    => 'text',
				'label'   => __( 'وضعیت‌های فروش', 'rahkar-toolkit' ),
				'help'    => __( 'سفارشی که یکی از این وضعیت‌ها را دارد خرید شمرده می‌شود. با ویرگول جدا کنید، بی پیشوند wc-. باید با «وضعیت‌های فروش» داشبورد راهکار فروش یکی باشد؛ داشبورد اگر نباشد هشدار می‌دهد. عوض کردنش همه‌ی شاخص‌ها را از نو می‌سازد.', 'rahkar-toolkit' ),
				'default' => Stats::DEFAULT_SALE_STATUSES,
				'section' => 'general',
			],
		];
	}

	/**
	 * {@inheritDoc}
	 */
	public function settingsSections(): array {
		return [ 'general' => __( 'عمومی', 'rahkar-toolkit' ) ];
	}

	/**
	 * {@inheritDoc}
	 */
	public function register(): void {
		add_action( Hooks::CUSTOMER_STATS_FILL, static fn() => Plugin::make( StatsFill::class )->run() );

		// The first fill starts on its own, after any queue run, so a store that
		// switched the module on and never opened a screen still gets one.
		add_action( 'rahkar_wp_queue_ran', static fn() => StatsFill::ensure() );

		// Other sale statuses change which orders count: every row starts over.
		add_action(
			'update_option_' . Settings::PREFIX . self::SLUG,
			static function ( $old, $new ): void {
				$before = is_array( $old ) ? (string) ( $old['sale_statuses'] ?? '' ) : '';
				$after  = is_array( $new ) ? (string) ( $new['sale_statuses'] ?? '' ) : '';

				if ( $before !== $after ) {
					StatsFill::restart();
				}
			},
			10,
			2
		);

		add_action( 'woocommerce_after_order_object_save', static fn( $order ) => Plugin::make( StatsWatcher::class )->saved( $order ), 30 );
		add_action( 'woocommerce_after_order_refund_object_save', static fn( $refund ) => Plugin::make( StatsWatcher::class )->saved( $refund ), 30 );
		add_action( 'woocommerce_trash_order', static fn( $id ) => Plugin::make( StatsWatcher::class )->changed( $id ), 30 );
		add_action( 'woocommerce_delete_order', static fn( $id ) => Plugin::make( StatsWatcher::class )->changed( $id ), 30 );
		add_action( 'woocommerce_untrash_order', static fn( $id ) => Plugin::make( StatsWatcher::class )->changed( $id ), 30 );
	}
}