feat(chat): add random public_id and fix users blocked route

- add chats.public_id random identifier with migration 0011
- expose public_id in chat API payloads
- use chat public_id in message search UI label
- fix users router order so /users/blocked no longer conflicts with /users/{user_id}

app/chats/models.py

@@ -6,6 +6,7 @@ from sqlalchemy import Boolean, DateTime, Enum as SAEnum, ForeignKey, String, Un
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from app.database.base import Base
+from app.utils.id_generator import generate_public_id
 
 if TYPE_CHECKING:
     from app.messages.models import Message
@@ -28,6 +29,7 @@ class Chat(Base):
     __tablename__ = "chats"
 
     id: Mapped[int] = mapped_column(primary_key=True, index=True)
+    public_id: Mapped[str] = mapped_column(String(24), unique=True, index=True, nullable=False, default=generate_public_id)
     type: Mapped[ChatType] = mapped_column(SAEnum(ChatType), nullable=False, index=True)
     title: Mapped[str | None] = mapped_column(String(255), nullable=True)
     handle: Mapped[str | None] = mapped_column(String(64), nullable=True, unique=True, index=True)

app/chats/schemas.py

@@ -9,6 +9,7 @@ class ChatRead(BaseModel):
     model_config = ConfigDict(from_attributes=True)
 
     id: int
+    public_id: str
     type: ChatType
     title: str | None = None
     display_title: str | None = None

app/chats/service.py

@@ -66,6 +66,7 @@ async def serialize_chat_for_user(db: AsyncSession, *, user_id: int, chat: Chat)
     return ChatRead.model_validate(
         {
             "id": chat.id,
+            "public_id": chat.public_id,
             "type": chat.type,
             "title": chat.title,
             "display_title": display_title,
@@ -375,6 +376,7 @@ async def discover_public_chats_for_user(db: AsyncSession, *, user_id: int, quer
         ChatDiscoverRead.model_validate(
             {
                 "id": chat.id,
+                "public_id": chat.public_id,
                 "type": chat.type,
                 "title": chat.title,
                 "handle": chat.handle,

app/users/router.py

@@ -41,14 +41,6 @@ async def search_users(
     return users
 
 
-@router.get("/{user_id}", response_model=UserRead)
-async def read_user(user_id: int, db: AsyncSession = Depends(get_db), _current_user: User = Depends(get_current_user)) -> UserRead:
-    user = await get_user_by_id(db, user_id)
-    if not user:
-        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="User not found")
-    return user
-
-
 @router.put("/profile", response_model=UserRead)
 async def update_profile(
     payload: UserProfileUpdate,
@@ -102,3 +94,11 @@ async def unblock_user_endpoint(
     if user_id == current_user.id:
         return
     await unblock_user(db, user_id=current_user.id, blocked_user_id=user_id)
+
+
+@router.get("/{user_id}", response_model=UserRead)
+async def read_user(user_id: int, db: AsyncSession = Depends(get_db), _current_user: User = Depends(get_current_user)) -> UserRead:
+    user = await get_user_by_id(db, user_id)
+    if not user:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="User not found")
+    return user

app/utils/id_generator.py

@@ -0,0 +1,9 @@
+import secrets
+import string
+
+
+_ALPHABET = string.ascii_letters + string.digits
+
+
+def generate_public_id(length: int = 12) -> str:
+    return "".join(secrets.choice(_ALPHABET) for _ in range(length))