docs: consolidate documentation into organized structure

- Move 12 markdown files from root to docs/ subdirectories
- Organize documentation by category:
  • docs/troubleshooting/ (1 file)  - Technical troubleshooting guides
  • docs/deployment/      (4 files) - Deployment and security documentation
  • docs/guides/          (3 files) - Feature-specific guides
  • docs/planning/        (4 files) - Planning and improvement proposals

Root directory cleanup:
- Reduced from 16 to 4 markdown files in root
- Only essential project files remain:
  • CLAUDE.md (AI instructions)
  • README.md (Main project readme)
  • CLEANUP_PLAN.md (Current cleanup plan)
  • SRC_STRUCTURE_IMPROVEMENTS.md (Structure improvements)

This improves:
✅ Documentation discoverability
✅ Logical organization by purpose
✅ Clean root directory
✅ Better maintainability

src/Framework/Admin/FormFields/Fields/NumberField.php

@@ -0,0 +1,101 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Admin\FormFields\Fields;
+
+use App\Framework\Admin\FormFields\FormField;
+use App\Framework\Admin\FormFields\ValueObjects\FieldAttributes;
+use App\Framework\Admin\FormFields\ValueObjects\FieldMetadata;
+use App\Framework\Admin\FormFields\Components\FieldWrapper;
+use App\Framework\View\FormBuilder;
+use App\Framework\View\ValueObjects\FormElement;
+
+/**
+ * Number Input Field
+ *
+ * Number input field with min/max/step using composition
+ */
+final readonly class NumberField implements FormField
+{
+    public function __construct(
+        private FieldMetadata $metadata,
+        private FieldAttributes $attributes,
+        private FieldWrapper $wrapper,
+        private mixed $value = null,
+        private ?int $min = null,
+        private ?int $max = null,
+        private ?int $step = null
+    ) {}
+
+    public static function create(
+        string $name,
+        string $label,
+        mixed $value = null,
+        bool $required = false,
+        ?string $placeholder = null,
+        ?string $help = null,
+        ?int $min = null,
+        ?int $max = null,
+        ?int $step = null
+    ): self {
+        return new self(
+            metadata: new FieldMetadata($name, $label, $help),
+            attributes: new FieldAttributes(
+                name: $name,
+                id: $name,
+                required: $required,
+                placeholder: $placeholder
+            ),
+            wrapper: new FieldWrapper(),
+            value: $value,
+            min: $min,
+            max: $max,
+            step: $step
+        );
+    }
+
+    public function render(FormBuilder $form): FormBuilder
+    {
+        $additionalAttrs = ['type' => 'number'];
+
+        if ($this->min !== null) {
+            $additionalAttrs['min'] = (string) $this->min;
+        }
+
+        if ($this->max !== null) {
+            $additionalAttrs['max'] = (string) $this->max;
+        }
+
+        if ($this->step !== null) {
+            $additionalAttrs['step'] = (string) $this->step;
+        }
+
+        $attrs = $this->attributes->withAdditional($additionalAttrs);
+        $attrArray = $attrs->toArray();
+
+        if ($this->value !== null && $this->value !== '') {
+            $attrArray['value'] = (string) $this->value;
+        }
+
+        $input = FormElement::create('input', $attrArray);
+        $wrapped = $this->wrapper->wrap($input, $this->metadata);
+
+        return $form->addElement($wrapped);
+    }
+
+    public function getName(): string
+    {
+        return $this->metadata->name;
+    }
+
+    public function getValue(): mixed
+    {
+        return $this->value;
+    }
+
+    public function getLabel(): string
+    {
+        return $this->metadata->label;
+    }
+}