Files
michaelschiemer/src/Framework/Filesystem/FileScannerInterface.php
Michael Schiemer fc3d7e6357 feat(Production): Complete production deployment infrastructure
- Add comprehensive health check system with multiple endpoints
- Add Prometheus metrics endpoint
- Add production logging configurations (5 strategies)
- Add complete deployment documentation suite:
  * QUICKSTART.md - 30-minute deployment guide
  * DEPLOYMENT_CHECKLIST.md - Printable verification checklist
  * DEPLOYMENT_WORKFLOW.md - Complete deployment lifecycle
  * PRODUCTION_DEPLOYMENT.md - Comprehensive technical reference
  * production-logging.md - Logging configuration guide
  * ANSIBLE_DEPLOYMENT.md - Infrastructure as Code automation
  * README.md - Navigation hub
  * DEPLOYMENT_SUMMARY.md - Executive summary
- Add deployment scripts and automation
- Add DEPLOYMENT_PLAN.md - Concrete plan for immediate deployment
- Update README with production-ready features

All production infrastructure is now complete and ready for deployment.
2025-10-25 19:18:37 +02:00

46 lines
1.5 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Framework\Filesystem;
use App\Framework\Core\ValueObjects\Timestamp;
use App\Framework\Filesystem\ValueObjects\FileCollection;
use App\Framework\Filesystem\ValueObjects\FilePath;
use App\Framework\Filesystem\ValueObjects\FilePattern;
use Generator;
/**
* Interface for all FileScanner implementations
* Generic filesystem scanning interface with type-safe Value Objects
*/
interface FileScannerInterface
{
/**
* Find all files matching a pattern in a directory
*/
public function findFiles(FilePath $directoryPath, ?FilePattern $pattern = null): FileCollection;
/**
* Get the latest modification time of all files matching pattern
*/
public function getLatestModificationTime(FilePath $directoryPath, ?FilePattern $pattern = null): Timestamp;
/**
* Find files that have been modified since a given timestamp
*/
public function findFilesModifiedSince(FilePath $directoryPath, Timestamp $since, ?FilePattern $pattern = null): FileCollection;
/**
* Stream files one by one for memory-efficient processing
* @return Generator<File>
*/
public function streamFiles(FilePath $directoryPath, ?FilePattern $pattern = null): Generator;
/**
* Stream files in batches for balanced memory/performance
* @return Generator<FileCollection>
*/
public function streamFilesInBatches(FilePath $directoryPath, ?FilePattern $pattern = null, int $batchSize = 100): Generator;
}