Merge pull request #39 from Ardenexal/feat/demo-site

Feat/demo site

Author: Ardenexal

.vscode/settings.json

@@ -114,5 +114,11 @@
     "emmet.includeLanguages": {
         "php": "html"
     },
-    "php.suggest.basic": false
+    "php.suggest.basic": false,
+    "chat.tools.terminal.autoApprove": {
+        "composer": true,
+        "FHIRBundleServiceRegistrationTest": true,
+        "VersionRangeValidityTest": true,
+        "CodeGenerationTestCoverageTest": true
+    }
 }

CLAUDE.md

@@ -43,6 +43,7 @@ composer test
 composer test-unit
 composer test-integration
 composer test-fhir
+composer test-fhirpath-spec     # FHIRPath specification conformance tests
 
 # Component-specific tests
 composer test:bundle
@@ -81,6 +82,15 @@ composer quality:all       # lint + phpstan + test
 - Test fixtures in `tests/Fixtures/`
 - Integration tests verify FHIR conformance and serialization round-trips
 
+### FHIRPath Specification Tests
+
+The FHIRPath component includes official specification conformance tests in a separate test suite (`fhirpath-spec`). These tests validate implementation against the official FHIR FHIRPath test cases and are currently in development as the evaluator implementation is being completed.
+
+- Run with: `composer test-fhirpath-spec`
+- Located in: `src/Component/FHIRPath/tests/Integration/`
+- These tests are excluded from the main integration suite to allow focused development
+- Track progress toward full FHIRPath 2.0 specification compliance
+
 ## FHIR Model Generation
 
 The `fhir:generate` command generates PHP classes from FHIR packages:

composer.json

@@ -5,6 +5,19 @@
     "license": "MIT",
     "minimum-stability": "stable",
     "prefer-stable": true,
+    "repositories": [
+        {
+            "type": "package",
+            "package": {
+                "name": "fhir/fhir-test-cases",
+                "version": "1.7.49",
+                "dist": {
+                    "url": "https://github.com/FHIR/fhir-test-cases/archive/refs/tags/1.7.49.zip",
+                    "type": "zip"
+                }
+            }
+        }
+    ],
     "require": {
         "php": ">=8.3",
         "ext-ctype": "*",
@@ -13,9 +26,14 @@
         "amphp/http-client": "^5.3.4",
         "composer/semver": "^3.4.4",
         "nette/php-generator": "^4.2.1",
+        "psr/http-client": "^1.0",
+        "symfony/config": "^6.4|^7.4",
         "symfony/console": "^6.4|^7.4",
+        "symfony/dependency-injection": "^6.4|^7.4",
         "symfony/filesystem": "^6.4|^7.4",
+        "symfony/finder": "^6.4|^7.4",
         "symfony/http-client": "^6.4|^7.4",
+        "symfony/http-kernel": "^6.4|^7.4",
         "symfony/intl": "^6.4|^7.4",
         "symfony/polyfill-php84": "^v1.33.0",
         "symfony/polyfill-php85": "^v1.33.0",
@@ -26,15 +44,17 @@
         "symfony/yaml": "^6.4|^7.4"
     },
     "require-dev": {
+        "fhir/fhir-test-cases": "1.7.49",
         "giorgiosironi/eris": "^1.0",
         "laravel/pint": "^1.27.1",
         "phpstan/phpstan": "^2.1.39",
-        "phpunit/phpunit": "^11.0|^12.5.11",
+        "phpstan/phpstan-symfony": "^2.0.14",
+        "phpunit/phpunit": "^11.0|^12.5.14",
         "roave/security-advisories": "dev-latest",
-        "symfony/browser-kit": "^6.4|^7.4",
+        "symfony/browser-kit": "^6.4|^7.4.4",
         "symfony/css-selector": "^6.4|^7.4",
-        "symfony/dom-crawler": "^6.4|^7.4",
-        "symfony/phpunit-bridge": "^6.4|^7.4"
+        "symfony/dom-crawler": "^6.4|^7.4.4",
+        "symfony/phpunit-bridge": "^6.4|^7.4.3"
     },
     "config": {
         "allow-plugins": {
@@ -55,7 +75,8 @@
     "autoload-dev": {
         "psr-4": {
             "Ardenexal\\FHIRTools\\Tests\\": "tests/",
-            "Ardenexal\\FHIRTools\\Component\\FHIRPath\\Tests\\": "src/Component/FHIRPath/tests/"
+            "Ardenexal\\FHIRTools\\Component\\FHIRPath\\Tests\\": "src/Component/FHIRPath/tests/",
+            "Ardenexal\\FHIRTools\\Component\\Serialization\\Tests\\": "src/Component/Serialization/tests/"
         }
     },
     "replace": {
@@ -84,6 +105,7 @@
         "test-unit": "php ./vendor/phpunit/phpunit/phpunit --testsuite=unit",
         "test-integration": "php ./vendor/phpunit/phpunit/phpunit --testsuite=integration",
         "test-fhir": "php ./vendor/phpunit/phpunit/phpunit --testsuite=fhir",
+        "test-fhirpath-spec": "php ./vendor/phpunit/phpunit/phpunit --testsuite=fhirpath-spec",
         "test:bundle": "php ./vendor/phpunit/phpunit/phpunit tests/Unit/Bundle/ --no-coverage",
         "test:codegen": "php ./vendor/phpunit/phpunit/phpunit tests/Unit/Component/CodeGeneration/ --no-coverage",
         "test:serialization": "php ./vendor/phpunit/phpunit/phpunit tests/Unit/Component/Serialization/ --no-coverage",
@@ -124,9 +146,18 @@
             "@quality:serialization",
             "@quality:fhir-path"
         ],
+        "generate-models": "php ./demo/bin/console fhir:generate -vvv",
+        "generate-models-all": [
+            "echo 'Generating FHIR R4 models...'",
+            "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core --package=hl7.fhir.r4b.core --package=hl7.fhir.r5.core -vvv",
+            "echo 'All FHIR models generated successfully!'"
+        ],
+        "generate-models-r4": "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4.core -vvv",
+        "generate-models-r4b": "php ./demo/bin/console fhir:generate --package=hl7.fhir.r4b.core -vvv",
+        "generate-models-r5": "php ./demo/bin/console fhir:generate --package=hl7.fhir.r5.core -vvv",
         "fix-newlines": "powershell -ExecutionPolicy Bypass -File scripts/fix-newlines.ps1",
         "validate-recipe": "php scripts/validate-recipe.php",
         "test-recipe": "php ./vendor/phpunit/phpunit/phpunit tests/Integration/FlexRecipeTest.php",
         "test-package-installation": "php scripts/test-package-installation.php"
     }
-}
+}

demo/.editorconfig

@@ -0,0 +1,17 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[{compose.yaml,compose.*.yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

demo/.env

@@ -1,2 +1,27 @@
+# In all environments, the following files are loaded if they exist,
+# the latter taking precedence over the former:
+#
+#  * .env                contains default values for the environment variables needed by the app
+#  * .env.local          uncommitted file with local overrides
+#  * .env.$APP_ENV       committed environment-specific defaults
+#  * .env.$APP_ENV.local uncommitted environment-specific overrides
+#
+# Real environment variables win over .env files.
+#
+# DO NOT DEFINE PRODUCTION SECRETS IN THIS FILE NOR IN ANY OTHER COMMITTED FILES.
+# https://symfony.com/doc/current/configuration/secrets.html
+#
+# Run "composer dump-env prod" to compile .env files for production use (requires symfony/flex >=1.2).
+# https://symfony.com/doc/current/best_practices.html#use-environment-variables-for-infrastructure-configuration
+
+###> symfony/framework-bundle ###
 APP_ENV=dev
-APP_SECRET=demo-secret-not-for-production
+APP_SECRET=
+APP_SHARE_DIR=var/share
+###< symfony/framework-bundle ###
+
+###> symfony/routing ###
+# Configure how to generate URLs in non-HTTP contexts, such as CLI commands.
+# See https://symfony.com/doc/current/routing.html#generating-urls-in-commands
+DEFAULT_URI=http://localhost
+###< symfony/routing ###

demo/.env.dev

@@ -0,0 +1,4 @@
+
+###> symfony/framework-bundle ###
+APP_SECRET=54e8764c36be4f03708e1b068d4d3141
+###< symfony/framework-bundle ###

demo/.env.test

@@ -0,0 +1,3 @@
+# define your env variables for the test env here
+KERNEL_CLASS='App\Kernel'
+APP_SECRET='$ecretf0rt3st'

demo/.gitignore

@@ -1,4 +1,20 @@
-/vendor/
+
+###> symfony/framework-bundle ###
+/.env.local
+/.env.local.php
+/.env.*.local
+/config/secrets/prod/prod.decrypt.private.php
+/public/bundles/
 /var/
-.env.local
-.env.*.local
+/vendor/
+###< symfony/framework-bundle ###
+
+###> phpunit/phpunit ###
+/phpunit.xml
+/.phpunit.cache/
+###< phpunit/phpunit ###
+
+###> symfony/asset-mapper ###
+/public/assets/
+/assets/vendor/
+###< symfony/asset-mapper ###

demo/CLAUDE.md

@@ -0,0 +1,44 @@
+# demo/CLAUDE.md
+
+This file documents conventions for the demo Symfony 7.4 application.
+
+## Stack
+
+- **Framework**: Symfony 7.4 with `MicroKernelTrait`
+- **Templates**: Twig (`*.html.twig`) in `templates/`
+- **CSS**: Tailwind CSS via Play CDN (`<script src="https://cdn.tailwindcss.com">` in `base.html.twig`)
+- **JS**: Stimulus controllers in `assets/controllers/`, Turbo for partial page updates
+- **Routes**: PHP 8 `#[Route]` attributes on controllers (auto-discovered via `config/routes.yaml`)
+- **Services**: Autowired via `config/services.yaml`; FHIR services injected by type hint (registered by FHIRBundle)
+
+## Controllers
+
+Located in `src/Controller/`. Use `#[Route]` attribute for routing. Extend `AbstractController`.
+
+## FHIR Services (via FHIRBundle)
+
+Inject by type hint — all autowired:
+
+- `Ardenexal\FHIRTools\Component\FHIRPath\Service\FHIRPathService` — evaluate/validate FHIRPath expressions
+- `Ardenexal\FHIRTools\Component\Serialization\FHIRSerializationService` — serialize/deserialize FHIR JSON/XML
+- `Ardenexal\FHIRTools\Component\Serialization\Validator\FHIRValidator` — validate FHIR objects
+- `Ardenexal\FHIRTools\Component\Serialization\Metadata\FHIRMetadataExtractorInterface` — extract resource metadata
+
+## FHIR Config
+
+`config/packages/fhir.yaml` — configures default version, output/cache directories, validation, and FHIRPath cache.
+
+## Useful Commands
+
+```bash
+# From the demo/ directory:
+symfony local:server:start        # Start local dev server (http://localhost:8000)
+php bin/console debug:router      # Inspect registered routes
+php bin/console debug:container   # Inspect services
+php bin/console cache:clear       # Clear cache
+```
+
+## Testing
+
+Start the local server with `symfony local:server:start` from the `demo/` directory, then use the
+`webapp-testing` skill to interact with `http://localhost:8000`.

demo/assets/app.js

@@ -0,0 +1,10 @@
+import './stimulus_bootstrap.js';
+/*
+ * Welcome to your app's main JavaScript file!
+ *
+ * This file will be included onto the page via the importmap() Twig function,
+ * which should already be in your base.html.twig.
+ */
+import './styles/app.css';
+
+console.log('This log comes from assets/app.js - welcome to AssetMapper! 🎉');