# app/api/v1/vendor/content_pages.py """ Vendor Content Pages API Vendors can: - View their content pages (includes platform defaults) - Create/edit/delete their own content page overrides - Preview pages before publishing """ import logging from typing import List, Optional from fastapi import APIRouter, Depends, HTTPException, Query from pydantic import BaseModel, Field from sqlalchemy.orm import Session from app.api.deps import get_current_vendor_api, get_db from app.services.content_page_service import content_page_service from models.database.user import User router = APIRouter() logger = logging.getLogger(__name__) # ============================================================================ # REQUEST/RESPONSE SCHEMAS # ============================================================================ class VendorContentPageCreate(BaseModel): """Schema for creating a vendor content page.""" slug: str = Field(..., max_length=100, description="URL-safe identifier (about, faq, contact, etc.)") title: str = Field(..., max_length=200, description="Page title") content: str = Field(..., description="HTML or Markdown content") content_format: str = Field(default="html", description="Content format: html or markdown") meta_description: Optional[str] = Field(None, max_length=300, description="SEO meta description") meta_keywords: Optional[str] = Field(None, max_length=300, description="SEO keywords") is_published: bool = Field(default=False, description="Publish immediately") show_in_footer: bool = Field(default=True, description="Show in footer navigation") show_in_header: bool = Field(default=False, description="Show in header navigation") display_order: int = Field(default=0, description="Display order (lower = first)") class VendorContentPageUpdate(BaseModel): """Schema for updating a vendor content page.""" title: Optional[str] = Field(None, max_length=200) content: Optional[str] = None content_format: Optional[str] = None meta_description: Optional[str] = Field(None, max_length=300) meta_keywords: Optional[str] = Field(None, max_length=300) is_published: Optional[bool] = None show_in_footer: Optional[bool] = None show_in_header: Optional[bool] = None display_order: Optional[int] = None class ContentPageResponse(BaseModel): """Schema for content page response.""" id: int vendor_id: Optional[int] vendor_name: Optional[str] slug: str title: str content: str content_format: str meta_description: Optional[str] meta_keywords: Optional[str] is_published: bool published_at: Optional[str] display_order: int show_in_footer: bool show_in_header: bool is_platform_default: bool is_vendor_override: bool created_at: str updated_at: str created_by: Optional[int] updated_by: Optional[int] # ============================================================================ # VENDOR CONTENT PAGES # ============================================================================ @router.get("/", response_model=List[ContentPageResponse]) def list_vendor_pages( include_unpublished: bool = Query(False, description="Include draft pages"), current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ List all content pages available for this vendor. Returns vendor-specific overrides + platform defaults (vendor overrides take precedence). """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") pages = content_page_service.list_pages_for_vendor( db, vendor_id=current_user.vendor_id, include_unpublished=include_unpublished ) return [page.to_dict() for page in pages] @router.get("/overrides", response_model=List[ContentPageResponse]) def list_vendor_overrides( include_unpublished: bool = Query(False, description="Include draft pages"), current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ List only vendor-specific content pages (no platform defaults). Shows what the vendor has customized. """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") pages = content_page_service.list_all_vendor_pages( db, vendor_id=current_user.vendor_id, include_unpublished=include_unpublished ) return [page.to_dict() for page in pages] @router.get("/{slug}", response_model=ContentPageResponse) def get_page( slug: str, include_unpublished: bool = Query(False, description="Include draft pages"), current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ Get a specific content page by slug. Returns vendor override if exists, otherwise platform default. """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") page = content_page_service.get_page_for_vendor( db, slug=slug, vendor_id=current_user.vendor_id, include_unpublished=include_unpublished ) if not page: raise HTTPException(status_code=404, detail=f"Content page not found: {slug}") return page.to_dict() @router.post("/", response_model=ContentPageResponse, status_code=201) def create_vendor_page( page_data: VendorContentPageCreate, current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ Create a vendor-specific content page override. This will be shown instead of the platform default for this vendor. """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") page = content_page_service.create_page( db, slug=page_data.slug, title=page_data.title, content=page_data.content, vendor_id=current_user.vendor_id, content_format=page_data.content_format, meta_description=page_data.meta_description, meta_keywords=page_data.meta_keywords, is_published=page_data.is_published, show_in_footer=page_data.show_in_footer, show_in_header=page_data.show_in_header, display_order=page_data.display_order, created_by=current_user.id ) return page.to_dict() @router.put("/{page_id}", response_model=ContentPageResponse) def update_vendor_page( page_id: int, page_data: VendorContentPageUpdate, current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ Update a vendor-specific content page. Can only update pages owned by this vendor. """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") # Verify ownership existing_page = content_page_service.get_page_by_id(db, page_id) if not existing_page: raise HTTPException(status_code=404, detail="Content page not found") if existing_page.vendor_id != current_user.vendor_id: raise HTTPException(status_code=403, detail="Cannot edit pages from other vendors") # Update page = content_page_service.update_page( db, page_id=page_id, title=page_data.title, content=page_data.content, content_format=page_data.content_format, meta_description=page_data.meta_description, meta_keywords=page_data.meta_keywords, is_published=page_data.is_published, show_in_footer=page_data.show_in_footer, show_in_header=page_data.show_in_header, display_order=page_data.display_order, updated_by=current_user.id ) return page.to_dict() @router.delete("/{page_id}", status_code=204) def delete_vendor_page( page_id: int, current_user: User = Depends(get_current_vendor_api), db: Session = Depends(get_db) ): """ Delete a vendor-specific content page. Can only delete pages owned by this vendor. After deletion, platform default will be shown (if exists). """ if not current_user.vendor_id: raise HTTPException(status_code=403, detail="User is not associated with a vendor") # Verify ownership existing_page = content_page_service.get_page_by_id(db, page_id) if not existing_page: raise HTTPException(status_code=404, detail="Content page not found") if existing_page.vendor_id != current_user.vendor_id: raise HTTPException(status_code=403, detail="Cannot delete pages from other vendors") # Delete content_page_service.delete_page(db, page_id) return None