This commit is contained in:
Shubhankar45
2026-11-13 12:14:55 +00:00
commit 53dbfa976b
191 changed files with 12074 additions and 0 deletions
+25
View File
@@ -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",
]
+21
View File
@@ -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))
+26
View File
@@ -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
)
+92
View File
@@ -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"))
+63
View File
@@ -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")
+48
View File
@@ -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,
)
+89
View File
@@ -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")