Initial commit: PESCO NCR system
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>
This commit is contained in:
ang3l12
225
backend/alembic/versions/0001_initial_schema.py
Normal file
225
backend/alembic/versions/0001_initial_schema.py
Normal file
@@ -0,0 +1,225 @@
|
||||
"""initial schema
|
||||
|
||||
Revision ID: 0001
|
||||
Revises:
|
||||
Create Date: 2026-07-13
|
||||
|
||||
"""
|
||||
from alembic import op
|
||||
import sqlalchemy as sa
|
||||
|
||||
revision = "0001"
|
||||
down_revision = None
|
||||
branch_labels = None
|
||||
depends_on = None
|
||||
|
||||
MYSQL = {"mysql_charset": "utf8mb4", "mysql_collate": "utf8mb4_unicode_ci"}
|
||||
|
||||
|
||||
def upgrade() -> None:
|
||||
op.create_table(
|
||||
"users",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column("entra_oid", sa.String(64), nullable=True, unique=True),
|
||||
sa.Column("email", sa.String(255), nullable=False, unique=True, index=True),
|
||||
sa.Column("display_name", sa.String(255), nullable=False),
|
||||
sa.Column("employee_id", sa.String(64), nullable=True),
|
||||
sa.Column("is_active", sa.Boolean(), nullable=False, server_default=sa.text("1")),
|
||||
sa.Column("created_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("last_login_at", sa.DateTime(), nullable=True),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"user_roles",
|
||||
sa.Column(
|
||||
"user_id",
|
||||
sa.Integer(),
|
||||
sa.ForeignKey("users.id", ondelete="CASCADE"),
|
||||
primary_key=True,
|
||||
),
|
||||
sa.Column("role", sa.String(40), primary_key=True),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"departments",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column("name", sa.String(100), nullable=False, unique=True),
|
||||
sa.Column("is_active", sa.Boolean(), nullable=False, server_default=sa.text("1")),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"deviation_categories",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column("name", sa.String(100), nullable=False, unique=True),
|
||||
sa.Column("is_active", sa.Boolean(), nullable=False, server_default=sa.text("1")),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"ncr_sequences",
|
||||
sa.Column("year", sa.Integer(), primary_key=True, autoincrement=False),
|
||||
sa.Column("last_seq", sa.Integer(), nullable=False, server_default=sa.text("0")),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"ncrs",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column("ncr_number", sa.String(20), nullable=False),
|
||||
sa.Column("ncr_year", sa.Integer(), nullable=False),
|
||||
sa.Column("ncr_seq", sa.Integer(), nullable=False),
|
||||
sa.Column("job_number", sa.String(100), nullable=False),
|
||||
sa.Column("department_id", sa.Integer(), sa.ForeignKey("departments.id"), nullable=False),
|
||||
sa.Column(
|
||||
"deviation_category_id",
|
||||
sa.Integer(),
|
||||
sa.ForeignKey("deviation_categories.id"),
|
||||
nullable=False,
|
||||
),
|
||||
sa.Column(
|
||||
"disposition_authority_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False
|
||||
),
|
||||
sa.Column("deviation_detail", sa.Text(), nullable=False),
|
||||
sa.Column("requester_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False),
|
||||
sa.Column("stage", sa.String(30), nullable=False),
|
||||
sa.Column("stage_entered_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("created_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("updated_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("qc_authority", sa.String(255), nullable=True),
|
||||
sa.Column("work_order", sa.String(100), nullable=True),
|
||||
sa.Column("disposition_notes", sa.Text(), nullable=True),
|
||||
sa.Column("secondary_review_needed", sa.Boolean(), nullable=True),
|
||||
sa.Column(
|
||||
"operations_complete", sa.Boolean(), nullable=False, server_default=sa.text("0")
|
||||
),
|
||||
sa.Column("operations_completed_at", sa.DateTime(), nullable=True),
|
||||
sa.Column(
|
||||
"operations_completed_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=True
|
||||
),
|
||||
sa.Column("qc_approval", sa.String(10), nullable=True),
|
||||
sa.Column("inspection_notes", sa.Text(), nullable=True),
|
||||
sa.Column("qc_closed", sa.Boolean(), nullable=False, server_default=sa.text("0")),
|
||||
sa.Column("qc_closed_at", sa.DateTime(), nullable=True),
|
||||
sa.Column("qc_closed_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=True),
|
||||
sa.Column("labor_cost", sa.Numeric(12, 2), nullable=True),
|
||||
sa.Column("material_cost", sa.Numeric(12, 2), nullable=True),
|
||||
sa.Column("service_cost", sa.Numeric(12, 2), nullable=True),
|
||||
sa.Column("other_cost", sa.Numeric(12, 2), nullable=True),
|
||||
sa.Column("costing_completed_at", sa.DateTime(), nullable=True),
|
||||
sa.Column(
|
||||
"costing_completed_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=True
|
||||
),
|
||||
sa.Column("closed_at", sa.DateTime(), nullable=True),
|
||||
sa.Column("closed_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=True),
|
||||
sa.UniqueConstraint("ncr_number", name="uq_ncrs_ncr_number"),
|
||||
**MYSQL,
|
||||
)
|
||||
op.create_index("ix_ncrs_stage", "ncrs", ["stage"])
|
||||
op.create_index("ix_ncrs_job_number", "ncrs", ["job_number"])
|
||||
op.create_index("ix_ncrs_created_at", "ncrs", ["created_at"])
|
||||
|
||||
op.create_table(
|
||||
"ncr_secondary_assignees",
|
||||
sa.Column(
|
||||
"ncr_id", sa.Integer(), sa.ForeignKey("ncrs.id", ondelete="CASCADE"), primary_key=True
|
||||
),
|
||||
sa.Column("user_id", sa.Integer(), sa.ForeignKey("users.id"), primary_key=True),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"stage_transitions",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column(
|
||||
"ncr_id", sa.Integer(), sa.ForeignKey("ncrs.id", ondelete="CASCADE"), nullable=False
|
||||
),
|
||||
sa.Column("from_stage", sa.String(30), nullable=True),
|
||||
sa.Column("to_stage", sa.String(30), nullable=False),
|
||||
sa.Column("action", sa.String(40), nullable=False),
|
||||
sa.Column("acted_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False),
|
||||
sa.Column("acted_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("note", sa.Text(), nullable=True),
|
||||
**MYSQL,
|
||||
)
|
||||
op.create_index("ix_stage_transitions_ncr", "stage_transitions", ["ncr_id", "acted_at"])
|
||||
|
||||
op.create_table(
|
||||
"job_info",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column(
|
||||
"ncr_id",
|
||||
sa.Integer(),
|
||||
sa.ForeignKey("ncrs.id", ondelete="CASCADE"),
|
||||
nullable=False,
|
||||
unique=True,
|
||||
),
|
||||
sa.Column("part_id", sa.String(30), nullable=True),
|
||||
sa.Column("part_description", sa.String(255), nullable=True),
|
||||
sa.Column("customer_name", sa.String(100), nullable=True),
|
||||
sa.Column("work_order_status", sa.String(20), nullable=True),
|
||||
sa.Column("source", sa.String(20), nullable=False),
|
||||
sa.Column("fetched_at", sa.DateTime(), nullable=False),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"attachments",
|
||||
sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
|
||||
sa.Column(
|
||||
"ncr_id", sa.Integer(), sa.ForeignKey("ncrs.id", ondelete="CASCADE"), nullable=False
|
||||
),
|
||||
sa.Column("original_filename", sa.String(255), nullable=False),
|
||||
sa.Column("stored_path", sa.String(300), nullable=False, unique=True),
|
||||
sa.Column("content_type", sa.String(100), nullable=False),
|
||||
sa.Column("size_bytes", sa.BigInteger(), nullable=False),
|
||||
sa.Column("is_image", sa.Boolean(), nullable=False, server_default=sa.text("0")),
|
||||
sa.Column("uploaded_by_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False),
|
||||
sa.Column("uploaded_at", sa.DateTime(), nullable=False),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
op.create_table(
|
||||
"audit_log",
|
||||
sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True),
|
||||
sa.Column(
|
||||
"ncr_id", sa.Integer(), sa.ForeignKey("ncrs.id", ondelete="SET NULL"), nullable=True
|
||||
),
|
||||
sa.Column("user_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False),
|
||||
sa.Column("created_at", sa.DateTime(), nullable=False),
|
||||
sa.Column("action", sa.String(40), nullable=False),
|
||||
sa.Column("field_name", sa.String(100), nullable=True),
|
||||
sa.Column("old_value", sa.Text(), nullable=True),
|
||||
sa.Column("new_value", sa.Text(), nullable=True),
|
||||
sa.Column("detail", sa.String(500), nullable=True),
|
||||
**MYSQL,
|
||||
)
|
||||
op.create_index("ix_audit_log_ncr", "audit_log", ["ncr_id", "created_at"])
|
||||
op.create_index("ix_audit_log_created_at", "audit_log", ["created_at"])
|
||||
|
||||
op.create_table(
|
||||
"app_settings",
|
||||
sa.Column("key", sa.String(100), primary_key=True),
|
||||
sa.Column("value", sa.String(500), nullable=False),
|
||||
**MYSQL,
|
||||
)
|
||||
|
||||
|
||||
def downgrade() -> None:
|
||||
for table in (
|
||||
"app_settings",
|
||||
"audit_log",
|
||||
"attachments",
|
||||
"job_info",
|
||||
"stage_transitions",
|
||||
"ncr_secondary_assignees",
|
||||
"ncrs",
|
||||
"ncr_sequences",
|
||||
"deviation_categories",
|
||||
"departments",
|
||||
"user_roles",
|
||||
"users",
|
||||
):
|
||||
op.drop_table(table)
|
||||
129
backend/alembic/versions/0002_reporting_views.py
Normal file
129
backend/alembic/versions/0002_reporting_views.py
Normal file
@@ -0,0 +1,129 @@
|
||||
"""read-only flattened reporting views for Power BI
|
||||
|
||||
Revision ID: 0002
|
||||
Revises: 0001
|
||||
Create Date: 2026-07-13
|
||||
|
||||
The powerbi_ro MySQL user (created by db/init/01-powerbi-user.sh) has SELECT
|
||||
on exactly these three views and nothing else.
|
||||
"""
|
||||
from alembic import op
|
||||
|
||||
revision = "0002"
|
||||
down_revision = "0001"
|
||||
branch_labels = None
|
||||
depends_on = None
|
||||
|
||||
VW_NCR_FULL = """
|
||||
CREATE OR REPLACE VIEW vw_ncr_full AS
|
||||
SELECT
|
||||
n.id AS ncr_id,
|
||||
n.ncr_number,
|
||||
n.ncr_year,
|
||||
n.ncr_seq,
|
||||
n.created_at,
|
||||
n.job_number,
|
||||
d.name AS department,
|
||||
dc.name AS deviation_category,
|
||||
req.display_name AS requester,
|
||||
req.email AS requester_email,
|
||||
da.display_name AS disposition_authority,
|
||||
n.stage,
|
||||
n.stage_entered_at,
|
||||
DATEDIFF(UTC_TIMESTAMP(), n.stage_entered_at) AS days_in_stage,
|
||||
n.deviation_detail,
|
||||
n.qc_authority,
|
||||
n.work_order,
|
||||
n.disposition_notes,
|
||||
n.secondary_review_needed,
|
||||
(SELECT GROUP_CONCAT(u2.display_name ORDER BY u2.display_name SEPARATOR '; ')
|
||||
FROM ncr_secondary_assignees sa2
|
||||
JOIN users u2 ON u2.id = sa2.user_id
|
||||
WHERE sa2.ncr_id = n.id) AS secondary_authorities,
|
||||
n.operations_complete,
|
||||
n.operations_completed_at,
|
||||
opu.display_name AS operations_completed_by,
|
||||
n.qc_approval,
|
||||
n.inspection_notes,
|
||||
n.qc_closed,
|
||||
n.qc_closed_at,
|
||||
qcu.display_name AS qc_closed_by,
|
||||
n.labor_cost,
|
||||
n.material_cost,
|
||||
n.service_cost,
|
||||
n.other_cost,
|
||||
COALESCE(n.labor_cost, 0) + COALESCE(n.material_cost, 0)
|
||||
+ COALESCE(n.service_cost, 0) + COALESCE(n.other_cost, 0) AS total_cost,
|
||||
n.costing_completed_at,
|
||||
n.closed_at,
|
||||
clu.display_name AS closed_by,
|
||||
ji.part_id,
|
||||
ji.part_description,
|
||||
ji.customer_name,
|
||||
ji.work_order_status,
|
||||
(SELECT COUNT(*) FROM attachments a WHERE a.ncr_id = n.id) AS attachment_count
|
||||
FROM ncrs n
|
||||
JOIN departments d ON d.id = n.department_id
|
||||
JOIN deviation_categories dc ON dc.id = n.deviation_category_id
|
||||
JOIN users req ON req.id = n.requester_id
|
||||
JOIN users da ON da.id = n.disposition_authority_id
|
||||
LEFT JOIN users opu ON opu.id = n.operations_completed_by_id
|
||||
LEFT JOIN users qcu ON qcu.id = n.qc_closed_by_id
|
||||
LEFT JOIN users clu ON clu.id = n.closed_by_id
|
||||
LEFT JOIN job_info ji ON ji.ncr_id = n.id
|
||||
"""
|
||||
|
||||
VW_NCR_STAGE_HISTORY = """
|
||||
CREATE OR REPLACE VIEW vw_ncr_stage_history AS
|
||||
SELECT
|
||||
t.id AS transition_id,
|
||||
t.ncr_id,
|
||||
n.ncr_number,
|
||||
n.job_number,
|
||||
t.from_stage,
|
||||
t.to_stage,
|
||||
t.action,
|
||||
t.acted_at,
|
||||
u.display_name AS acted_by,
|
||||
u.email AS acted_by_email,
|
||||
t.note
|
||||
FROM stage_transitions t
|
||||
JOIN ncrs n ON n.id = t.ncr_id
|
||||
JOIN users u ON u.id = t.acted_by_id
|
||||
"""
|
||||
|
||||
VW_NCR_COSTS = """
|
||||
CREATE OR REPLACE VIEW vw_ncr_costs AS
|
||||
SELECT
|
||||
n.id AS ncr_id,
|
||||
n.ncr_number,
|
||||
n.ncr_year,
|
||||
n.job_number,
|
||||
d.name AS department,
|
||||
dc.name AS deviation_category,
|
||||
n.created_at,
|
||||
n.closed_at,
|
||||
n.stage,
|
||||
n.labor_cost,
|
||||
n.material_cost,
|
||||
n.service_cost,
|
||||
n.other_cost,
|
||||
COALESCE(n.labor_cost, 0) + COALESCE(n.material_cost, 0)
|
||||
+ COALESCE(n.service_cost, 0) + COALESCE(n.other_cost, 0) AS total_cost
|
||||
FROM ncrs n
|
||||
JOIN departments d ON d.id = n.department_id
|
||||
JOIN deviation_categories dc ON dc.id = n.deviation_category_id
|
||||
WHERE n.costing_completed_at IS NOT NULL
|
||||
"""
|
||||
|
||||
|
||||
def upgrade() -> None:
|
||||
op.execute(VW_NCR_FULL)
|
||||
op.execute(VW_NCR_STAGE_HISTORY)
|
||||
op.execute(VW_NCR_COSTS)
|
||||
|
||||
|
||||
def downgrade() -> None:
|
||||
op.execute("DROP VIEW IF EXISTS vw_ncr_costs")
|
||||
op.execute("DROP VIEW IF EXISTS vw_ncr_stage_history")
|
||||
op.execute("DROP VIEW IF EXISTS vw_ncr_full")
|
||||
Reference in New Issue
Block a user