vinindkoeb/app/models/purchase_round.py
carsten 34ed5c28d7 Add Postal sending, "annoncér runde" action, and MailLog (task 7b)
POST /purchase-rounds/{id}/announce renders the route's round_announced
MailTemplate with simple {{variable}} substitution (app/services/
mail_rendering.py) for every active participant on the route, sends
via Postal's real HTTP API (app/services/postal.py — request/response
shapes verified directly against docs.postalserver.io, not guessed),
and records one MailLog row per attempt (sent/failed, Postal's
message id + token for the future webhook in 7c, denormalized
rendered_subject so the log reflects what was actually sent even if
the template changes later). A failed send for one participant doesn't
abort the rest — each attempt is isolated and committed individually.

Route gained sender_name/sender_email in 7a; both are now populated
for the real route from the historical emails ("Finn Gram - Fælles
Vinindkøb <finn@vinindkoeb.dk>") directly in the DB, since there's no
Route CRUD API yet.

Verified end-to-end against the real Postal instance: a real test
email was sent and received via an isolated throwaway Organization/
Route/Participant/PurchaseRound/MailTemplate sandbox (never the real
route's 308 participants), MailLog captured the correct Postal message
id/token, and a temporarily-invalid API key produced a clean
sent:0/failed:1 result with Postal's actual error message stored,
not a 500. All test data removed afterward; real route/participant
data confirmed untouched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-28 20:16:04 +02:00

87 lines
2.8 KiB
Python

from datetime import datetime
from decimal import Decimal
from enum import Enum
from typing import TYPE_CHECKING, List, Optional
from sqlalchemy import CheckConstraint, Column
from sqlalchemy import Enum as SAEnum
from sqlmodel import Field, Relationship, SQLModel
if TYPE_CHECKING:
from app.models.mail_log import MailLog
from app.models.order import Order
from app.models.route import Route
from app.models.wine_offering import WineOffering
class PurchaseRoundStatus(str, Enum):
DRAFT = "draft"
OPEN = "open"
CLOSED = "closed"
class PurchaseRoundBase(SQLModel):
name: str
status: PurchaseRoundStatus = Field(
default=PurchaseRoundStatus.DRAFT,
sa_column=Column(
SAEnum(
PurchaseRoundStatus,
name="purchase_round_status",
native_enum=False,
values_callable=lambda enum_cls: [member.value for member in enum_cls],
),
nullable=False,
),
)
opens_at: Optional[datetime] = Field(default=None)
order_deadline_at: Optional[datetime] = Field(default=None)
pickup_at: Optional[datetime] = Field(default=None)
eur_dkk_rate: Optional[Decimal] = Field(default=None, max_digits=10, decimal_places=4)
intro_text: Optional[str] = Field(default=None)
pickup_info_text: Optional[str] = Field(default=None)
class PurchaseRound(PurchaseRoundBase, table=True):
__tablename__ = "purchase_round"
__table_args__ = (
CheckConstraint(
"status = 'draft' OR "
"(opens_at IS NOT NULL AND order_deadline_at IS NOT NULL AND pickup_at IS NOT NULL)",
name="ck_purchase_round_dates_required_unless_draft",
),
)
id: Optional[int] = Field(default=None, primary_key=True)
route_id: int = Field(foreign_key="route.id", ondelete="CASCADE")
route: "Route" = Relationship(back_populates="purchase_rounds")
wine_offerings: List["WineOffering"] = Relationship(
back_populates="purchase_round", sa_relationship_kwargs={"cascade": "all, delete-orphan"}
)
orders: List["Order"] = Relationship(
back_populates="purchase_round", sa_relationship_kwargs={"cascade": "all, delete-orphan"}
)
mail_logs: List["MailLog"] = Relationship(
back_populates="purchase_round", sa_relationship_kwargs={"cascade": "all, delete-orphan"}
)
class PurchaseRoundCreate(PurchaseRoundBase):
route_id: int
class PurchaseRoundUpdate(SQLModel):
name: Optional[str] = None
status: Optional[PurchaseRoundStatus] = None
opens_at: Optional[datetime] = None
order_deadline_at: Optional[datetime] = None
pickup_at: Optional[datetime] = None
eur_dkk_rate: Optional[Decimal] = None
intro_text: Optional[str] = None
pickup_info_text: Optional[str] = None
class PurchaseRoundPublic(PurchaseRoundBase):
id: int
route_id: int