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/View/ValueObjects/FormId.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\View\ValueObjects;
+
+use App\Framework\Http\Session\FormIdGenerator;
+
+final readonly class FormId
+{
+    public function __construct(
+        public string $value
+    ) {
+        if (empty(trim($value))) {
+            throw new \InvalidArgumentException('FormId cannot be empty');
+        }
+
+        if (!preg_match('/^[a-zA-Z][a-zA-Z0-9_-]*$/', $value)) {
+            throw new \InvalidArgumentException('FormId must start with a letter and contain only letters, numbers, underscores, and hyphens');
+        }
+    }
+
+    public static function generate(FormIdGenerator $generator, string $route = '/', string $method = 'post'): self
+    {
+        // Use the existing FormIdGenerator logic
+        $formId = $generator->generateFormId($route, $method);
+        return new self($formId);
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function isValid(FormIdGenerator $generator): bool
+    {
+        return $generator->isValidFormId($this);
+    }
+}