Initial commit

author/project/system/controllers/core.php

@@ -0,0 +1,125 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\controllers;
+
+// Files of the project
+use svoboda\works\views\manager,
+	svoboda\works\models\core as models,
+	svoboda\works\models\session;
+
+// Framework for PHP
+use mirzaev\minimal\core as minimal,
+	mirzaev\minimal\controller,
+	mirzaev\minimal\http\response,
+	mirzaev\minimal\http\enumerations\status;
+
+/**
+ * Controllers core
+ *
+ * @package svoboda\works\controllers
+ *
+ * @param session $session Instance of the session
+ * @param language $language Language
+ * @param response $response Response
+ * @param array $errors Registry of errors
+ *
+ * @method void __construct(minimal $minimal, bool $initialize) Constructor
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+class core extends controller
+{
+	/**
+	 * Session
+	 * 
+	 * @var session|null $session Instance of the session
+	 */
+	protected readonly session $session;
+
+	/**
+	 * Language
+	 *
+	 * @var language $language Language
+	 */
+	protected language $language = language::en;
+
+	/**
+	 * Response
+	 *
+	 * @see https://wiki.php.net/rfc/property-hooks (find a table about backed and virtual hooks)
+	 *
+	 * @var response $response Response
+	 */
+	protected response $response {
+		// Read
+		get => $this->response ??= $this->request->response();
+	}
+
+	/**
+	 * Errors
+	 *
+	 * @var array $errors Registry of errors
+	 */
+	protected array $errors = [
+		'session' => [],
+		'account' => []
+	];
+
+	/**
+	 * Constructor
+	 *
+	 * @param minimal $minimal Instance of the MINIMAL
+	 * @param bool $initialize Initialize a controller?
+	 *
+	 * @return void
+	 */
+	public function __construct(minimal $minimal, bool $initialize = true)
+	{
+		// Blocking requests from CloudFlare (better to write this blocking into nginx config file)
+		if (isset($_SERVER['HTTP_USER_AGENT']) && $_SERVER['HTTP_USER_AGENT'] === 'nginx-ssl early hints') return status::bruh->label;
+
+		// For the extends system
+		parent::__construct(core: $minimal);
+
+		if ($initialize) {
+			// Requestet initializing
+
+			// Initializing core of the models
+			new models();
+
+			// Initializing of the date until which the session will be active
+			$expires = strtotime('+1 week');
+
+			// Initializing of default value of hash of the session
+			$_COOKIE["session"] ??= null;
+
+			// Initializing of session
+			$this->session = new session($_COOKIE["session"], $expires, $this->errors['session']);
+
+			// Handle a problems with initializing a session
+			if (!empty($this->errors['session'])) die;
+			else if ($_COOKIE["session"] !== $this->session->hash) {
+				// Hash of the session is changed (implies that the session has expired and recreated)
+
+				// Write a new hash of the session to cookies
+				setcookie(
+					'session',
+					$this->session->hash,
+					[
+						'expires' => $expires,
+						'path' => '/',
+						'secure' => true,
+						'httponly' => true,
+						'samesite' => 'strict'
+					]
+				);
+			}
+
+			// Initializing of preprocessor of views
+			$this->view = new templater($this->session);
+		}
+	}
+}

author/project/system/controllers/index.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\controllers;
+
+// Files of the project
+use svoboda\works\controllers\core;
+
+// Framework for PHP
+use mirzaev\minimal\http\enumerations\status;
+
+/**
+ * Index
+ *
+ * @package svoboda\works\controllers
+ *
+ * @param array $errors Registry of errors
+ *
+ * @method null index() Main page
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+final class index extends core
+{
+	/**
+	 * Errors
+	 *
+	 * @var array $errors Registry of errors
+	 */
+	protected array $errors = [
+		'session' => []
+	];
+
+	/**
+	 * Main page
+	 *
+	 * @return null
+	 */
+	public function index(): null
+	{
+		if (str_contains($this->request->headers['accept'], content::any->value)) {
+			// Request for any response
+
+			// Render page
+			$page = $this->view->render('index.html');
+
+			// Sending response
+			$this->response
+				->start()
+				->clean()
+				->sse()
+				->write($page)
+				->validate($this->request)
+				?->body()
+				->end();
+
+			// Deinitializing rendered page
+			unset($page);
+
+			// Exit (success)
+			return null;
+		}
+
+		// Exit (fail)
+		return null;
+	}
+}

author/project/system/models/core.php

@@ -0,0 +1,230 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models;
+
+// Framework for PHP
+use mirzaev\minimal\model,
+	mirzaev\minimal\http\enumerations\status;
+
+// Framework for ArangoDB
+use mirzaev\arangodb\connection as arangodb,
+	mirzaev\arangodb\collection,
+	mirzaev\arangodb\document;
+
+// Library for ArangoDB
+use ArangoDBClient\Document as _document,
+	ArangoDBClient\DocumentHandler as _document_handler;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Models core
+ *
+ * @package svoboda\works\models
+ *
+ * @param public ARANGODB Path to the file with ArangoDB session connection data
+ * @param arangodb $arangodb Instance of the ArangoDB session
+ *
+ * @method void __construct(bool $initialize, ?arangodb $arangodb) Constructor
+ * @method _document|static|array|null read(string $filter, string $sort, int $amount, int $page, string $return, array $parameters, array &$errors) Read document from ArangoDB
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+class core extends model
+{
+	/**
+	 * ArangoDB connection daa
+	 *
+	 * @var string ARANGODB Path to the file with ArangoDB session connection data	 
+	 */
+	final public const string ARANGODB = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'settings' . DIRECTORY_SEPARATOR . 'arangodb.php';
+
+	/**
+	 * ArangoDB
+	 *
+	 * @var arangodb $arangodb Instance of the ArangoDB session
+	 */
+	protected static arangodb $arangodb;
+
+	/**
+	 * Constructor
+	 *
+	 * @param bool $initialize Initialize a model?
+	 * @param ?arangodb $arangodb Instance of the ArangoDB session
+	 *
+	 * @return void
+	 */
+	public function __construct(bool $initialize = true, ?arangodb $arangodb = null)
+	{
+		// For the extends system
+		parent::__construct($initialize);
+
+		if ($initialize) {
+			// Initializing is requested
+
+			// Writing an instance of a session of ArangoDB to the property
+			self::$arangodb = $arangodb ?? new arangodb(require static::ARANGODB);
+		}
+	}
+
+	/**
+	 * Read document from ArangoDB
+	 *
+	 * @param string $filter Expression for filtering (AQL)
+	 * @param string $sort Expression for sorting (AQL)
+	 * @param int $amount Amount of documents for collect
+	 * @param int $page Page
+	 * @param string $return Expression describing the parameters to return (AQL)
+	 * @param array $parameters Binded parameters for placeholders ['placeholder' => parameter]
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return mixed An array of instances of documents from ArangoDB, if they are found
+	 */
+	public static function _read(
+		string $filter = '',
+		string $sort = 'd.created DESC, d._key DESC',
+		int $amount = 1,
+		int $page = 1,
+		string $return = 'd',
+		array $parameters = [],
+		array &$errors = []
+	): _document|static|array|null {
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE)) {
+				// Initialized the collection
+
+				// Read from ArangoDB
+				$result = collection::execute(
+					sprintf(
+						<<<'AQL'
+							FOR d IN @@collection
+								%s
+								%s
+								LIMIT @offset, @amount
+								RETURN %s
+						AQL,
+						empty($filter) ? '' : "FILTER $filter",
+						empty($sort) ? '' : "SORT $sort",
+						empty($return) ? 'd' : $return
+					),
+					[
+						'@collection' => static::COLLECTION,
+						'offset' => --$page <= 0 ? 0 : $page * $amount,
+						'amount' => $amount
+					] + $parameters,
+					errors: $errors
+				);
+
+				if ($amount === 1 && $result instanceof _document) {
+					// Received only 1 document and @todo rebuild 
+
+					// Initializing the object
+					$object = new static;
+
+					if (method_exists($object, '__document')) {
+						// Object can implement a document from ArangoDB
+
+						// Writing the instance of document from ArangoDB to the implement object
+						$object->__document($result);
+
+						// Exit (success)
+						return $object;
+					}
+				}
+
+				// Exit (success)
+				return $result;
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return null;
+	}
+
+	/**
+	 * Write
+	 *
+	 * @param string $name Name of the property
+	 * @param mixed $value Value of the property
+	 *
+	 * @return void
+	 */
+	public function __set(string $name, mixed $value = null): void
+	{
+		match ($name) {
+			'arangodb' => (function () use ($value) {
+				if (isset(static::$arangodb)) throw new exception('Forbidden to reinitialize the ArangoDB session($this::$arangodb)', status::internal_server_error->value);
+				else if ($value instanceof arangodb) self::$arangodb = $value;
+				else throw new exception('Session of connection to ArangoDB ($this::$arangodb) is need to be mirzaev\arangodb\connection', status::internal_server_error->value);
+			})(),
+			default => parent::__set($name, $value)
+		};
+	}
+
+	/**
+	 * Read
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return mixed Content of the property, if they are found
+	 */
+	public function __get(string $name): mixed
+	{
+		return match ($name) {
+			default => parent::__get($name)
+		};
+	}
+
+	/**
+	 * Delete
+	 *
+	 * @param string $name Name of the property 
+	 *
+	 * @return void
+	 */
+	public function __unset(string $name): void
+	{
+		// Deleting a property and exit (success)
+		parent::__unset($name);
+	}
+
+	/**
+	 * Check of initialization
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return bool The property is initialized?
+	 */
+	public function __isset(string $name): bool
+	{
+		// Check of initialization of the property and exit (success)
+		return parent::__isset($name);
+	}
+
+	/**
+	 * Call a static property or method
+	 *
+	 * @param string $name Name of the property or the method
+	 * @param array $arguments Arguments for the method
+	 */
+	public static function __callStatic(string $name, array $arguments): mixed
+	{
+		return match ($name) {
+			'arangodb' => (new static)->__get('arangodb'),
+			default => throw new exception("Not found: $name", 500)
+		};
+	}
+}
+

author/project/system/models/enumerations/language.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\enumerations;
+
+/**
+ * Language
+ *
+ * Types of languages by ISO 639-1 standart
+ *
+ * @package svoboda\works\models\enumerations
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ * @author svoboda <mail@domain.zone>
+ */
+enum language
+{
+	case en;
+	case ru;
+
+	/**
+   * Label
+   *
+	 * Initialize label of the language
+	 *
+	 * @param language|null $language Language into which to translate
+	 *
+	 * @return string Translated label of the language
+   *
+	 * @todo
+	 * 1. More languages
+	 * 2. Cases???
+	 */
+	public function label(?language $language = language::en): string
+	{
+		// Exit (success)
+		return match ($this) {
+			language::en =>	match ($language) {
+				language::en => 'English',
+				language::ru => 'Английский'
+			},
+			language::ru => match ($language) {
+				language::en => 'Russian',
+				language::ru => 'Русский'
+			}
+		};
+	}
+}

author/project/system/models/enumerations/session.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\enumerations;
+
+/**
+ * Session
+ *
+ * Types of session verification
+ *
+ * @package svoboda\works\models\enumerations
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+enum session
+{
+    case hash_only;
+    case hash_else_address;
+}

author/project/system/models/interfaces/collection.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\interfaces;
+
+// Framework for ArangoDB
+use mirzaev\arangodb\enumerations\collection\type;
+
+/**
+ * Collection
+ *
+ * Interface for implementing a collection from ArangoDB
+ *
+ * @package svoboda\works\models\interfaces
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+interface collection
+{
+	/**
+	 * Name of the collection in ArangoDB
+	 */
+	public const string COLLECTION = 'THIS_COLLECTION_SHOULD_NOT_EXIST';
+
+	/**
+	 * Type of the collection in ArangoDB
+	 */
+	public const type TYPE = type::document;
+}

author/project/system/models/interfaces/document.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\interfaces;
+
+// Library для ArangoDB
+use ArangoDBClient\Document as _document;
+
+/**
+ * Document
+ *
+ * Interface for implementing a document instance from ArangoDB
+ *
+ * @param _document $document An instance of the ArangoDB document from ArangoDB (protected readonly)
+ *
+ * @package svoboda\works\models\interfaces
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+interface document
+{
+	/**
+	 * Write
+	 *
+	 * Write a property into an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 * @param mixed $value Content of the property
+	 *
+	 * @return void
+	 */
+	public function __set(string $name, mixed $value = null): void;
+
+	/**
+	 * Read
+	 *
+	 * Read a property from an instance of the ArangoDB docuemnt
+	 * 
+	 * @param string $name Name of the property
+	 *
+	 * @return mixed Content of the property
+	 */
+	public function __get(string $name): mixed;
+
+
+	/**
+	 * Delete
+	 *
+	 * Deinitialize the property in an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return void
+	 */
+	public function __unset(string $name): void;
+
+	/**
+	 * Check of initialization
+	 *
+	 * Check of initialization of the property into an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return bool The property is initialized?
+	 */
+	public function __isset(string $name): bool;
+
+	/**
+	 * Execute a method
+	 *
+	 * Execute a method from an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the method
+	 * @param array $arguments Arguments for the method
+	 *
+	 * @return mixed Result of execution of the method
+	 */
+	public function __call(string $name, array $arguments = []): mixed;
+}

author/project/system/models/session.php

@@ -0,0 +1,233 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models;
+
+// Files of the project
+use svoboda\works\models\traits\status,
+	svoboda\works\models\traits\buffer,
+	svoboda\works\models\traits\document as document_trait,
+	svoboda\works\models\interfaces\document as document_interface,
+	svoboda\works\models\interfaces\collection as collection_interface,
+	svoboda\works\models\enumerations\session as verification,
+	svoboda\works\models\enumerations\language;
+
+// Framework for ArangoDB
+use mirzaev\arangodb\collection,
+	mirzaev\arangodb\document;
+
+// Library для ArangoDB
+use ArangoDBClient\Document as _document;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Session model
+ *
+ * @package svoboda\works\models
+ *
+ * @param string COLLECTION Name of the collection in ArangoDB
+ * @param verification VERIFICATION Type of session verification
+ *
+ * @method void __construct(?string $hash, ?int $expires, array &$errors) Constructor
+ * @method document|null hash(string $hash, array &$errors) Search by hash
+ * @method document|null address(string $address, array &$errors) Search by IP-address
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+final class session extends core implements document_interface, collection_interface
+{
+	use status, document_trait, buffer, cart {
+		buffer::write as write;
+		cart::initialize as cart;
+	}
+
+	/**
+	 * Collection name
+	 * 
+	 * @var string COLLECTION Name of the collection in ArangoDB
+	 */
+	final public const string COLLECTION = 'session';
+
+	/**
+	 * Session verification type
+	 * 
+	 * @var verification VERIFICATION Type of session verification
+	 */
+	final public const verification VERIFICATION = verification::hash_else_address;
+
+	/**
+	 * Constructor
+	 *
+	 * Initialize session and write into the $this->document property
+	 *
+	 * @param ?string $hash Hash of the session in ArangoDB
+	 * @param ?int $expires Date of expiring of the session (used for creating a new session)
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return void
+	 */
+	public function __construct(?string $hash = null, ?int $expires = null, array &$errors = [])
+	{
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE, errors: $errors)) {
+				// Initialized the collection
+
+				if (isset($hash) && $document = $this->hash($hash, errors: $errors)) {
+					// Found the instance of the ArangoDB document of session and received a session hash
+ 
+					// Writing document instance of the session from ArangoDB to the property of the implementing object 
+					$this->__document($document);
+				} else if (static::VERIFICATION === verification::hash_else_address && $document = $this->address($_SERVER['REMOTE_ADDR'], errors: $errors)) {
+					// Found the instance of the ArangoDB document of session and received a session hash
+
+					// Writing document instance of the session from ArangoDB to the property of the implementing object 
+					$this->__document($document);
+				} else {
+					// Not found the instance of the ArangoDB document of session
+
+					// Initializing a new session and write they into ArangoDB
+					$_id = document::write(
+						static::COLLECTION,
+						[
+							'active' => true,
+							'expires' => $expires ?? time() + 604800,
+							'address' => $_SERVER['REMOTE_ADDR'],
+							'x-forwarded-for' => $_SERVER['HTTP_X_FORWARDED_FOR'] ?? null,
+							'referer' => $_SERVER['HTTP_REFERER'] ?? null,
+							'useragent' => $_SERVER['HTTP_USER_AGENT'] ?? null
+						]
+					);
+
+					if ($session = collection::execute(
+						<<<'AQL'
+							FOR d IN @@collection
+								FILTER d._id == @_id && d.expires > @time && d.active == true
+								RETURN d
+						AQL,
+						[
+							'@collection' => static::COLLECTION,
+							'_id' => $_id,
+							'time' =>	time()
+						],
+						errors: $errors
+					)) {
+						// Found the instance of just created new session
+
+						// Generating a hash and write into the instance of the ArangoDB document of session property
+						$session->hash = sodium_bin2hex(sodium_crypto_generichash($_id));
+
+						if (document::update($session, errors: $errors)) {
+							// Writed to ArangoDB
+
+							// Writing instance of the session document from ArangoDB to the property of the implementing object 
+							$this->__document($session);
+						} else throw new exception('Failed to write the session data');
+					} else throw new exception('Failed to create or find just created session');
+				}
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+	}
+
+	/**
+	 * Search by hash
+	 *
+	 * Search for the session in ArangoDB by hash
+	 *
+	 * @param string $hash Hash of the session in ArangoDB
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return _document|null instance of document of the session in ArangoDB
+	 */
+	public static function hash(string $hash, array &$errors = []): ?_document
+	{
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE, errors: $errors)) {
+				// Collection initialized
+
+				// Search the session data in ArangoDB
+				return collection::execute(
+					<<<'AQL'
+					FOR d IN @@collection
+						FILTER d.hash == @hash && d.expires > @time && d.active == true
+						RETURN d
+					AQL,
+					[
+						'@collection' => static::COLLECTION,
+						'hash' => $hash,
+						'time' => time()
+					],
+					errors: $errors
+				);
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return null;
+	}
+
+	/**
+	 * Search by IP-address
+	 *
+	 * Search for the session in ArangoDB by IP-address
+	 *
+	 * @param string $address IP-address writed to the session in ArangoDB
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return _document|null instance of document of the session in ArangoDB
+	 */
+	public static function address(string $address, array &$errors = []): ?_document
+	{
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE, errors: $errors)) {
+				// Collection initialized
+
+				// Search the session data in ArangoDB
+				return collection::execute(
+					<<<'AQL'
+					FOR d IN @@collection
+						FILTER d.address == @address && d.expires > @time && d.active == true
+						SORT d.updated DESC
+						LIMIT 1
+						RETURN d
+					AQL,
+					[
+						'@collection' => static::COLLECTION,
+						'address' => $address,
+						'time' =>	time()
+					],
+					errors: $errors
+				);
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return null;
+	}}

author/project/system/models/traits/buffer.php

@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\traits;
+
+// Files of the project
+use svoboda\works\models\traits\document as document_trait,
+	svoboda\works\models\interfaces\document as document_interface,
+	svoboda\works\models\interfaces\collection as collection_interface,
+	svoboda\works\models\enumerations\language;
+
+// Library for ArangoDB
+use ArangoDBClient\Document as _document;
+
+// Framework for ArangoDB
+use mirzaev\arangodb\collection,
+	mirzaev\arangodb\document;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Buffer
+ *
+ * Storage of data in the document from ArangoDB
+ *
+ * @uses document
+ * @uses document_interface
+ * @uses collection_interface
+ *
+ * @param static COLLECTION Name of the collection in ArangoDB
+ * @param static TYPE Type of the collection in ArangoDB
+ *
+ * @package svoboda\works\models\traits
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+trait buffer
+{
+	/**
+	 * Write to buffer of the document
+	 *
+	 * @param array $data Data for writing (merge)
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return bool Is data has written into the document from ArangoDB?
+	 */
+	public function write(array $data, array &$errors = []): bool
+	{
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE, errors: $errors)) {
+				// Initialized the collection
+
+				// Is the instance of the document from ArangoDB are initialized?
+				if (!isset($this->document)) throw new exception('The instance of the sessoin document from ArangoDB is not initialized');
+
+				// Writing data into buffer of the instance of the document from ArangoDB
+				$this->document->buffer = array_replace_recursive($this->document->buffer ?? [], $data);
+
+				// Is the buffer of the instance of the document from ArangoDB exceed 10 megabytes?
+				if (mb_strlen(json_encode($this->document->buffer)) > 10485760) throw new exception('The buffer size exceeds 10 megabytes');
+
+				// Serializing parameters
+				if ($this->document->language instanceof language) $this->document->language = $this->document->language->name;
+
+				// Writing to ArangoDB and exit (success)
+				return document::update($this->document, errors: $errors);
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return false;
+	}
+}

author/project/system/models/traits/document.php

@@ -0,0 +1,206 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\traits;
+
+// Files of the project
+use svoboda\works\models\interfaces\document as document_interface,
+	svoboda\works\models\interfaces\collection as collection_interface,
+	svoboda\works\models\connect;
+
+// Library для ArangoDB
+use ArangoDBClient\Document as _document;
+
+// Framework for ArangoDB
+use mirzaev\arangodb\connection as arangodb,
+	mirzaev\arangodb\document as framework_document,
+	mirzaev\arangodb\collection;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Trait for implementing a document instance from ArangoDB
+ *
+ * @uses document_interface
+ *
+ * @var protected readonly _document|null $document An instance of the ArangoDB document
+ *
+ * @package svoboda\works\models\traits
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+trait document
+{
+	/**
+	 * Document
+	 *
+	 * @var _document $document An instance of the document from ArangoDB
+	 */
+	protected readonly _document $document;
+
+	/**
+	 * Constructor
+	 *
+	 * @param bool $initialize Initialize a model?
+	 * @param ?arangodb $arangodb Instance of a session of ArangoDB
+	 * @param _document|null|false $document An instance of the ArangoDB document
+	 *
+	 * @return void
+	 */
+	public function __construct(
+		bool $initialize = true,
+		?arangodb $arangodb = null,
+		_document|null|false $document = false
+	) {
+		// For the extends system
+		parent::__construct($initialize, $arangodb);
+
+		// Writing to the property
+		if ($document instanceof _document) $this->__document($document);
+		else if ($document === null) throw new exception('Failed to initialize an instance of the document from ArangoDB');
+	}
+
+	/**
+	 * Write or read document
+	 *
+	 * @param _document|null $document Instance of document from ArangoDB
+	 *
+	 * @return _document|null Instance of document from ArangoDB
+	 */
+	public function __document(?_document $document = null): ?_document
+	{
+		// Writing a property storing a document instance to ArangoDB
+		if ($document) $this->document ??= $document;
+
+		// Read a property storing a document instance to ArangoDB and exit (success)
+		return $this->document ?? null;
+	}
+
+	/**
+	 * Connect
+	 *
+	 * @param collecton_interface $document Document
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return string|null The identifier of the created edge of the "connect" collection, if created
+	 */
+	public function connect(collection_interface $document, array &$errors = []): ?string
+	{
+		try {
+			if (collection::initialize(static::COLLECTION, static::TYPE, errors: $errors)) {
+				if (collection::initialize(connect::COLLECTION, connect::TYPE, errors: $errors)) {
+					if (collection::initialize($document::COLLECTION, $document::TYPE, errors: $errors)) {
+						// Initialized collections 
+
+						if ($this->document instanceof _document) {
+							// Initialized instance of the document from ArangoDB
+
+							// Writing document and exit (success)
+							return framework_document::write(
+								connect::COLLECTION,
+								[
+									'_from' => $document->getId(),
+									'_to' => $this->document->getId()
+								],
+								errors: $errors
+							);
+						} else  throw new exception('The instance of the document from ArangoDB is not initialized');
+					} else throw new exception('Failed to initialize ' . $document::TYPE . ' collection: ' . $document::COLLECTION);
+				} else throw new exception('Failed to initialize ' . connect::TYPE . ' collection: ' . connect::COLLECTION);
+			} else throw new exception('Failed to initialize ' . static::TYPE . ' collection: ' . static::COLLECTION);
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return null;
+	}
+
+	/**
+	 * Write
+	 *
+	 * Write a property into an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 * @param mixed $value Content of the property
+	 *
+	 * @return void
+	 */
+	public function __set(string $name, mixed $value = null): void
+	{
+		// Writing to the property into an instance of the ArangoDB document and exit (success)
+		$this->document->{$name} = $value;
+	}
+
+	/**
+	 * Read
+	 *
+	 * Read a property from an instance of the ArangoDB docuemnt
+	 * 
+	 * @param string $name Name of the property
+	 *
+	 * @return mixed Content of the property
+	 */
+	public function __get(string $name): mixed
+	{
+		// Read a property from an instance of the ArangoDB document and exit (success)
+		return match ($name) {
+			default => $this->document->{$name}
+		};
+	}
+
+	/**
+	 * Delete
+	 *
+	 * Deinitialize the property in an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return void
+	 */
+	public function __unset(string $name): void
+	{
+		// Delete the property in an instance of the ArangoDB document and exit (success)
+		unset($this->document->{$name});
+	}
+
+	/**
+	 * Check of initialization
+	 *
+	 * Check of initialization of the property into an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the property
+	 *
+	 * @return bool The property is initialized?
+	 */
+	public function __isset(string $name): bool
+	{
+		// Check of initializatio nof the property and exit (success)
+		return isset($this->document->{$name});
+	}
+
+	/**
+	 * Execute a method
+	 *
+	 * Execute a method from an instance of the ArangoDB document
+	 *
+	 * @param string $name Name of the method
+	 * @param array $arguments Arguments for the method
+	 *
+	 * @return mixed Result of execution of the method
+	 */
+	public function __call(string $name, array $arguments = []): mixed
+	{
+		// Execute the method and exit (success)
+		return method_exists($this->document, $name) ? $this->document->{$name}($arguments) ?? null : null;
+	}
+}

author/project/system/models/traits/files.php

@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\traits;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Files
+ *
+ * Trait with files handlers
+ *
+ * @method static void delete(string $directory, array &$errors)
+ *
+ * @package svoboda\works\models\traits
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+trait files
+{
+	/**
+	 * Delete
+	 *
+	 * Delete files recursively
+	 * 
+	 * @param string $directory Directory
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return void
+	 */
+	private static function delete(string $directory, array &$errors = []): void
+	{
+		try {
+			if (file_exists($directory)) {
+				// Directory exists
+
+				// Deleting descendant files and directories (enter to the recursion)
+				foreach (scandir($directory) as $file) {
+					if ($file === '.' || $file === '..') continue;
+					else if (is_dir("$directory/$file")) static::delete("$directory/$file", $errors);
+					else unlink("$directory/$file");
+				}
+
+				// Deleting the directory
+				rmdir($directory);
+
+				// Exit (success)
+				return;
+			} else throw new exception('Directory does not exist');
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return;
+	}
+}

author/project/system/models/traits/status.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\models\traits;
+
+// Files of the project
+use svoboda\works\models\traits\document as document_trait,
+	svoboda\works\models\interfaces\document as document_interface;
+
+// Built-in libraries
+use exception;
+
+/**
+ * Status (DUMB SHIT)
+ *
+ * Trait for initialization of a status
+ * 
+ * @uses document_trait
+ * @uses document_interface
+ *
+ * @method bool|null status(array &$errors) Check document by its status
+ *
+ * @package svoboda\works\models\traits
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+trait status
+{
+	/**
+	 * Status
+	 *
+	 * Check document by its status
+	 *
+	 * @param array &$errors Registry of errors
+	 *
+	 * @return ?bool Status, if found
+	 */
+	public function status(array &$errors = []): ?bool
+	{
+		try {
+			// Read from ArangoDB and exit (success)
+			return $this->document->active ?? false;
+		} catch (exception $e) {
+			// Writing to the registry of errors
+			$errors[] = [
+				'text' => $e->getMessage(),
+				'file' => $e->getFile(),
+				'line' => $e->getLine(),
+				'stack' => $e->getTrace()
+			];
+		}
+
+		// Exit (fail)
+		return null;
+	}
+}
+

author/project/system/public/css/themes/default/main.css

@@ -0,0 +1,46 @@
+@charset "UTF-8";
+
+* {
+	text-decoration: none;
+	outline: none;
+	border: none;
+	/* font-family: , system-ui, sans-serif; */
+	font-family: "dejavu";
+	transition: 0.1s ease-out;
+}
+
+body {
+	margin: 0;
+	min-height: 100vh;
+	padding: 0;
+	display: flex;
+	flex-direction: column;
+	background-color: var(--background, #fafafa);
+}
+
+aside {
+}
+
+header {
+}
+
+main {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	gap: 10px;
+	transition: 0s;
+}
+
+footer {
+}
+
+.unselectable {
+	-webkit-touch-callout: none;
+	-webkit-user-select: none;
+	-khtml-user-select: none;
+	-moz-user-select: none;
+	-ms-user-select: none;
+	user-select: none;
+}
+

author/project/system/public/index.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works;
+
+// Framework for PHP
+use mirzaev\minimal\core,
+	mirzaev\minimal\route;
+
+// Enabling debugging
+/* ini_set('error_reporting', E_ALL);
+ini_set('display_errors', 1);
+ini_set('display_startup_errors', 1); */
+
+// Initializing path to the public directory 
+define('PUBLIC', __DIR__);
+
+// Initializing path to the project root directory
+define('ROOT',  INDEX . DIRECTORY_SEPARATOR	. '..' . DIRECTORY_SEPARATOR	. '..' . DIRECTORY_SEPARATOR	. '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR);
+
+// Initializing path to the directory of views 
+define('VIEWS', realpath('..' . DIRECTORY_SEPARATOR . 'views'));
+
+// Initializing path to the directory of storage 
+define('STORAGE', realpath('..' . DIRECTORY_SEPARATOR . 'storage'));
+
+// Initializing path to the directory of settings 
+define('SETTINGS', realpath('..' . DIRECTORY_SEPARATOR . 'settings'));
+
+// Initializing path to the directory of the storage 
+define('STORAGE', realpath('..' . DIRECTORY_SEPARATOR . 'storage'));
+
+// Initializing default theme for the views templater
+define('THEME', 'default');
+
+// Initializing dependencies
+require ROOT . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php';
+
+// Initializing core
+$core = new core(namespace: __NAMESPACE__);
+
+// Initializing routes
+$router->router
+	->write('/', new route('index', 'index'), 'GET')
+;
+
+// Handling request
+$core->start();

author/project/system/settings/.gitignore

@@ -0,0 +1,3 @@
+*
+!.gitignore
+!*.sample

author/project/system/settings/arangodb.php.sample

@@ -0,0 +1,8 @@
+<?php
+
+return [
+    'endpoint' => 'unix:///var/run/arangodb3/arango.sock',
+    'database' => 'works',
+    'name' => 'works',
+    'password' => ''
+];

author/project/system/views/templater.php

@@ -0,0 +1,213 @@
+<?php
+
+declare(strict_types=1);
+
+namespace svoboda\works\views;
+
+// Files of the project
+use svoboda\works\models\session,
+	svoboda\works\models\enumerations\language;
+
+// Framework for PHP
+use mirzaev\minimal\controller;
+
+// Templater of views
+use Twig\Loader\FilesystemLoader,
+	Twig\Environment as twig,
+	Twig\Extra\Intl\IntlExtension as intl,
+	Twig\TwigFilter,
+	Twig\TwigFunction;
+
+// Built-in libraries
+use ArrayAccess as array_access,
+	Error as error;
+
+/**
+ * Templater
+ *
+ * @package svoboda\works\views
+ *
+ * @param twig $twig Instance of the twig templater
+ * @param array $variables Registry of view global variables
+ *
+ * @method void __construct(?session &$session) Constructor
+ * @method string|null render(string $file, ?array $variables) Render the HTML-document
+ *
+ * @license http://www.wtfpl.net/ Do What The Fuck You Want To Public License
+ * @author svoboda <mail@domain.zone>
+ */
+final class templater extends controller implements array_access
+{
+	/**
+	 * Twig
+	 * 
+	 * @var twig $twig Instance of the twig templater
+	 */
+	readonly public twig $twig;
+
+	/**
+	 * Variables
+	 * 
+	 * @var array $variables Registry of view global variables
+	 */
+	public array $variables = [];
+
+	/**
+	 * Constructor of an instance
+	 *
+	 * @param ?session $session Instance of the session in ArangoDB
+	 *
+	 * @return void
+	 */
+	public function __construct(?session &$session = null)
+	{
+		// Initializing the Twig instance
+		$this->twig = new twig(new FilesystemLoader(VIEWS));
+
+		// Initializing global variables
+		$this->twig->addGlobal('theme', 'default');
+		$this->twig->addGlobal('server', $_SERVER);
+		$this->twig->addGlobal('cookies', $_COOKIE);
+		if (!empty($session->status())) $this->twig->addGlobal('session', $session);
+		$this->twig->addGlobal('language', $language = $session?->buffer['language'] ?? language::en);
+	}
+
+	/**
+	 * Render 
+	 *
+	 * Render the HTML-document
+	 *
+	 * @param string $file Related path to a HTML-document
+	 * @param ?array $variables Registry of variables to push into registry of global variables
+	 *
+	 * @return ?string HTML-document
+	 */
+	public function render(string $file, ?array $variables = null): ?string
+	{
+		// Generation and exit (success)
+		return $this->twig->render('themes' . DIRECTORY_SEPARATOR . $this->twig->getGlobal('theme') . DIRECTORY_SEPARATOR . $file, $variables + $this->variables);
+	}
+
+	/**
+	 * Write
+	 *
+	 * Write the variable into the registry of the view global variables
+	 *
+	 * @param string $name Name of the variable
+	 * @param mixed $value Value of the variable
+	 *
+	 * @return void
+	 */
+	public function __set(string $name, mixed $value = null): void
+	{
+		// Write the variable and exit (success)
+		$this->variables[$name] = $value;
+	}
+
+	/**
+	 * Read
+	 *
+	 * Read the variable from the registry of the view global variables
+	 *
+	 * @param string $name Name of the variable
+	 *
+	 * @return mixed Content of the variable, if they are found
+	 */
+	public function __get(string $name): mixed
+	{
+    // Read the variable and exit (success)
+		return $this->variables[$name];
+	}
+
+	/**
+	 * Delete
+	 *
+	 * Delete the variable from the registry of the view global variables
+	 *
+	 * @param string $name Name of the variable 
+	 *
+	 * @return void
+	 */
+	public function __unset(string $name): void
+	{
+	 // Delete the variable and exit (success)
+		unset($this->variables[$name]);
+	}
+
+	/**
+	 * Check of initialization
+	 *
+	 * Check of initialization in the registry of the view global variables
+	 *
+	 * @param string $name Name of the variable
+	 *
+	 * @return bool The variable is initialized?
+	 */
+	public function __isset(string $name): bool
+	{
+		// Check of initialization of the variable and exit (success)
+		return isset($this->variables[$name]);
+	}
+
+	/**
+	 * Write
+	 *
+	 * Write the variable into the registry of the view global variables
+	 *
+	 * @param mixed $name Name of an offset of the variable
+	 * @param mixed $value Value of the variable
+	 *
+	 * @return void
+	 */
+	public function offsetSet(mixed $name, mixed $value): void
+	{
+		// Write the variable and exit (success)
+		$this->variables[$name] = $value;
+	}
+
+	/**
+	 * Read
+	 *
+	 * Read the variable from the registry of the view global variables
+	 *
+	 * @param mixed $name Name of the variable
+	 *
+	 * @return mixed Content of the variable, if they are found
+	 */
+	public function offsetGet(mixed $name): mixed
+	{
+    // Read the variable and exit (success)
+		return $this->variables[$name];
+	}
+
+	/**
+	 * Delete
+	 *
+	 * Delete the variable from the registry of the view global variables
+	 *
+	 * @param mixed $name Name of the variable 
+	 *
+	 * @return void
+	 */
+	public function offsetUnset(mixed $name): void
+	{
+	 // Delete the variable and exit (success)
+		unset($this->variables[$name]);
+	}
+
+	/**
+	 * Check of initialization
+	 *
+	 * Check of initialization in the registry of the view global variables
+	 *
+	 * @param mixed $name Name of the variable
+	 *
+	 * @return bool The variable is initialized?
+	 */
+	public function offsetExists(mixed $name): bool
+	{
+		// Check of initialization of the variable and exit (success)
+		return isset($this->variables[$name]);
+	}
+}
+

author/project/system/views/themes/default/core.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+
+<html lang="ru">
+
+<head>
+	{% use 'head.html' with title as head_title, meta as head_meta, css as head_css %}
+
+	{% block title %}
+	{{ block('head_title') }}
+	{% endblock %}
+
+	{% block meta %}
+	{{ block('head_meta') }}
+	{% endblock %}
+
+	{{ block('head_css') }}
+	{% block css %}
+	{% endblock %}
+</head>
+
+<body>
+	{% block body %}
+	{% endblock %}
+
+	{% include 'js.html' %}
+	{% block js %}
+	{% endblock %}
+</body>
+
+</html>
+

author/project/system/views/themes/default/footer.html

@@ -0,0 +1,10 @@
+{% block css %}
+{% endblock %}
+
+{% block body %}
+<footer>
+</footer>
+{% endblock %}
+
+{% block js %}
+{% endblock %}

author/project/system/views/themes/default/head.html

@@ -0,0 +1,15 @@
+{% block title %}
+<title>{% if head.title != empty %}{{head.title}}{% else %}works by svoboda{% endif %}</title>
+{% endblock %}
+
+{% block meta %}
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+{% for meta in head.metas %}
+<meta {% for name, value in meta.attributes %}{{name}}="{{value}}" {% endfor %}>
+{% endfor %}
+{% endblock %}
+
+{% block css %}
+<link type="text/css" rel="stylesheet" href="/css/themes/default/main.css" />
+{% endblock %}

author/project/system/views/themes/default/header.html

@@ -0,0 +1,10 @@
+{% block css %}
+{% endblock %}
+
+{% block body %}
+<header>
+</header>
+{% endblock %}
+
+{% block js %}
+{% endblock %}

author/project/system/views/themes/default/index.html

@@ -0,0 +1,27 @@
+{% extends "core.html" %}
+
+{% use "core.html" with css as core_css, body as core, js as core_js %}
+{% use "header.html" with css as header_css, body as header, js as header_js %}
+{% use "footer.html" with css as footer_css, body as footer, js as footer_js %}
+
+{% block css %}
+{{ block('core_css') }}
+{{ block('header_css') }}
+{{ block('footer_css') }}
+{% endblock %}
+
+{% block body %}
+{{ block('header') }}
+<main>
+	{% block main %}
+	{{ main|raw }}
+	{% endblock %}
+</main>
+{{ block('footer') }}
+{% endblock %}
+
+{% block js %}
+{{ block('footer_js') }}
+{{ block('header_js') }}
+{{ block('core_js') }}
+{% endblock %}

author/project/system/views/themes/default/js.html

@@ -0,0 +1,2 @@
+{% block js %}
+{% endblock %}