feat(stick-wall-routes): Routes of stick wall

Routes dedicated to deal with
stick wall created. All CRUD
operations.

Author: matheusAFONSECA

src/models/stickwall_model.py

@@ -0,0 +1,34 @@
+from sqlalchemy.orm import relationship
+from sqlalchemy import Column, Integer, String, Text, ForeignKey, TIMESTAMP, func
+
+from src.modules.database_conection import Base
+
+
+class StickWall(Base):
+    """
+    Represents a StickWall note entity in the to-do list application.
+
+    Attributes:
+        id (int): Primary key identifier for the note.
+        user_id (int): Foreign key referencing the user who owns the note.
+        name (str): Title of the note.
+        text (str): Content of the note.
+        color (str): Hex color associated with the note (e.g. "#FFF176").
+        created_at (datetime): Timestamp when the note was created.
+        updated_at (datetime): Timestamp when the note was last updated.
+        user (User): Relationship to the User model, representing the owner.
+    """
+
+    __tablename__ = "stick_wall"
+
+    id = Column(Integer, primary_key=True, index=True)
+    user_id = Column(
+        Integer, ForeignKey("users.id", ondelete="CASCADE"), nullable=False
+    )
+    name = Column(String(255), nullable=False)
+    text = Column(Text, nullable=False)
+    color = Column(String(7), nullable=False, server_default="#FFFF88")
+    created_at = Column(TIMESTAMP, server_default=func.now())
+    updated_at = Column(TIMESTAMP, server_default=func.now(), onupdate=func.now())
+
+    user = relationship("User", back_populates="stick_notes")

src/models/user_model.py

@@ -3,6 +3,7 @@
 from src.modules.database_conection import Base
 from sqlalchemy import Column, Integer, String, Date, TIMESTAMP
 
+
 class User(Base):
     """
     Represents a user in the system.
@@ -16,6 +17,7 @@ class User(Base):
         created_at (datetime): Timestamp when the user was created.
         updated_at (datetime): Timestamp when the user was last updated.
     """
+
     __tablename__ = "users"
 
     id = Column(Integer, primary_key=True, index=True)
@@ -25,9 +27,15 @@ class User(Base):
     birth_date = Column(Date, nullable=True)
     password_hash = Column(String(255), nullable=False)
     created_at = Column(TIMESTAMP, server_default=func.now(), nullable=False)
-    updated_at = Column(TIMESTAMP, server_default=func.now(), onupdate=func.now(), nullable=False)
+    updated_at = Column(
+        TIMESTAMP, server_default=func.now(), onupdate=func.now(), nullable=False
+    )
 
     # Relationship to projects
-    projects = relationship("Project", back_populates="user", cascade="all, delete-orphan")
-
+    projects = relationship(
+        "Project", back_populates="user", cascade="all, delete-orphan"
+    )
     tasks = relationship("Task", back_populates="user", cascade="all, delete-orphan")
+    stick_notes = relationship(
+        "StickWall", back_populates="user", cascade="all, delete-orphan"
+    )

src/modules/modules_api.py

@@ -3,6 +3,7 @@
 from src.routes.user_routes import user_router
 from src.routes.task_routes import task_router
 from src.routes.project_routes import project_router
+from src.routes.stickwall_routes import stickwall_router
 from src.routes.filter_routes import router as filter_router
 from src.routes.authentication_routes import authentication_router
 
@@ -13,4 +14,5 @@
 router.include_router(user_router)
 router.include_router(project_router)
 router.include_router(task_router)
+router.include_router(stickwall_router)
 router.include_router(filter_router)

src/routes/stickwall_routes.py

@@ -0,0 +1,156 @@
+from typing import List, Optional
+
+from sqlalchemy.orm import Session
+from fastapi import APIRouter, Depends, HTTPException, status
+
+from src.utils.utils import get_db
+from src.utils.security import get_current_user
+from src.models.user_model import User
+from src.models.stickwall_model import StickWall
+from src.schemas.stickwall.stickwall_schema import (
+    StickWallCreate,
+    StickWallResponse,
+)
+
+stickwall_router = APIRouter(prefix="/stickwall", tags=["stickwall"])
+
+
+@stickwall_router.get("/", response_model=List[StickWallResponse])
+def list_notes(
+    color: Optional[str] = None,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    List all StickWall notes for the authenticated user.
+
+    Args:
+        color (str, optional): Hex color to filter notes.
+
+    Returns:
+        List[StickWallResponse]: List of StickWall notes.
+
+    Optional:
+        color (str): Hex color to filter notes.
+    """
+    query = db.query(StickWall).filter(StickWall.user_id == current_user.id)
+    if color:
+        query = query.filter(StickWall.color == color)
+    return query.all()
+
+
+@stickwall_router.post(
+    "/", response_model=StickWallResponse, status_code=status.HTTP_201_CREATED
+)
+def create_note(
+    note: StickWallCreate,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    Create a new StickWall note for the authenticated user.
+
+    Args:
+        note (StickWallCreate): Data for the new note (name, text, color).
+        db (Session): Database session.
+        current_user (User): Authenticated user.
+
+    Returns:
+        StickWallResponse: The created note.
+    """
+    new_note = StickWall(
+        user_id=current_user.id,
+        name=note.name,
+        text=note.text,
+        color=note.color,
+    )
+    db.add(new_note)
+    db.commit()
+    db.refresh(new_note)
+    return new_note
+
+
+@stickwall_router.get("/{note_id}", response_model=StickWallResponse)
+def get_note(
+    note_id: int,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    Get a specific StickWall note by ID for the authenticated user.
+
+    Args:
+        note_id (int): Note identifier.
+
+    Returns:
+        StickWallResponse: The requested note.
+    """
+    note = (
+        db.query(StickWall)
+        .filter(StickWall.id == note_id, StickWall.user_id == current_user.id)
+        .first()
+    )
+    if not note:
+        raise HTTPException(status_code=404, detail="Nota não encontrada.")
+    return note
+
+
+@stickwall_router.put("/{note_id}", response_model=StickWallResponse)
+def update_note(
+    note_id: int,
+    updated: StickWallCreate,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    Update a specific StickWall note for the authenticated user.
+
+    Args:
+        note_id (int): Note identifier.
+        updated (StickWallCreate): New data (name, text, color).
+
+    Returns:
+        StickWallResponse: The updated note.
+    """
+    note = (
+        db.query(StickWall)
+        .filter(StickWall.id == note_id, StickWall.user_id == current_user.id)
+        .first()
+    )
+    if not note:
+        raise HTTPException(status_code=404, detail="Nota não encontrada.")
+
+    note.name = updated.name
+    note.text = updated.text
+    note.color = updated.color
+
+    db.commit()
+    db.refresh(note)
+    return note
+
+
+@stickwall_router.delete("/{note_id}", status_code=status.HTTP_204_NO_CONTENT)
+def delete_note(
+    note_id: int,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    """
+    Delete a specific StickWall note for the authenticated user.
+
+    Args:
+        note_id (int): Note identifier.
+        
+    Returns:
+        None
+    """
+    note = (
+        db.query(StickWall)
+        .filter(StickWall.id == note_id, StickWall.user_id == current_user.id)
+        .first()
+    )
+    if not note:
+        raise HTTPException(status_code=404, detail="Nota não encontrada.")
+
+    db.delete(note)
+    db.commit()

src/schemas/stickwall/__init__.py

@@ -0,0 +1,46 @@
+from typing import Optional
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class StickWallBase(BaseModel):
+    """
+    Base schema for StickWall notes.
+
+    Attributes:
+        name (str): Note title.
+        text (str): Note content.
+        color (str): Hex color (e.g. "#FFF176").
+    """
+    name: str
+    text: str
+    color: str = Field(
+        default="#FFFF88",
+        description="Hex color code (e.g. #FFF176)",
+        pattern=r"^#[0-9A-Fa-f]{6}$",
+    )
+
+
+class StickWallCreate(StickWallBase):
+    """
+    Schema used for creating new StickWall notes.
+    """
+    pass
+
+
+class StickWallResponse(StickWallBase):
+    """
+    Schema used for API responses for StickWall notes.
+
+    Attributes:
+        id (int): Unique identifier.
+        created_at (datetime): Creation timestamp.
+        updated_at (datetime): Last update timestamp.
+    """
+    id: int
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True