CODEX - Added Warning sign if Archetype is missing

backend/melodies/router.py

@@ -43,7 +43,7 @@ async def create_melody(
     publish: bool = Query(False),
     _user: TokenPayload = Depends(require_permission("melodies", "add")),
 ):
-    return await service.create_melody(body, publish=publish)
+    return await service.create_melody(body, publish=publish, actor_name=_user.name)
 
 
 @router.put("/{melody_id}", response_model=MelodyInDB)
@@ -52,7 +52,7 @@ async def update_melody(
     body: MelodyUpdate,
     _user: TokenPayload = Depends(require_permission("melodies", "edit")),
 ):
-    return await service.update_melody(melody_id, body)
+    return await service.update_melody(melody_id, body, actor_name=_user.name)
 
 
 @router.delete("/{melody_id}", status_code=204)
@@ -108,9 +108,9 @@ async def upload_file(
                 name=melody.information.name,
                 previewURL=url,
             )
-        ))
+        ), actor_name=_user.name)
     elif file_type == "binary":
-        await service.update_melody(melody_id, MelodyUpdate(url=url))
+        await service.update_melody(melody_id, MelodyUpdate(url=url), actor_name=_user.name)
 
     return {"url": url, "file_type": file_type}
 

backend/melodies/service.py

@@ -1,6 +1,7 @@
 import json
 import uuid
 import logging
+from datetime import datetime
 
 from shared.firebase import get_db as get_firestore, get_bucket
 from shared.exceptions import NotFoundError
@@ -93,10 +94,44 @@ async def get_melody(melody_id: str) -> MelodyInDB:
     raise NotFoundError("Melody")
 
 
-async def create_melody(data: MelodyCreate, publish: bool = False) -> MelodyInDB:
+def _sanitize_metadata_for_create(existing: dict | None, actor_name: str | None) -> dict:
+    now = datetime.utcnow().isoformat() + "Z"
+    metadata = dict(existing or {})
+    creator = metadata.get("createdBy") or actor_name or "Unknown"
+    created_at = metadata.get("dateCreated") or now
+    metadata["createdBy"] = creator
+    metadata["dateCreated"] = created_at
+    metadata["lastEditedBy"] = actor_name or metadata.get("lastEditedBy") or creator
+    metadata["dateEdited"] = now
+    if "adminNotes" not in metadata:
+        metadata["adminNotes"] = []
+    return metadata
+
+
+def _sanitize_metadata_for_update(existing: dict | None, incoming: dict | None, actor_name: str | None) -> dict:
+    now = datetime.utcnow().isoformat() + "Z"
+    existing_meta = dict(existing or {})
+    incoming_meta = dict(incoming or {})
+
+    # Created fields are immutable after first set.
+    created_by = existing_meta.get("createdBy") or incoming_meta.get("createdBy") or actor_name or "Unknown"
+    date_created = existing_meta.get("dateCreated") or incoming_meta.get("dateCreated") or now
+
+    merged = {**existing_meta, **incoming_meta}
+    merged["createdBy"] = created_by
+    merged["dateCreated"] = date_created
+    merged["lastEditedBy"] = actor_name or incoming_meta.get("lastEditedBy") or existing_meta.get("lastEditedBy") or created_by
+    merged["dateEdited"] = now
+    if "adminNotes" not in merged:
+        merged["adminNotes"] = existing_meta.get("adminNotes", [])
+    return merged
+
+
+async def create_melody(data: MelodyCreate, publish: bool = False, actor_name: str | None = None) -> MelodyInDB:
     """Create a new melody. If publish=True, also push to Firestore."""
     melody_id = str(uuid.uuid4())
     doc_data = data.model_dump()
+    doc_data["metadata"] = _sanitize_metadata_for_create(doc_data.get("metadata"), actor_name)
     status = "published" if publish else "draft"
 
     # Always save to SQLite
@@ -110,7 +145,7 @@ async def create_melody(data: MelodyCreate, publish: bool = False) -> MelodyInDB
     return MelodyInDB(id=melody_id, status=status, **doc_data)
 
 
-async def update_melody(melody_id: str, data: MelodyUpdate) -> MelodyInDB:
+async def update_melody(melody_id: str, data: MelodyUpdate, actor_name: str | None = None) -> MelodyInDB:
     """Update an existing melody. If published, also update Firestore."""
     row = await melody_db.get_melody(melody_id)
     if not row:
@@ -124,6 +159,12 @@ async def update_melody(melody_id: str, data: MelodyUpdate) -> MelodyInDB:
         if key in update_data and key in existing_data:
             merged = {**existing_data[key], **update_data[key]}
             update_data[key] = merged
+    if "metadata" in update_data or "metadata" in existing_data:
+        update_data["metadata"] = _sanitize_metadata_for_update(
+            existing_data.get("metadata"),
+            update_data.get("metadata"),
+            actor_name,
+        )
 
     merged_data = {**existing_data, **update_data}