Implemented directory management and improved TravelDiary and Photo handling logic.

- Added `DirectoryManager` utility for consistent directory operations.
- Introduced directory name sanitization and uniqueness enforcement for `TravelDiary`.
- Updated `TravelDiaryService` with enhanced creation, update, and deletion workflows, including filesystem management.
- Improved `PhotoService` to hash files, copy photos to specific diary directories, and manage updates safely.
- Refined error handling and cascaded changes across related entities (e.g., `Entry` relationships).

src/pilgrim/models/travel_diary.py

@@ -1,14 +1,26 @@
 from typing import Any
 
-from sqlalchemy import Column, String, Integer
+from sqlalchemy import Column, Integer, String, UniqueConstraint
+from sqlalchemy.orm import relationship
 
-from ..database import Base
+from .. import database
 
-class TravelDiary(Base):
+
+class TravelDiary(database.Base):
     __tablename__ = "travel_diaries"
     id = Column(Integer, primary_key=True)
-    name = Column(String)
+    name = Column(String, nullable=False)
+    directory_name = Column(String, nullable=False, unique=True)
+    entries = relationship("Entry", back_populates="travel_diary", cascade="all, delete-orphan")
 
-    def __init__(self, name: str, **kw: Any):
+    __table_args__ = (
+        UniqueConstraint('directory_name', name='uq_travel_diary_directory_name'),
+    )
+
+    def __init__(self, name: str, directory_name: str = None, **kw: Any):
         super().__init__(**kw)
         self.name = name
+        self.directory_name = directory_name  # Será definido pelo service
+
+    def __repr__(self):
+        return f"<TravelDiary(id={self.id}, name='{self.name}', directory_name='{self.directory_name}')>"