/** Datei: plugins/projects/library/ARUNOX/Plugins/Projects/API/v1/Routes.php **/
<?php
	
	/**
	 * ARUNOX\Plugins\Projects\API\v1\Router
	 *
	 * Basisklasse für alle Controller in der API.
	 *
	 * @package         ARUNOX\API
	 *
	 * @author          Sparky <sparky@arunox.de>
	 * @copyright       2025 ARUNOX
	 * @version         1.1.0
	 *
	 * @since           1.0.0	File is created
	 */
	
	namespace ARUNOX\Plugins\Projects\API\v1;
	
	use ARUNOX\Core\Hooks;
	use ARUNOX\Core\Router;
	use ARUNOX\Plugins\REST;
	use ARUNOX\Plugins\Projects;
	
	class Routes {
		public static function register() : void {
			/* ###  MAIN ROUTES  ##############################	# */
			Router::addAll( Controller::class );
			
			/* ###  MENU ROUTES  ##############################	# */
			Hooks::add('router::get->api.v1.rest.routes',	function( $routes ) {
				$routes[] = [
					"path"			=> Controller::getRoute(),
					"label"			=> Controller::getLabelGroup(),
					"icon"			=> Controller::getIcon(),
					"menu"			=> "content",
				];
				
				return $routes;
			}, 50 );
			
			Hooks::add('router::get->api.v1.rest.routes', function( $routes ) {
				$routes[] = [
					"name"			=> "projects",
					"label"			=> Controller::getLabelGroup(),
					"menu"			=> "sidebar",
				];
				
				return $routes;
			}, 5 );
			
			Hooks::add('router::get->api.v1.rest.routes', function( $routes ) {
				$types = Projects\Types\Model::getAll([ "status_NOT" => Projects\Types\Status::Inactive ]);
				
				foreach( $types as $type ) {
					if( $steps = $type->steps ) {
						$routes[] = [
							"name"			=> $type->hashid,
							"path"			=> Controller::getRoute( $type->hashid ),
							"label"			=> $type->title,
							"icon"			=> Projects\Types\API\v1\Controller::getIcon(),
							"menu"			=> "projects",
						];
						
						foreach( $steps as $step ) {
							$projects = Projects\Model::getCount([ "step_id" => $step->id ]);
							
							$routes[] = [
								"name"			=> $step->hashid,
								"path"			=> Controller::getRoute( $type->hashid, $step->hashid ),
								"label"			=> $step->title,
								"icon"			=> $step->status->icon,
								"color"			=> [ "target" => "icon", "color" => $step->status->color ],
								"menu"			=> $type->hashid,
								"badge"			=> $projects ? $projects : FALSE,
							];
						}
					}
				}
				
				return $routes;
			});
		}
	}


/** Datei: plugins/projects/library/ARUNOX/Plugins/Projects/API/v1/Controller.php **/
<?php
	
	/**
	 * ARUNOX\Plugins\Projects\API\v1\Controller
	 *
	 * Basisklasse für alle Controller in der API.
	 *
	 * @package         ARUNOX\API
	 *
	 * @author          Sparky <sparky@arunox.de>
	 * @copyright       2025 ARUNOX
	 * @version         1.1.0
	 *
	 * @since           1.0.0	File is created
	 */
	
	namespace ARUNOX\Plugins\Projects\API\v1;
	
	use ARUNOX\HTTP;
	use ARUNOX\API\PHP;
	use ARUNOX\Core\Hooks;
	use ARUNOX\Plugins\Logs;
	use ARUNOX\Plugins\REST;
	use ARUNOX\Plugins\Projects;
	use ARUNOX\API\BaseController;
	use ARUNOX\Database\BaseEntity;
	
	#[PHP\Attributes\Controller\Label( "Projekt", "Projekte" )]
	#[PHP\Attributes\Controller\Icon( REST\Generator\Config\Icon::Folder )]
	#[PHP\Attributes\Controller\Route( "projects" )]
	
	#[PHP\Attributes\Database\Definitions\Model( Projects\Model::class )]
	
	class Controller extends BaseController {
		/* ###  PUBLIC GET FUNCTIONS  #####################################	# */
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/projects
		 * @route.description	Listet alle Logeinträge
		 */
		public static function getAllPrepared() : array {
			return parent::getAllPrepared();
		}
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/projects/ptyp_{origin}/projects
		 * @route.description	Listet alle Logeinträge
		 */
		public static function getAllByType( string $origin ) : array {
			return Projects\Model::getAll([ "type_id" => Projects\Types\Model::resolveHashId( "ptyp_{$origin}" ) ]);
		}
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/projects/ptstp_{origin}/projects
		 * @route.description	Listet alle Logeinträge
		 */
		public static function getAllByStep( string $origin ) : array {
			return Projects\Model::getAll([ "step_id" => Projects\Types\Steps\Model::resolveHashId( "ptstp_{$origin}" ) ]);
		}
		
		/**
		 * @api
		 * @method				GET
		 *
		 * @route.path			/projects/{hashid}
		 * @route.description	Gibt einen einzelnen Logeintrag anhand der ID zurück
		 */
		public static function getPrepared( string $hashid ) : BaseEntity | HTTP\Response {
			return parent::getPrepared( $hashid );
		}
		
		/* ###  PUBLIC SAVE FUNCTIONS  ####################################	# */
		
		/**
		 * @api
		 * @method				PUT
		 *
		 * @route.path			/projects/{hashid}
		 * @route.description	Speichert Änderungen an einem bestehenden Termin
		 */
		public static function savePrepared( string $hashid, array $data ) : HTTP\Response {
			return parent::savePrepared( $hashid, $data );
		}
		
		/**
		 * @api
		 * @method				POST
		 *
		 * @route.path			/projects
		 * @route.description	Erstellt einen neuen Kalender
		 */
		public static function createPrepared( array $data ) : HTTP\Response {
			return parent::createPrepared( $data );
		}
		
		/**
		 * @api
		 * @method				DELETE
		 *
		 * @route.path			/projects/{hashid}
		 * @route.description	Löscht ein Logeintrag anhand der ID
		 */
		public static function deletePrepared( string $hashid ) : HTTP\Response {
			return parent::deletePrepared( $hashid );
		}
		
		/**
		 * @api
		 * @method				PATCH
		 *
		 * @route.path			/projects/{hashid}/status
		 * @route.description	Wechselt den Status (aktiv/inaktiv) eines Kalenders
		 */
		public static function toggleStatusPrepared( string $hashid ) : HTTP\Response {
			return parent::toggleStatusPrepared( $hashid );
		}
		
		/* ###  PUBLIC VALIDATE FUNCTIONS  ################################	# */
		
		/* ###  PUBLIC REST RESPONSE FUNCTIONS  ###########################	# */
		
		/**
		 * @internal			rest
		 * @method				POST
		 *
		 * @route.path			/projects
		 * @route.description	REST-Antwort nach dem Erstellen eines Kalenders
		 */
		public static function restResponseCreate( array $data ) : HTTP\Response {
			$result	= static::createPrepared( $data );
			
			if( $result->isStatus( 200 ) ) {
				REST\Response::closeModals();
				REST\Response::redirect( "/projects/{$result->getBody("data", "hashid")}" );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				DELETE
		 *
		 * @route.path			/projects/{hashid}
		 * @route.description	REST-Antwort nach dem Löschen eines Logeintrag
		 */
		public static function restResponseDelete( string $hashid ) : HTTP\Response {
			REST\Response::closeModals();
			
			$result	= static::deletePrepared( $hashid );
			
			if( $result->isStatus( 200 ) ) {
				REST\Response::redirect( "/projects" );
			}
			
			return static::restResponse( $result );
		}
		
		/**
		 * @internal			rest
		 * @method				PATCH
		 *
		 * @route.path			/projects/{hashid}/status
		 * @route.description	REST-Antwort zur Status-Umschaltung eines Kalenders
		 */
		public static function restResponseToggleStatusPrepared( string $hashid ) : HTTP\Response {
			return parent::restResponseToggleStatusPrepared( $hashid );
		}
		
		/* ###  PUBLIC REST CONFIG FUNCTIONS  #############################	# */
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects
		 * @route.description	REST-Konfiguration für Logbuch-Tabelle
		 */
		public static function restConfigOverview() : REST\Generator\Base\BaseGenerator {
			$tabs = REST\Response::addWrapper( "details", static::getPlural() )
				->get()
					->addTab( "Übersicht", FALSE )->get()
						->setIcon( static::getIcon() )
						->addHeadline( static::getPlural(), 2 )
						->addContent(
							static::restConfigTable()
								->addButton(...Hooks::filter( "rest.generator::button.name->create", [], "projects" ))
						)
						->parent()
			;
			
			$types = Projects\Types\Model::getAll([ "status__NOT" => Projects\Types\Status::Inactive ]);
			
			foreach( $types as $type ) {
				$tabs->addCallable( [ Projects\Types\API\v1\Controller::class, "restConfigTab" ], $type );
			}
			
			return $tabs;
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects/ptyp_{hashid}
		 * @route.description	REST-Konfiguration für Detailansicht eines Logeintrags
		 */
		public static function restConfigOverviewByType( string $hashid ) : REST\Generator\Base\BaseGenerator {
			$type = Projects\Types\Model::resolveHashIDPrefix( "ptyp_{$hashid}" );
			
			$tabs = REST\Response::addWrapper( "details", $type->title )
				->addContent( Projects\API\v1\Controller::restConfigTable( $type->getHashId() ) )
			;
			
			return $tabs;
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects/ptyp_{hashid}/ptstp_{hashid}
		 * @route.description	REST-Konfiguration für Detailansicht eines Logeintrags
		 */
		public static function restConfigOverviewByStep( string $typeHashId, string $hashid ) : REST\Generator\Base\BaseGenerator {
			$step = Projects\Types\Steps\Model::resolveHashIDPrefix( "ptstp_{$hashid}" );
			
			$tabs = REST\Response::addWrapper( "overview", $step->title )
				->addContent( Projects\API\v1\Controller::restConfigTable( $step->getHashId() ) )
			;
			
			return $tabs;
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects/{hashid}
		 * @route.description	REST-Konfiguration für Detailansicht eines Logeintrags
		 */
		public static function restConfigDetails( string $hashid ) : REST\Generator\Base\BaseGenerator {
			return REST\Response::addWrapper( "details", static::getSingular( "%t bearbeiten" ) )
				->setBacklink( static::getRoute() )
				->get()
					->setApi( static::getRoute( $hashid ) )
					->setAction( static::getRoute( $hashid ), "PUT" )
					->addTab( static::getSingular() )->get()
						->setIcon( static::getIcon() )
						->addHeadline( static::getSingular(), 2 )
				
						->addField(...Hooks::filter( "rest.generator::control.type->text", [], "title", FALSE, "projects" ))
						->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "description", FALSE, "projects" ))
				
						->parent()
					
					->addCallable( [ Projects\Steps\API\v1\Controller::class, "restConfigTab" ], $hashid )
					->addCallable( [ Logs\API\v1\Controller::class, "restConfigTab" ], $hashid )
					
					->addTab( "Speichern" )->get()
						->setColor( REST\Generator\Config\Color::Primary )
						->setIcon( "bi bi-save" )
						->setType( "submit" );
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects/create
		 * @route.description	REST-Konfiguration für das Erstellen eines Kalenders (Formular)
		 */
		public static function restConfigCreatePrepared() : REST\Generator\Base\BaseGenerator {
			return parent::restConfigCreatePrepared();
		}
		
		/**
		 * @internal			rest
		 * @method				GET
		 *
		 * @route.path			/projects/{hashid}/delete
		 * @route.description	REST-Konfiguration für die Lösch-Bestätigung eines Logeintrags
		 */
		public static function restConfigDeletePrepared( string $hashid ) : REST\Generator\Base\BaseGenerator {
			return parent::restConfigDeletePrepared( $hashid );
		}
		
		/* ###  PUBLIC REST EXTENSION FUNCTIONS  ##########################	# */
		public static function restConfigTable( null|string $hashid = NULL ) : REST\Generator\Base\BaseGenerator {
			$rest = REST\Generator\Data\Table::create()
				->setApi( $hashid ? "projects/{$hashid}/projects" : "/projects" )
				->setAction( static::getRoute( "{hashid}" ) )
				->setOrder( "title", "asc" )
				->setSearch( TRUE )
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->status", [], "status", [], "projects", "hashid" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->icon", [
					"label"			=> Projects\Types\Steps\API\v1\Controller::getLabelGroup(),
					"icon"			=> Projects\Types\Steps\API\v1\Controller::getIcon(),
					"options"		=> Projects\Types\Steps\Model::getAsOptions("title"),
				], "step_id", [], "projects" ))
				
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "title", TRUE, TRUE, TRUE, "projects" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "target.name", TRUE, TRUE, TRUE, "projects" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->text", [], "notes", TRUE, TRUE, TRUE, "projects" ))
				->addColumn(...Hooks::filter( "rest.generator::column.type->datetime", [], "date_edit", TRUE, FALSE, TRUE, "projects" ))
			;
			
			return $rest;
		}
		
		public static function restConfigInputs() : array {
			$rest = REST\Generator\Data\Form::create()
				->addField(...Hooks::filter( "rest.generator::control.type->text", [], "target_hid", TRUE, "projects" ))
				->addField(...Hooks::filter( "rest.generator::control.type->text", [], "title", TRUE, "projects" ))
				->addField(...Hooks::filter( "rest.generator::control.type->textarea", [], "description", FALSE, "projects" ))
			;
			
			return $rest->top()->getChildren();
		}
	}