Complete Non-Conformance Report system replacing the PowerApps/SharePoint prototype: FastAPI + SQLAlchemy 2 (async) + Alembic + MySQL 8 backend, React 18 + Vite + TypeScript + MUI frontend, Entra ID auth (MSAL / JWKS, group-gated), Microsoft Graph delegated Mail.Send notifications (OBO), six-stage workflow state machine with server-side enforcement, atomic NCR-YYYY-NNNN numbering, attachments with camera capture, immutable field-level audit trail, admin reopen, reports + CSV export, WeasyPrint PDF traveler, Power BI reporting views + read-only DB user, documented VISUAL ERP job-lookup stub, pytest suite (26 tests), docker-compose deployment. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
38 lines
1.6 KiB
Python
38 lines
1.6 KiB
Python
from datetime import datetime
|
|
|
|
from sqlalchemy import BigInteger, DateTime, ForeignKey, Index, Integer, String, Text
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from app.models.base import Base, utcnow
|
|
from app.models.user import User
|
|
|
|
|
|
class AuditLog(Base):
|
|
"""Immutable audit record. The application exposes no update or delete
|
|
path for these rows; one row per changed field (field_name null for
|
|
record-level events such as create/transition/attachment/reopen)."""
|
|
|
|
__tablename__ = "audit_log"
|
|
__table_args__ = (
|
|
Index("ix_audit_log_ncr", "ncr_id", "created_at"),
|
|
Index("ix_audit_log_created_at", "created_at"),
|
|
)
|
|
|
|
# BigInteger on MySQL; plain INTEGER on SQLite (required for autoincrement).
|
|
id: Mapped[int] = mapped_column(
|
|
BigInteger().with_variant(Integer, "sqlite"), primary_key=True, autoincrement=True
|
|
)
|
|
# Nullable so admin actions without an NCR (settings, role changes) are auditable too.
|
|
ncr_id: Mapped[int | None] = mapped_column(
|
|
ForeignKey("ncrs.id", ondelete="SET NULL"), nullable=True
|
|
)
|
|
user_id: Mapped[int] = mapped_column(ForeignKey("users.id"))
|
|
created_at: Mapped[datetime] = mapped_column(DateTime, default=utcnow)
|
|
action: Mapped[str] = mapped_column(String(40))
|
|
field_name: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
old_value: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
new_value: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
detail: Mapped[str | None] = mapped_column(String(500), nullable=True)
|
|
|
|
user: Mapped[User] = relationship(lazy="selectin")
|