README

michael-orenda/fiscal is a lightweight Laravel 12 package for managing fiscal years, fiscal periods, and date validation for financial systems. It is designed as a reusable module for accounting, microfinance, ERP, and SACCO applications.

This package focuses on:

• Generating fiscal years
• Generating fiscal periods (Monthly, Quarterly, 4-4-5, or fully custom)
• Opening, closing, and locking periods
• Validating dates against fiscal rules
• Providing clean API endpoints

Installation

composer require michael-orenda/fiscal

Configuration

php artisan vendor:publish --provider="MichaelOrenda\Fiscal\Providers\FiscalServiceProvider"

Database Migrations

Creates fiscal_years and fiscal_periods.

Usage Example

$fiscal = app(MichaelOrenda\Fiscal\Services\FiscalService::class);
$year = $fiscal->createYear('2025-01-01', 'monthly');

API Endpoints

• GET /api/orenda/fiscal/years
• POST /api/orenda/fiscal/years
• GET /api/orenda/fiscal/years/{id}
• POST /api/orenda/fiscal/periods/{id}/close
• POST /api/orenda/fiscal/periods/{id}/lock
• POST /api/orenda/fiscal/periods/{id}/open
• POST /api/orenda/fiscal/validate-date