horux-strategy-platform/backend/app/Services/Parsers/ParserInterface.php

<?php

namespace App\Services\Parsers;

interface ParserInterface
{
    /**
     * Parsea un archivo de balanza y retorna array de cuentas normalizadas
     *
     * @param string $filePath Ruta completa al archivo
     * @return array<int, array{
     *     codigo: string,
     *     nombre: string,
     *     nivel: int,
     *     saldo_inicial_deudor: float,
     *     saldo_inicial_acreedor: float,
     *     cargos: float,
     *     abonos: float,
     *     saldo_final_deudor: float,
     *     saldo_final_acreedor: float,
     *     es_cuenta_padre: bool
     * }>
     */
    public function parsear(string $filePath): array;

    /**
     * Verifica si este parser puede manejar el archivo
     *
     * @param string $filePath Ruta completa al archivo
     * @return bool
     */
    public function puedeManej(string $filePath): bool;

    /**
     * Retorna el identificador del sistema
     *
     * @return string
     */
    public function getSistema(): string;
}