Add coding guidelines and improve type annotations

Introduces a `.github/copilot-instructions.md` file specifying project-specific coding standards, including PSR-12 adherence, PHP 8.4+ compatibility, and testing practices.

Enhances type annotations and docblocks in `RO` class:
- Adds detailed type hints for properties and methods.
- Ensures consistency in variable initialization.
- Fixes typos and clarifies documentation.

Improves maintainability, readability, and alignment with best practices.

Author: Vitexus

.github/copilot-instructions.md

@@ -0,0 +1,39 @@
+<!-- Use this file to provide workspace-specific custom instructions to Copilot. For more details, visit https://code.visualstudio.com/docs/copilot/copilot-customization#_use-a-githubcopilotinstructionsmd-file -->
+
+All code comments should be written in English.
+
+All messages, including error messages, should be written in English.
+
+All code should be written in PHP 8.4 or later.
+
+All code should follow the PSR-12 coding standard.
+
+When writing code, always include a docblock for functions and classes, describing their purpose, parameters, and return types.
+
+When writing tests, use PHPUnit and follow the PSR-12 coding standard.
+
+When writing commit messages, use the imperative mood and keep them concise.
+
+When writing code comments, use complete sentences and proper grammar.
+
+When writing code, always use meaningful variable names that describe their purpose.
+
+When writing code, avoid using magic numbers or strings; instead, define constants for them.
+
+When writing code, always handle exceptions properly and provide meaningful error messages.
+
+When writing code, always include type hints for function parameters and return types.
+
+We are using the i18n library for internationalization, so always use the _() functions for strings that need to be translated.
+
+When writing code, always ensure that it is secure and does not expose any sensitive information.
+
+When writing code, always consider performance and optimize where necessary.
+
+When writing code, always ensure that it is compatible with the latest version of PHP and the libraries we are using.
+
+When writing code, always ensure that it is well-tested and includes unit tests where applicable.
+
+When writing code, always ensure that it is maintainable and follows best practices.
+
+When create new class or update existing class, always create or update its phpunit test files.

src/AbraFlexi/RO.php

@@ -89,7 +89,7 @@ class RO extends \Ease\Sand
     /**
      * Curl Handle.
      */
-    public ?\CurlHandle $curl;
+    public ?\CurlHandle $curl = null;
 
     /**
      * @see https://demo.flexibee.eu/devdoc/company-identifier Identifikátor firmy
@@ -132,7 +132,7 @@ class RO extends \Ease\Sand
     /**
      * Sloupeček obsahující datum vložení záznamu do shopu.
      */
-    public ?string $myCreateColumn = 'false';
+    public ?string $myCreateColumn = null;
 
     /**
      * Sloupeček obsahujici datum poslení modifikace záznamu do shopu.
@@ -141,8 +141,10 @@ class RO extends \Ease\Sand
 
     /**
      * Informace o posledním HTTP requestu.
+     *
+     * @var null|array<string, mixed>
      */
-    public ?array $curlInfo;
+    public null|array $curlInfo;
 
     /**
      * Informace o poslední HTTP chybě.
@@ -181,6 +183,8 @@ class RO extends \Ease\Sand
 
     /**
      * Last operation result data or message(s).
+     *
+     * @var array<mixed>|null
      */
     public ?array $lastResult = null;
 
@@ -212,6 +216,8 @@ class RO extends \Ease\Sand
      * Parmetry pro URL.
      *
      * @see https://www.abraflexi.eu/api/dokumentace/ref/urls/ Všechny podporované parametry
+     *
+     * @var array<string, array<string, mixed>> List of known URL parameters and their metadata
      */
     public array $urlParamsKnown = [
         'add-global-version' => ['type' => 'boolean', 'description' => 'The response will contain the global version number of the current export'],
@@ -333,11 +339,15 @@ class RO extends \Ease\Sand
 
     /**
      * List of Error500 reports sent.
+     *
+     * @var array<string, mixed>
      */
     private array $reports = [];
 
     /**
-     * Columns Info for serveral evidences.
+     * Columns Info for several evidences.
+     *
+     * @var array<string, mixed> Array of evidence names to their column info arrays
      */
     private array $columnsInfo = [];
 
@@ -521,9 +531,9 @@ public function setObjectName($objectName = null)
     /**
      * Get Current connection options for use in another object.
      *
-     * @return array usable as second constructor parameter
+     * @return array<string, int|string|null> Usable as second constructor parameter
      */
-    public function getConnectionOptions()
+    public function getConnectionOptions(): array
     {
         $conOpts = ['url' => $this->url];
 
@@ -548,7 +558,9 @@ public function getConnectionOptions()
     }
 
     /**
-     * Export current/given configutation into Environment.
+     * Export current/given configuration into Environment.
+     *
+     * @param array<string, int|string|null> $opts Configuration options to export to environment variables
      */
     public function configToEnv(array $opts = []): void
     {
@@ -688,7 +700,7 @@ public function setDataValue(string $columnName, $value): bool
     /**
      * Strip all non-identifier data.
      *
-     * @param array $keep extra columns to be preserved
+     * @param array<string> $keep extra columns to be preserved
      *
      * @return RO Current object state
      */
@@ -1936,7 +1948,7 @@ public function getRecordID()
      */
     public function getRecordCode()
     {
-        return empty($this->getDataValue('kod')) ? null : Functions::code($this->getDataValue('kod'));
+        return empty($this->getDataValue('kod')) ? null : Code::ensure($this->getDataValue('kod'));
     }
 
     /**