Frontend and prodtrack implementation (#44)

- Added to the shotgrid implementation
- First pass on UI components

---------

Signed-off-by: James Spadafora <spadjv@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: jspada200

.cursor/rules/always-update-tests.mdc

@@ -7,4 +7,4 @@ alwaysApply: true
 
 # Overview
 
-Always run tests when making changes to the code. For the Frontend, use npm run test. For the Backend, use make test.
+Always run tests when making changes to the code. For the Frontend, use npm run test. For the Backend, use make test. For the frontend use npm run test-ci.

.cursor/rules/stlyed-components.mdc

@@ -0,0 +1,8 @@
+---
+name: stlyed-components
+description: Use styled components for the frontend framework.
+---
+
+# Overview
+
+When working in the frontend, use styled components for the frontend framework. Only create custom components if absolutely necessary. Always check the latest styled components documentation for the best practices. Use a common file for variables and mixins but keep component specific styles in the component file.

.cursor/rules/use-radix-themes-and-primitives.mdc

@@ -0,0 +1,8 @@
+---
+name: use-radix-themes-and-primitives
+description: Always use radix themes and primitives for the frontend framework. 
+---
+
+# Overview
+
+ Always use radix themes and primitives for the frontend framework. Only create custom components if absolutely necessary. Always check the latest radix themes and primitives documentation for the best practices.

backend/src/dna/models/__init__.py

@@ -10,22 +10,33 @@
     EntityBase,
     Note,
     Playlist,
+    Project,
     Shot,
     Task,
+    User,
     Version,
 )
-from dna.models.requests import CreateNoteRequest, EntityLink
+from dna.models.requests import (
+    CreateNoteRequest,
+    EntityLink,
+    FilterCondition,
+    FindRequest,
+)
 
 __all__ = [
     "EntityBase",
+    "Project",
     "Shot",
     "Asset",
     "Note",
     "Task",
     "Version",
     "Playlist",
+    "User",
     "DNAEntity",
     "ENTITY_MODELS",
     "EntityLink",
     "CreateNoteRequest",
+    "FilterCondition",
+    "FindRequest",
 ]

backend/src/dna/models/entity.py

@@ -53,6 +53,15 @@ def _serialize_value(self, value: Any) -> Any:
             return value
 
 
+class Project(EntityBase):
+    """Project entity model.
+
+    Represents a project in the production tracking system.
+    """
+
+    name: Optional[str] = Field(default=None, description="Project name")
+
+
 class Task(EntityBase):
     """Task entity model.
 
@@ -153,6 +162,9 @@ class Version(EntityBase):
     frame_path: Optional[str] = Field(
         default=None, description="Path to frame sequence"
     )
+    thumbnail: Optional[str] = Field(
+        default=None, description="URL to thumbnail image (signed URL from ShotGrid)"
+    )
     project: Optional[dict[str, Any]] = Field(
         default=None, description="Project information"
     )
@@ -200,15 +212,28 @@ def versions_none_to_list(cls, v):
         return v if v is not None else []
 
 
+class User(EntityBase):
+    """User entity model.
+
+    Represents a human user in the production tracking system.
+    """
+
+    name: Optional[str] = Field(default=None, description="User's full name")
+    email: Optional[str] = Field(default=None, description="User's email address")
+    login: Optional[str] = Field(default=None, description="User's login/username")
+
+
 # Type alias for any DNA entity
-DNAEntity = Union[Shot, Asset, Note, Task, Version, Playlist]
+DNAEntity = Union[Project, Shot, Asset, Note, Task, Version, Playlist, User]
 
 # Entity type name to model class mapping
 ENTITY_MODELS: dict[str, type[EntityBase]] = {
+    "project": Project,
     "shot": Shot,
     "asset": Asset,
     "note": Note,
     "task": Task,
     "version": Version,
     "playlist": Playlist,
+    "user": User,
 }

backend/src/dna/models/requests.py

@@ -23,3 +23,22 @@ class CreateNoteRequest(BaseModel):
     note_links: Optional[list[EntityLink]] = Field(
         default=None, description="Entities to link this note to"
     )
+
+
+class FilterCondition(BaseModel):
+    """A single filter condition for entity queries."""
+
+    field: str = Field(description="DNA field name to filter on")
+    operator: str = Field(description="Filter operator (e.g., 'is', 'contains', 'in')")
+    value: Any = Field(description="Value to filter by")
+
+
+class FindRequest(BaseModel):
+    """Request model for finding entities."""
+
+    entity_type: str = Field(
+        description="DNA entity type to search (e.g., 'project', 'shot', 'version')"
+    )
+    filters: list[FilterCondition] = Field(
+        default_factory=list, description="List of filter conditions"
+    )

backend/src/dna/prodtrack_providers/prodtrack_provider_base.py

@@ -1,8 +1,8 @@
 import os
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    from dna.models.entity import EntityBase
+    from dna.models.entity import EntityBase, Playlist, Project, User, Version
 
 
 class ProdtrackProviderBase:
@@ -23,13 +23,73 @@ def add_entity(self, entity_type: str, entity: "EntityBase") -> "EntityBase":
         """Add an entity to the production tracking system."""
         raise NotImplementedError("Subclasses must implement this method.")
 
+    def find(
+        self, entity_type: str, filters: list[dict[str, Any]]
+    ) -> list["EntityBase"]:
+        """Find entities matching the given filters.
+
+        Args:
+            entity_type: The DNA entity type to search for (e.g., 'shot', 'version')
+            filters: List of filter conditions in DNA format
+
+        Returns:
+            List of matching entities
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
+    def get_user_by_email(self, user_email: str) -> "User":
+        """Get a user by their email address.
+
+        Args:
+            user_email: The email address of the user
+
+        Returns:
+            User entity with name, email, and login
+
+        Raises:
+            ValueError: If user is not found
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
+    def get_projects_for_user(self, user_email: str) -> list["Project"]:
+        """Get projects accessible by a user.
+
+        Args:
+            user_email: The email address of the user
+
+        Returns:
+            List of Project entities the user has access to
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
+    def get_playlists_for_project(self, project_id: int) -> list["Playlist"]:
+        """Get playlists for a project.
+
+        Args:
+            project_id: The ID of the project
+
+        Returns:
+            List of Playlist entities for the project
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
+    def get_versions_for_playlist(self, playlist_id: int) -> list["Version"]:
+        """Get versions for a playlist.
+
+        Args:
+            playlist_id: The ID of the playlist
+
+        Returns:
+            List of Version entities in the playlist
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
 
 def get_prodtrack_provider() -> ProdtrackProviderBase:
     """Get the production tracking provider."""
     from dna.prodtrack_providers.shotgrid import ShotgridProvider
 
-    provider_type = os.getenv("PRODTRACK_PROVIDER")
+    provider_type = os.getenv("PRODTRACK_PROVIDER", "shotgrid")
     if provider_type == "shotgrid":
         return ShotgridProvider()
-    else:
-        raise ValueError(f"Unknown production tracking provider: {provider_type}")
+    raise ValueError(f"Unknown production tracking provider: {provider_type}")