f3-data-models 0.5.16__py3-none-any.whl → 0.6.0__py3-none-any.whl

f3_data_models/models.py

@@ -23,6 +23,7 @@ from sqlalchemy import (
     func,
     inspect,
 )
+from sqlalchemy.dialects.postgresql import JSONB
 from sqlalchemy.orm import (
     DeclarativeBase,
     Mapped,
@@ -49,6 +50,21 @@ dt_update = Annotated[
 ]
 
 
+class Codex_Submission_Status(enum.Enum):
+    """
+    Enum representing the status of a codex submission.
+
+    Attributes:
+        pending
+        approved
+        rejected
+    """
+
+    pending = 1
+    approved = 2
+    rejected = 3
+
+
 class User_Status(enum.Enum):
     """
     Enum representing the status of a user.
@@ -1113,6 +1129,8 @@ class Achievement_x_User(Base):
     Attributes:
         achievement_id (int): The ID of the associated achievement.
         user_id (int): The ID of the associated user.
+        award_year (int): The year the achievement was awarded. Default is -1 (used for lifetime achievements).
+        award_period (int): The period (ie week, month) the achievement was awarded in. Default is -1 (used for lifetime achievements).
         date_awarded (date): The date the achievement was awarded. Default is the current date.
     """  # noqa: E501
 
@@ -1120,6 +1138,8 @@ class Achievement_x_User(Base):
 
     achievement_id: Mapped[int] = mapped_column(ForeignKey("achievements.id"), primary_key=True)
     user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), primary_key=True)
+    award_year: Mapped[int] = mapped_column(Integer, primary_key=True, server_default="-1")
+    award_period: Mapped[int] = mapped_column(Integer, primary_key=True, server_default="-1")
     date_awarded: Mapped[date] = mapped_column(DateTime, server_default=func.timezone("utc", func.now()))
 
 
@@ -1397,3 +1417,166 @@ class UpdateRequest(Base):
     request_type: Mapped[Request_Type]
     created: Mapped[dt_create]
     updated: Mapped[dt_update]
+
+
+# -- Main table for entries
+# CREATE TABLE IF NOT EXISTS codex_entries (
+#   id SERIAL PRIMARY KEY,
+#   title VARCHAR(255) NOT NULL,
+#   definition TEXT NOT NULL,
+#   type VARCHAR(50) NOT NULL,
+#   aliases JSONB DEFAULT '[]'::jsonb,
+#   video_link TEXT,
+#   updated_at TIMESTAMP NOT NULL DEFAULT now()
+# );
+
+# -- Tags used to categorize entries
+# CREATE TABLE IF NOT EXISTS codex_tags (
+#   id SERIAL PRIMARY KEY,
+#   name VARCHAR(255) UNIQUE NOT NULL
+# );
+
+# -- Many-to-many relationship between entries and tags
+# CREATE TABLE IF NOT EXISTS codex_entry_tags (
+#   entry_id INTEGER NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
+#   tag_id INTEGER NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
+#   PRIMARY KEY (entry_id, tag_id)
+# );
+
+# -- User-submitted suggestions (entries, edits, tags, etc.)
+# CREATE TABLE IF NOT EXISTS codex_user_submissions (
+#   id SERIAL PRIMARY KEY,
+#   submission_type VARCHAR(50) NOT NULL,
+#   data JSONB NOT NULL,
+#   submitter_name VARCHAR(255),
+#   submitter_email VARCHAR(255),
+#   timestamp TIMESTAMP NOT NULL DEFAULT now(),
+#   status VARCHAR(50) NOT NULL DEFAULT 'pending'
+# );
+
+# -- Internal linking between entries
+
+# CREATE TABLE IF NOT EXISTS codex_references (
+#   id SERIAL PRIMARY KEY,
+#   from_entry_id INTEGER NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
+#   to_entry_id INTEGER NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
+#   context TEXT,
+#   created_at TIMESTAMP NOT NULL DEFAULT now()
+# );
+
+
+class CodexEntry(Base):
+    """
+    Model representing a Codex entry.
+
+    Attributes:
+        id (int): Primary Key of the model.
+        title (str): The title of the entry.
+        definition (text): The definition of the entry.
+        type (str): The type of the entry.
+        aliases (Optional[List[str]]): Aliases for the entry.
+        video_link (Optional[str]): A link to a video related to the entry.
+        created (datetime): The timestamp when the record was created.
+        updated (datetime): The timestamp when the record was last updated.
+    """  # noqa: E501
+
+    __tablename__ = "codex_entries"
+
+    id: Mapped[intpk]
+    title: Mapped[str]
+    definition: Mapped[text]
+    type: Mapped[str]
+    aliases: Mapped[Optional[List[str]]] = mapped_column(JSONB, server_default="[]")
+    video_link: Mapped[Optional[str]]
+    created: Mapped[dt_create]
+    updated: Mapped[dt_update]
+
+
+class CodexTag(Base):
+    """
+    Model representing a Codex tag.
+
+    Attributes:
+        id (int): Primary Key of the model.
+        name (str): The name of the tag.
+        created (datetime): The timestamp when the record was created.
+        updated (datetime): The timestamp when the record was last updated.
+    """  # noqa: E501
+
+    __tablename__ = "codex_tags"
+
+    id: Mapped[intpk]
+    name: Mapped[str] = mapped_column(VARCHAR, unique=True, nullable=False)
+    created: Mapped[dt_create]
+    updated: Mapped[dt_update]
+
+
+class CodexEntryTag(Base):
+    """
+    Model representing the association between Codex entries and tags.
+
+    Attributes:
+        entry_id (int): The ID of the associated Codex entry.
+        tag_id (int): The ID of the associated Codex tag.
+    """  # noqa: E501
+
+    __tablename__ = "codex_entry_tags"
+
+    entry_id: Mapped[int] = mapped_column(ForeignKey("codex_entries.id", ondelete="CASCADE"), primary_key=True)
+    tag_id: Mapped[int] = mapped_column(ForeignKey("codex_tags.id", ondelete="CASCADE"), primary_key=True)
+
+
+class CodexUserSubmission(Base):
+    """
+    Model representing a user submission for the Codex.
+
+    Attributes:
+        id (int): Primary Key of the model.
+        submission_type (str): The type of the submission (e.g., 'entry', 'edit', 'tag').
+        data (Dict[str, Any]): The data of the submission in JSON format.
+        submitter_name (Optional[str]): The name of the submitter.
+        submitter_email (Optional[str]): The email of the submitter.
+        submitter_user_id (Optional[int]): The ID of the associated user, if available.
+        timestamp (datetime): The timestamp when the submission was made.
+        status (str): The status of the submission (e.g., 'pending', 'approved', 'rejected').
+        created (datetime): The timestamp when the record was created.
+        updated (datetime): The timestamp when the record was last updated.
+    """  # noqa: E501
+
+    __tablename__ = "codex_user_submissions"
+
+    id: Mapped[intpk]
+    submission_type: Mapped[str]
+    data: Mapped[Dict[str, Any]] = mapped_column(JSON)
+    submitter_name: Mapped[Optional[str]]
+    submitter_email: Mapped[Optional[str]]
+    submitter_user_id: Mapped[Optional[int]] = mapped_column(ForeignKey("users.id"))
+    timestamp: Mapped[dt_create]
+    status: Mapped[Codex_Submission_Status] = mapped_column(
+        Enum(Codex_Submission_Status), default=Codex_Submission_Status.pending
+    )
+    created: Mapped[dt_create]
+    updated: Mapped[dt_update]
+
+
+class CodexReference(Base):
+    """
+    Model representing a reference between Codex entries.
+
+    Attributes:
+        id (int): Primary Key of the model.
+        from_entry_id (int): The ID of the entry from which the reference originates.
+        to_entry_id (int): The ID of the entry to which the reference points.
+        context (Optional[str]): Context or description of the reference.
+        created (datetime): The timestamp when the reference was created.
+        updated (datetime): The timestamp when the record was last updated.
+    """  # noqa: E501
+
+    __tablename__ = "codex_references"
+
+    id: Mapped[intpk]
+    from_entry_id: Mapped[int] = mapped_column(ForeignKey("codex_entries.id", ondelete="CASCADE"))
+    to_entry_id: Mapped[int] = mapped_column(ForeignKey("codex_entries.id", ondelete="CASCADE"))
+    context: Mapped[Optional[str]]
+    created: Mapped[dt_create]
+    updated: Mapped[dt_update]

{f3_data_models-0.5.16.dist-info → f3_data_models-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: f3-data-models
-Version: 0.5.16
+Version: 0.6.0
 Summary: The data schema and models for F3 Nation applications.
 License: MIT
 Author: Evan Petzoldt

f3_data_models-0.6.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+f3_data_models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+f3_data_models/models.py,sha256=4LJ-t43h1iKceag7pQShV8sBXIPAO31cOhU96rnROas,61177
+f3_data_models/testing.py,sha256=uHHgrfMOpUvu6-yOyuMsGadyeN-zuAFRYuGQNpXX4Lk,598
+f3_data_models/utils.py,sha256=5ijpywxWMZZ5TZr7L7rLjs3QVsAHFvTQLtsrzIcnm04,12153
+f3_data_models-0.6.0.dist-info/METADATA,sha256=wEiAnICuNck_4800TTWPKwTW1Ir2FzXYE3G1n01BKi0,3674
+f3_data_models-0.6.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+f3_data_models-0.6.0.dist-info/RECORD,,

f3_data_models-0.5.16.dist-info/RECORD

@@ -1,7 +0,0 @@
-f3_data_models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-f3_data_models/models.py,sha256=CjGVbV6Y8XlO8ZqvsQcvKlWoWqzB8VT6vg0IqmXqklo,54659
-f3_data_models/testing.py,sha256=uHHgrfMOpUvu6-yOyuMsGadyeN-zuAFRYuGQNpXX4Lk,598
-f3_data_models/utils.py,sha256=5ijpywxWMZZ5TZr7L7rLjs3QVsAHFvTQLtsrzIcnm04,12153
-f3_data_models-0.5.16.dist-info/METADATA,sha256=qT3g2ypSghP5ihJVzN7V_0kwPwLpRs3mpGatyoEMjWI,3675
-f3_data_models-0.5.16.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-f3_data_models-0.5.16.dist-info/RECORD,,