add metadata type (#64)

Author: JannikStreek

docs/architecture.md

@@ -17,7 +17,8 @@ The `open_educational_resources` table stores processed OER data with denormaliz
 | `id` | UUID | PK | System | Auto-generated primary key |
 | `url` | Text | Unique | Both | Resource URL (from `d` tag or file URL) |
 | **Educational Metadata** |
-| `amb_metadata` | JSONB | - | AMB Event | Complete AMB metadata in structured format |
+| `metadata` | JSONB | - | Source Event | Complete metadata in structured format (format depends on source) |
+| `metadata_type` | Text | - | Source Event | Type identifier for metadata format (e.g., "amb" for AMB/Nostr sources) |
 | `keywords` | JSONB Array | - | AMB Event | Searchable keywords/tags |
 | `description` | Text | - | AMB Event | Resource description |
 | `audience_uri` | Text | Yes | AMB Event | Target audience URI (e.g., educators, students) |

docs/client-packages-react.md

@@ -59,7 +59,7 @@ function OerFinder() {
   const handleCardClick = useCallback(
     (event: CustomEvent<OerCardClickEvent>) => {
       const oer = event.detail.oer;
-      const url = oer.amb_metadata?.id || oer.url;
+      const url = oer.metadata?.id || oer.url;
       if (url) {
         window.open(String(url), '_blank', 'noopener,noreferrer');
       }

docs/client-packages-svelte.md

@@ -58,7 +58,7 @@ The recommended pattern is to slot `<oer-list>` and `<oer-pagination>` inside `<
     // Handle card clicks
     listElement.addEventListener('card-click', (event: Event) => {
       const { oer } = (event as CustomEvent<OerCardClickEvent>).detail;
-      const url = oer.amb_metadata?.id || oer.url;
+      const url = oer.metadata?.id || oer.url;
       if (url) {
         window.open(String(url), '_blank', 'noopener,noreferrer');
       }

docs/client-packages.md

@@ -393,7 +393,7 @@ Here's a complete example showing how to integrate the search, list, and paginat
     // Handle card clicks (open resource in new tab)
     listElement.addEventListener('card-click', (event) => {
       const oer = event.detail.oer;
-      const url = oer.amb_metadata?.id || oer.url;
+      const url = oer.metadata?.id || oer.url;
       if (url) {
         window.open(url, '_blank', 'noopener,noreferrer');
       }

openspec/specs/aggregator-server/spec.md

@@ -112,7 +112,7 @@ The application MUST automatically extract OER metadata from kind 30142 (AMB - A
 - **WHEN** metadata is extracted
 - **THEN** the tag structure is transformed into fully nested JSON
 - **AND** all levels of nesting are preserved
-- **AND** the nested JSON is stored in the amb_metadata field
+- **AND** the nested JSON is stored in the metadata field
 
 #### Scenario: Extract license information
 - **GIVEN** an AMB event contains license tags

packages/oer-finder-api-client/dist/generated/schema.d.ts

@@ -391,7 +391,7 @@ export interface components {
              */
             file_mime_type: Record<string, never> | null;
             /**
-             * @description AMB metadata object containing type, name, educational level, language, etc. Note: Additional fields beyond the schema definition may be present.
+             * @description Metadata object containing type, name, educational level, language, etc. The structure depends on metadata_type. Note: Additional fields beyond the schema definition may be present.
              * @example {
              *       "type": "LearningResource",
              *       "name": "Introduction to TypeScript",
@@ -402,7 +402,12 @@ export interface components {
              *       "learningResourceType": "Tutorial"
              *     }
              */
-            amb_metadata: components["schemas"]["AmbMetadataSchema"] | null;
+            metadata: components["schemas"]["AmbMetadataSchema"] | null;
+            /**
+             * @description Type of the metadata object (e.g., "amb" for AMB/Allgemeines Metadatenprofil Bildungsressourcen). Determines how to interpret the metadata field.
+             * @example amb
+             */
+            metadata_type: string | null;
             /**
              * @description Array of keywords associated with the resource
              * @example [

packages/oer-finder-api-client/dist/generated/schema.d.ts.map

@@ -392,7 +392,7 @@ export interface components {
              */
             file_mime_type: Record<string, never> | null;
             /**
-             * @description AMB metadata object containing type, name, educational level, language, etc. Note: Additional fields beyond the schema definition may be present.
+             * @description Metadata object containing type, name, educational level, language, etc. The structure depends on metadata_type. Note: Additional fields beyond the schema definition may be present.
              * @example {
              *       "type": "LearningResource",
              *       "name": "Introduction to TypeScript",
@@ -403,7 +403,12 @@ export interface components {
              *       "learningResourceType": "Tutorial"
              *     }
              */
-            amb_metadata: components["schemas"]["AmbMetadataSchema"] | null;
+            metadata: components["schemas"]["AmbMetadataSchema"] | null;
+            /**
+             * @description Type of the metadata object (e.g., "amb" for AMB/Allgemeines Metadatenprofil Bildungsressourcen). Determines how to interpret the metadata field.
+             * @example amb
+             */
+            metadata_type: string | null;
             /**
              * @description Array of keywords associated with the resource
              * @example [