-
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
from app.models.admin import Admin
|
||||
from app.models.base import Base
|
||||
from app.models.content import ContactMessage, Service, SiteContent, Subscriber, Testimonial
|
||||
from app.models.enquiry import Enquiry, EnquiryNote
|
||||
from app.models.enums import AdminRole, EnquiryStatus, ProjectCategory, ProjectStatus, PropertyType
|
||||
from app.models.project import Project, ProjectImage
|
||||
|
||||
__all__ = [
|
||||
"Admin",
|
||||
"AdminRole",
|
||||
"Base",
|
||||
"ContactMessage",
|
||||
"Enquiry",
|
||||
"EnquiryNote",
|
||||
"EnquiryStatus",
|
||||
"Project",
|
||||
"ProjectCategory",
|
||||
"ProjectImage",
|
||||
"ProjectStatus",
|
||||
"PropertyType",
|
||||
"Service",
|
||||
"SiteContent",
|
||||
"Subscriber",
|
||||
"Testimonial",
|
||||
]
|
||||
@@ -0,0 +1,21 @@
|
||||
from datetime import datetime
|
||||
|
||||
from sqlalchemy import Boolean, DateTime, String, true
|
||||
from sqlalchemy.orm import Mapped, mapped_column
|
||||
|
||||
from app.models.base import Base, TimestampMixin
|
||||
from app.models.enums import AdminRole, db_enum
|
||||
|
||||
|
||||
class Admin(TimestampMixin, Base):
|
||||
__tablename__ = "admins"
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
email: Mapped[str] = mapped_column(String(255), unique=True, index=True)
|
||||
full_name: Mapped[str] = mapped_column(String(150))
|
||||
hashed_password: Mapped[str] = mapped_column(String(255))
|
||||
role: Mapped[AdminRole] = mapped_column(
|
||||
db_enum(AdminRole, "admin_role"), default=AdminRole.ADMIN, server_default=AdminRole.ADMIN.value
|
||||
)
|
||||
is_active: Mapped[bool] = mapped_column(Boolean, default=True, server_default=true())
|
||||
last_login_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
|
||||
@@ -0,0 +1,26 @@
|
||||
from datetime import datetime
|
||||
|
||||
from sqlalchemy import DateTime, MetaData, func
|
||||
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
|
||||
|
||||
# Deterministic constraint names so Alembic migrations are stable.
|
||||
NAMING_CONVENTION = {
|
||||
"ix": "ix_%(column_0_label)s",
|
||||
"uq": "uq_%(table_name)s_%(column_0_name)s",
|
||||
"ck": "ck_%(table_name)s_%(constraint_name)s",
|
||||
"fk": "fk_%(table_name)s_%(column_0_name)s_%(referred_table_name)s",
|
||||
"pk": "pk_%(table_name)s",
|
||||
}
|
||||
|
||||
|
||||
class Base(DeclarativeBase):
|
||||
metadata = MetaData(naming_convention=NAMING_CONVENTION)
|
||||
|
||||
|
||||
class TimestampMixin:
|
||||
created_at: Mapped[datetime] = mapped_column(
|
||||
DateTime(timezone=True), server_default=func.now(), nullable=False
|
||||
)
|
||||
updated_at: Mapped[datetime] = mapped_column(
|
||||
DateTime(timezone=True), server_default=func.now(), onupdate=func.now(), nullable=False
|
||||
)
|
||||
@@ -0,0 +1,92 @@
|
||||
from sqlalchemy import (
|
||||
Boolean,
|
||||
CheckConstraint,
|
||||
ForeignKey,
|
||||
Integer,
|
||||
SmallInteger,
|
||||
String,
|
||||
Text,
|
||||
false,
|
||||
true,
|
||||
)
|
||||
from sqlalchemy.dialects.postgresql import JSONB
|
||||
from sqlalchemy.orm import Mapped, mapped_column
|
||||
|
||||
from app.models.base import Base, TimestampMixin
|
||||
|
||||
|
||||
class Service(TimestampMixin, Base):
|
||||
__tablename__ = "services"
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
title: Mapped[str] = mapped_column(String(150))
|
||||
slug: Mapped[str] = mapped_column(String(170), unique=True, index=True)
|
||||
short_description: Mapped[str | None] = mapped_column(String(300))
|
||||
description: Mapped[str | None] = mapped_column(Text)
|
||||
icon: Mapped[str | None] = mapped_column(String(60)) # optional icon name for the frontend
|
||||
sort_order: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
|
||||
is_published: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false())
|
||||
|
||||
# Single watermarked image (paths relative to UPLOAD_DIR)
|
||||
image_original_path: Mapped[str | None] = mapped_column(String(300))
|
||||
image_watermarked_path: Mapped[str | None] = mapped_column(String(300))
|
||||
image_thumbnail_path: Mapped[str | None] = mapped_column(String(300))
|
||||
|
||||
|
||||
class Testimonial(TimestampMixin, Base):
|
||||
__tablename__ = "testimonials"
|
||||
__table_args__ = (CheckConstraint("rating BETWEEN 1 AND 5", name="rating_range"),)
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
customer_name: Mapped[str] = mapped_column(String(150))
|
||||
designation: Mapped[str | None] = mapped_column(String(150))
|
||||
location: Mapped[str | None] = mapped_column(String(150))
|
||||
content: Mapped[str | None] = mapped_column(Text) # quote; optional for video-only reviews
|
||||
video_url: Mapped[str | None] = mapped_column(String(500)) # YouTube link or direct .mp4 URL
|
||||
rating: Mapped[int] = mapped_column(SmallInteger, default=5, server_default="5")
|
||||
project_id: Mapped[int | None] = mapped_column(
|
||||
ForeignKey("projects.id", ondelete="SET NULL"), index=True
|
||||
)
|
||||
sort_order: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
|
||||
is_published: Mapped[bool] = mapped_column(Boolean, default=True, server_default=true())
|
||||
|
||||
# Optional video still / customer photo (watermarked like every admin upload)
|
||||
image_original_path: Mapped[str | None] = mapped_column(String(300))
|
||||
image_watermarked_path: Mapped[str | None] = mapped_column(String(300))
|
||||
image_thumbnail_path: Mapped[str | None] = mapped_column(String(300))
|
||||
|
||||
|
||||
class Subscriber(TimestampMixin, Base):
|
||||
"""Footer newsletter sign-ups."""
|
||||
|
||||
__tablename__ = "subscribers"
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
email: Mapped[str] = mapped_column(String(255), unique=True, index=True)
|
||||
is_active: Mapped[bool] = mapped_column(Boolean, default=True, server_default=true())
|
||||
|
||||
|
||||
class ContactMessage(TimestampMixin, Base):
|
||||
__tablename__ = "contact_messages"
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
name: Mapped[str] = mapped_column(String(150))
|
||||
email: Mapped[str] = mapped_column(String(255), index=True)
|
||||
phone: Mapped[str | None] = mapped_column(String(20))
|
||||
subject: Mapped[str | None] = mapped_column(String(200))
|
||||
message: Mapped[str] = mapped_column(Text)
|
||||
is_read: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false(), index=True)
|
||||
|
||||
|
||||
class SiteContent(TimestampMixin, Base):
|
||||
"""Key/value blocks of editable copy (hero text, about text, stats, contact info...).
|
||||
|
||||
The frontend decides which keys exist; values are JSON so each block can hold
|
||||
the exact fields its Figma section needs without schema changes.
|
||||
"""
|
||||
|
||||
__tablename__ = "site_content"
|
||||
|
||||
key: Mapped[str] = mapped_column(String(80), primary_key=True)
|
||||
value: Mapped[dict] = mapped_column(JSONB)
|
||||
updated_by_id: Mapped[int | None] = mapped_column(ForeignKey("admins.id", ondelete="SET NULL"))
|
||||
@@ -0,0 +1,63 @@
|
||||
from decimal import Decimal
|
||||
from typing import TYPE_CHECKING
|
||||
|
||||
from sqlalchemy import CheckConstraint, ForeignKey, Index, Numeric, String, Text
|
||||
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
||||
|
||||
from app.models.base import Base, TimestampMixin
|
||||
from app.models.enums import EnquiryStatus, PropertyType, db_enum
|
||||
|
||||
if TYPE_CHECKING:
|
||||
from app.models.admin import Admin
|
||||
|
||||
|
||||
class Enquiry(TimestampMixin, Base):
|
||||
__tablename__ = "enquiries"
|
||||
__table_args__ = (
|
||||
CheckConstraint("monthly_bill IS NULL OR monthly_bill >= 0", name="monthly_bill_non_negative"),
|
||||
CheckConstraint(
|
||||
"required_capacity_kw IS NULL OR required_capacity_kw > 0", name="capacity_positive"
|
||||
),
|
||||
Index("ix_enquiries_status_created_at", "status", "created_at"),
|
||||
)
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
name: Mapped[str] = mapped_column(String(150))
|
||||
phone: Mapped[str | None] = mapped_column(String(20), index=True) # null for calculator leads
|
||||
email: Mapped[str | None] = mapped_column(String(255), index=True)
|
||||
city: Mapped[str | None] = mapped_column(String(120))
|
||||
address: Mapped[str | None] = mapped_column(String(500))
|
||||
property_type: Mapped[PropertyType | None] = mapped_column(db_enum(PropertyType, "property_type"))
|
||||
monthly_bill: Mapped[Decimal | None] = mapped_column(Numeric(12, 2))
|
||||
required_capacity_kw: Mapped[Decimal | None] = mapped_column(Numeric(10, 2))
|
||||
message: Mapped[str | None] = mapped_column(Text)
|
||||
source: Mapped[str] = mapped_column(String(50), default="website", server_default="website")
|
||||
status: Mapped[EnquiryStatus] = mapped_column(
|
||||
db_enum(EnquiryStatus, "enquiry_status"),
|
||||
default=EnquiryStatus.NEW,
|
||||
server_default=EnquiryStatus.NEW.value,
|
||||
)
|
||||
|
||||
notes: Mapped[list["EnquiryNote"]] = relationship(
|
||||
back_populates="enquiry",
|
||||
cascade="all, delete-orphan",
|
||||
passive_deletes=True,
|
||||
order_by="EnquiryNote.created_at.desc()",
|
||||
)
|
||||
|
||||
|
||||
class EnquiryNote(TimestampMixin, Base):
|
||||
"""Internal notes added by admins; never exposed publicly."""
|
||||
|
||||
__tablename__ = "enquiry_notes"
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
enquiry_id: Mapped[int] = mapped_column(
|
||||
ForeignKey("enquiries.id", ondelete="CASCADE"), index=True
|
||||
)
|
||||
author_id: Mapped[int | None] = mapped_column(ForeignKey("admins.id", ondelete="SET NULL"))
|
||||
content: Mapped[str] = mapped_column(Text)
|
||||
|
||||
enquiry: Mapped[Enquiry] = relationship(back_populates="notes")
|
||||
author: Mapped["Admin | None"] = relationship("Admin", lazy="joined")
|
||||
|
||||
@@ -0,0 +1,48 @@
|
||||
import enum
|
||||
|
||||
from sqlalchemy import Enum as SAEnum
|
||||
|
||||
|
||||
class AdminRole(str, enum.Enum):
|
||||
SUPER_ADMIN = "super_admin" # everything, incl. managing admin accounts
|
||||
ADMIN = "admin" # all content + enquiries, incl. deletes
|
||||
EDITOR = "editor" # content (projects/services/testimonials/site content), read enquiries
|
||||
|
||||
|
||||
class EnquiryStatus(str, enum.Enum):
|
||||
NEW = "new"
|
||||
CONTACTED = "contacted"
|
||||
SITE_VISIT_SCHEDULED = "site_visit_scheduled"
|
||||
QUOTATION_SENT = "quotation_sent"
|
||||
CONVERTED = "converted"
|
||||
REJECTED = "rejected"
|
||||
|
||||
|
||||
class PropertyType(str, enum.Enum):
|
||||
RESIDENTIAL = "residential"
|
||||
COMMERCIAL = "commercial"
|
||||
INDUSTRIAL = "industrial"
|
||||
OTHER = "other"
|
||||
|
||||
|
||||
class ProjectCategory(str, enum.Enum):
|
||||
RESIDENTIAL = "residential"
|
||||
COMMERCIAL = "commercial"
|
||||
|
||||
|
||||
class ProjectStatus(str, enum.Enum):
|
||||
ONGOING = "ongoing"
|
||||
COMPLETED = "completed"
|
||||
|
||||
|
||||
def db_enum(enum_cls: type[enum.Enum], name: str) -> SAEnum:
|
||||
"""Portable enum stored as VARCHAR + CHECK constraint (easy to extend in migrations)."""
|
||||
return SAEnum(
|
||||
enum_cls,
|
||||
name=name,
|
||||
native_enum=False,
|
||||
create_constraint=True,
|
||||
length=32,
|
||||
values_callable=lambda e: [m.value for m in e],
|
||||
validate_strings=True,
|
||||
)
|
||||
@@ -0,0 +1,89 @@
|
||||
from datetime import date
|
||||
from decimal import Decimal
|
||||
|
||||
from sqlalchemy import (
|
||||
Boolean,
|
||||
CheckConstraint,
|
||||
Date,
|
||||
ForeignKey,
|
||||
Index,
|
||||
Integer,
|
||||
Numeric,
|
||||
String,
|
||||
Text,
|
||||
false,
|
||||
text,
|
||||
)
|
||||
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
||||
|
||||
from app.models.base import Base, TimestampMixin
|
||||
from app.models.enums import ProjectCategory, ProjectStatus, db_enum
|
||||
|
||||
|
||||
class Project(TimestampMixin, Base):
|
||||
__tablename__ = "projects"
|
||||
__table_args__ = (
|
||||
CheckConstraint("capacity_kw IS NULL OR capacity_kw > 0", name="capacity_positive"),
|
||||
Index("ix_projects_published_category", "is_published", "category"),
|
||||
)
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
title: Mapped[str] = mapped_column(String(200))
|
||||
slug: Mapped[str] = mapped_column(String(220), unique=True, index=True)
|
||||
category: Mapped[ProjectCategory] = mapped_column(db_enum(ProjectCategory, "project_category"))
|
||||
location: Mapped[str | None] = mapped_column(String(200))
|
||||
capacity_kw: Mapped[Decimal | None] = mapped_column(Numeric(10, 2))
|
||||
installation_date: Mapped[date | None] = mapped_column(Date)
|
||||
description: Mapped[str | None] = mapped_column(Text)
|
||||
status: Mapped[ProjectStatus] = mapped_column(
|
||||
db_enum(ProjectStatus, "project_status"),
|
||||
default=ProjectStatus.COMPLETED,
|
||||
server_default=ProjectStatus.COMPLETED.value,
|
||||
)
|
||||
is_published: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false())
|
||||
|
||||
images: Mapped[list["ProjectImage"]] = relationship(
|
||||
back_populates="project",
|
||||
cascade="all, delete-orphan",
|
||||
passive_deletes=True,
|
||||
order_by="(ProjectImage.sort_order, ProjectImage.id)",
|
||||
lazy="selectin",
|
||||
)
|
||||
|
||||
@property
|
||||
def featured_image(self) -> "ProjectImage | None":
|
||||
for img in self.images:
|
||||
if img.is_featured:
|
||||
return img
|
||||
return self.images[0] if self.images else None
|
||||
|
||||
|
||||
class ProjectImage(TimestampMixin, Base):
|
||||
__tablename__ = "project_images"
|
||||
__table_args__ = (
|
||||
# At most one featured image per project.
|
||||
Index(
|
||||
"uq_project_images_one_featured",
|
||||
"project_id",
|
||||
unique=True,
|
||||
postgresql_where=text("is_featured"),
|
||||
),
|
||||
CheckConstraint("file_size > 0", name="file_size_positive"),
|
||||
)
|
||||
|
||||
id: Mapped[int] = mapped_column(primary_key=True)
|
||||
project_id: Mapped[int] = mapped_column(ForeignKey("projects.id", ondelete="CASCADE"), index=True)
|
||||
original_filename: Mapped[str] = mapped_column(String(255))
|
||||
# Paths are relative to UPLOAD_DIR, e.g. "watermarked/3f2a....jpg"
|
||||
original_path: Mapped[str] = mapped_column(String(300))
|
||||
watermarked_path: Mapped[str] = mapped_column(String(300))
|
||||
thumbnail_path: Mapped[str] = mapped_column(String(300))
|
||||
mime_type: Mapped[str] = mapped_column(String(50))
|
||||
file_size: Mapped[int] = mapped_column(Integer)
|
||||
width: Mapped[int] = mapped_column(Integer)
|
||||
height: Mapped[int] = mapped_column(Integer)
|
||||
caption: Mapped[str | None] = mapped_column(String(300))
|
||||
sort_order: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
|
||||
is_featured: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false())
|
||||
|
||||
project: Mapped[Project] = relationship(back_populates="images")
|
||||
Reference in New Issue
Block a user