🔬 PATHOLOGY MUSEUM SPECIMENS — GROSS APPEARANCE

from reportlab.lib.pagesizes import A4
from reportlab.lib import colors
from reportlab.lib.units import cm, mm
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.platypus import (
    SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle,
    HRFlowable, KeepTogether, PageBreak
)
from reportlab.lib.enums import TA_CENTER, TA_LEFT
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont

# ── Colour palette ──────────────────────────────────────────────────────────
C_KIDNEY   = colors.HexColor('#C0392B')   # deep red
C_BLADDER  = colors.HexColor('#2471A3')   # blue
C_TESTIS   = colors.HexColor('#1E8449')   # green
C_GI       = colors.HexColor('#D35400')   # orange
C_GB       = colors.HexColor('#B7950B')   # gold
C_LIVER    = colors.HexColor('#6C3483')   # purple
C_TIPS     = colors.HexColor('#1A5276')   # dark navy

C_LIGHT_GREY  = colors.HexColor('#F4F6F7')
C_ROW_ALT     = colors.HexColor('#EBF5FB')
C_HEADER_TXT  = colors.white
C_DARK        = colors.HexColor('#17202A')

PAGE_W, PAGE_H = A4
MARGIN = 1.5 * cm

# ── Styles ───────────────────────────────────────────────────────────────────
styles = getSampleStyleSheet()

def make_style(name, **kwargs):
    return ParagraphStyle(name, **kwargs)

TITLE_STYLE = make_style('Title2',
    fontSize=20, leading=24, alignment=TA_CENTER,
    textColor=C_DARK, fontName='Helvetica-Bold', spaceAfter=4)

SUBTITLE_STYLE = make_style('Sub',
    fontSize=10, leading=14, alignment=TA_CENTER,
    textColor=colors.HexColor('#555555'), fontName='Helvetica', spaceAfter=2)

SECTION_STYLE = make_style('Section',
    fontSize=12, leading=15, textColor=C_HEADER_TXT,
    fontName='Helvetica-Bold', alignment=TA_LEFT)

SPEC_NAME_STYLE = make_style('SpecName',
    fontSize=9, leading=12, fontName='Helvetica-Bold',
    textColor=C_DARK)

SPEC_DESC_STYLE = make_style('SpecDesc',
    fontSize=8.5, leading=12, fontName='Helvetica',
    textColor=C_DARK)

KEYWORD_STYLE = make_style('Keyword',
    fontSize=8, leading=11, fontName='Helvetica-Bold',
    textColor=colors.HexColor('#C0392B'))

TIP_BODY_STYLE = make_style('TipBody',
    fontSize=8.5, leading=12, fontName='Helvetica',
    textColor=C_DARK)

STEP_STYLE = make_style('Step',
    fontSize=8.5, leading=12, fontName='Helvetica-Bold',
    textColor=C_DARK)

FOOTER_STYLE = make_style('Footer',
    fontSize=7, alignment=TA_CENTER,
    textColor=colors.HexColor('#888888'), fontName='Helvetica')

# ── Helper: section header ────────────────────────────────────────────────────
def section_header(text, color):
    data = [[Paragraph(text, SECTION_STYLE)]]
    t = Table(data, colWidths=[PAGE_W - 2*MARGIN])
    t.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,-1), color),
        ('TOPPADDING',    (0,0), (-1,-1), 6),
        ('BOTTOMPADDING', (0,0), (-1,-1), 6),
        ('LEFTPADDING',   (0,0), (-1,-1), 10),
        ('RIGHTPADDING',  (0,0), (-1,-1), 10),
        ('ROUNDEDCORNERS', [4,4,4,4]),
    ]))
    return t

# ── Helper: specimen table ────────────────────────────────────────────────────
def specimen_table(rows, accent_color):
    """rows = list of (specimen_name, gross_description, buzzword)"""
    col_widths = [4.5*cm, 10.5*cm, 3.8*cm]
    # Header row
    header = [
        Paragraph('Specimen', make_style('H', fontSize=8, fontName='Helvetica-Bold', textColor=C_HEADER_TXT)),
        Paragraph('Gross Appearance', make_style('H2', fontSize=8, fontName='Helvetica-Bold', textColor=C_HEADER_TXT)),
        Paragraph('Buzzword', make_style('H3', fontSize=8, fontName='Helvetica-Bold', textColor=C_HEADER_TXT)),
    ]
    table_data = [header]
    for i, (name, desc, buzz) in enumerate(rows):
        table_data.append([
            Paragraph(name, SPEC_NAME_STYLE),
            Paragraph(desc, SPEC_DESC_STYLE),
            Paragraph(f'<i>"{buzz}"</i>', KEYWORD_STYLE),
        ])

    light = colors.HexColor(_lighten_hex(accent_color.hexval() if hasattr(accent_color,'hexval') else accent_color.hexColor() if hasattr(accent_color,'hexColor') else '#888888', 0.88))

    ts = TableStyle([
        # Header
        ('BACKGROUND', (0,0), (-1,0), accent_color),
        ('FONTNAME',   (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE',   (0,0), (-1,0), 8),
        ('TEXTCOLOR',  (0,0), (-1,0), C_HEADER_TXT),
        # Alternating rows
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [C_LIGHT_GREY, C_ROW_ALT]),
        # Grid
        ('GRID',       (0,0), (-1,-1), 0.4, colors.HexColor('#CCCCCC')),
        ('LINEBELOW',  (0,0), (-1,0), 1.2, accent_color),
        # Padding
        ('TOPPADDING',    (0,0), (-1,-1), 4),
        ('BOTTOMPADDING', (0,0), (-1,-1), 4),
        ('LEFTPADDING',   (0,0), (-1,-1), 6),
        ('RIGHTPADDING',  (0,0), (-1,-1), 6),
        ('VALIGN',     (0,0), (-1,-1), 'TOP'),
    ])
    t = Table(table_data, colWidths=col_widths, repeatRows=1)
    t.setStyle(ts)
    return t

def _lighten_hex(hexstr, factor):
    """Not used - using predefined light colours instead."""
    return '#EBF5FB'

# ── DATA ─────────────────────────────────────────────────────────────────────

KIDNEY_ROWS = [
    ('Renal Cell Ca\n(Clear Cell)',
     'Spherical mass, upper pole. Cut surface: <b>variegated</b> - yellow (lipid), red-brown (haemorrhage), white (necrosis). Well-encapsulated.',
     'Multicolored / Variegated'),
    ('Wilms\' Tumor\n(Nephroblastoma)',
     'Large, well-encapsulated mass in child. Soft, <b>grey-white, fish-flesh</b>. Cystic areas. Compressed normal kidney at periphery.',
     'Fish-flesh, child\'s kidney'),
    ('Hydronephrosis',
     'Kidney grossly enlarged. Renal pelvis & calyces <b>massively dilated</b>. Cortex thinned to a rim. Parenchyma atrophied.',
     'Dilated pelvis, thinned cortex'),
    ('Polycystic Kidney\n(ADPKD)',
     'Both kidneys hugely enlarged (up to 4 kg). Entire parenchyma replaced by <b>innumerable cysts</b> - clear/straw fluid. Barely any normal tissue.',
     'Innumerable cysts'),
    ('Chronic\nPyelonephritis',
     'Small, contracted kidney. Irregular <b>U-shaped corticomedullary scars</b> with underlying blunted, clubbed calyces. Asymmetric.',
     'U-shaped scars, clubbed calyces'),
    ('Renal TB',
     '<b>Caseous (cheese-like) white necrosis</b> in cavities. Dystrophic calcification. End-stage: "putty kidney" - completely calcified.',
     'Putty kidney / Caseous necrosis'),
    ('Staghorn Calculus',
     'Stone <b>fills pelvis and calyces</b>, shaped like a stag\'s antlers. Associated hydronephrosis common.',
     'Stag\'s antler shape'),
]

BLADDER_ROWS = [
    ('TCC / Urothelial\nCarcinoma',
     '<b>Papillary frond-like</b> projections (low grade) OR flat, sessile, infiltrating mass (high grade). At trigone/lateral walls. Haemorrhagic surface.',
     'Papillary fronds or flat-infiltrating'),
    ('Chronic Cystitis',
     'Wall <b>thickened and trabeculated</b> (detrusor hypertrophy from obstruction). Mucosa congested, granular.',
     'Trabeculated wall'),
    ('Bladder Calculi',
     '<b>Smooth, laminated stones</b> free in lumen. Single large or multiple small. Associated mucosal inflammation.',
     'Laminated stones'),
    ('Carcinoma Bladder\n(Invasive)',
     'Large, <b>sessile infiltrating mass</b>, firm, grey-white. Invades muscle wall. Often necrotic surface. Trigone common site.',
     'Sessile infiltrating mass'),
]

TESTIS_ROWS = [
    ('Seminoma',
     'Enlarged testis, tunica intact early. Cut: <b>homogeneous cream/grey-white, lobulated</b>. Soft, fish-flesh. No haemorrhage or necrosis.',
     'Homogeneous cream-white'),
    ('Teratoma\n(Mature)',
     '<b>Multiloculated cyst</b> with cartilage, hair, sebaceous material. Heterogeneous cut surface. Mixed solid/cystic.',
     'Mixed cystic, cartilage, hair'),
    ('Embryonal\nCarcinoma',
     '<b>Variegated grey-white to tan</b> tumor with haemorrhage and necrosis. Less homogeneous than seminoma.',
     'Variegated with necrosis'),
    ('Testicular Torsion',
     'Testis <b>dark red-purple</b> (haemorrhagic infarction). Swollen, congested. Cord twisted above.',
     'Dark red-purple, hemorrhagic'),
    ('Cryptorchidism',
     '<b>Small, atrophic testis</b> in inguinal canal or abdomen. Firm, reduced size. ↑ risk malignancy.',
     'Atrophic testis, maldescended'),
]

GI_ROWS = [
    ('Ca Stomach\n(Ulcero-proliferative)',
     'Irregular mass, lesser curvature/antrum. <b>Everted, heaped-up edges</b> with necrotic floor - classic malignant ulcer appearance.',
     'Heaped-up everted edges'),
    ('Linitis Plastica\n(Diffuse Gastric Ca)',
     'Entire stomach contracted, rigid, <b>leather-bottle shaped</b>. Wall diffusely thickened. Lumen greatly reduced.',
     'Leather-bottle stomach'),
    ('Peptic Ulcer',
     '<b>Punched-out, clean-based</b> ulcer with regular, smooth, non-everted edges. Lesser curvature (stomach) or duodenal bulb.',
     'Punched-out, non-everted edges'),
    ('Ca Colon - Annular',
     '<b>Circumferential ring/napkin-ring</b> constriction. Common in left colon. Causes obstruction. Edges raised.',
     'Napkin-ring / Apple-core'),
    ('Ca Colon - Fungating',
     '<b>Cauliflower-like fungating mass</b> projecting into lumen. Common in right colon/caecum. Irregular, friable surface.',
     'Cauliflower mass'),
    ('Crohn\'s Disease',
     '<b>Skip lesions</b>, cobblestone mucosa, creeping fat on serosa. Fissure ulcers. Thickened wall. Transmural.',
     'Skip lesions, cobblestone'),
    ('Intestinal TB',
     '<b>Transverse/annular ulcers</b> encircling ileum (at ileocaecal junction). Healed → strictures. Serosal tubercles. Matted nodes.',
     'Transverse ulcers, strictures'),
    ('Intussusception',
     'Bowel <b>telescoped</b> into distal segment. Sausage-shaped mass. Oedematous, congested bowel.',
     'Sausage-shaped, telescoped'),
]

GB_ROWS = [
    ('Chronic Cholecystitis\n+ Gallstones',
     'GB wall <b>thickened and fibrotic</b>. Lumen has stones: cholesterol (yellow, faceted, crystalline) or pigment (small, black, amorphous). Mucosa pale.',
     'Thickened wall + stones'),
    ('Acute Cholecystitis',
     'GB <b>distended</b>, serosa red with fibrinous exudate. Wall oedematous. Purulent bile inside. Cystic duct obstructed.',
     'Distended, fibrinous serosa'),
    ('Ca Gallbladder',
     'Fundus most common. <b>Diffuse wall thickening</b> (flat type) OR polypoid/papillary mass. Grey-white, firm. Often associated stones.',
     'Diffuse thickening, fundus'),
    ('Mucocele of GB',
     'Grossly <b>distended GB filled with clear mucus</b>. Cystic duct obstructed by stone. No infection. Thin wall.',
     'Distended, clear mucus'),
    ('Empyema of GB',
     'Distended GB filled with <b>frank pus</b>. Extremely tender in life. Wall oedematous, congested.',
     'Pus-filled GB'),
    ('Strawberry GB',
     '<b>Yellow flecks</b> on pink/red mucosa (cholesterolosis - cholesterol deposits). Resembles skin of a strawberry.',
     'Yellow flecks = strawberry'),
]

LIVER_ROWS = [
    ('HCC',
     'Large <b>yellow-green (bile-stained)</b> or greenish-brown mass. Solitary/multinodular. Soft, necrotic centre. Often on cirrhotic background.',
     'Yellow-green, bile-stained'),
    ('Micronodular Cirrhosis\n(Alcoholic)',
     'Small <b>uniform nodules <3 mm</b>, thin fibrous bands. Surface finely granular ("hobnail liver"). Initially enlarged (fatty) → later shrunken.',
     'Hobnail liver'),
    ('Macronodular Cirrhosis\n(Post-viral)',
     '<b>Large nodules >3 mm</b>, broad fibrous bands. Liver firm, shrunken. Cut surface: irregular nodularity.',
     'Large nodules, broad fibrosis'),
    ('Nutmeg Liver\n(Chronic Congestion)',
     'Cut surface shows <b>alternating red (congested central veins) and yellow (periportal fat)</b> - resembles cut nutmeg. Right heart failure.',
     'Nutmeg pattern'),
    ('Fatty Liver\n(Steatosis)',
     '<b>Enlarged, soft, greasy, pale yellow</b>. Rounded edges. Floats in formalin. No nodularity.',
     'Greasy, pale yellow, floats'),
    ('Amoebic Liver Abscess',
     'Single large abscess, <b>right lobe</b>. Contents: <b>chocolate/anchovy sauce-coloured pus</b> (liquefied hepatocytes + RBCs). Shaggy walls.',
     'Anchovy sauce pus'),
    ('Hepatic Metastases',
     '<b>Multiple pale nodules</b>, both lobes. <b>Umbilicated centres</b> (central necrosis → central depression). "Cannon-ball" metastases.',
     'Umbilicated, cannon-ball'),
    ('Hydatid Cyst\n(Echinococcus)',
     'Large cyst, <b>right lobe</b>. Thick <b>laminated white wall</b> (endocyst). Daughter cysts inside. "Hydatid sand" (scolices).',
     'Laminated wall, daughter cysts'),
]

APPROACH_STEPS = [
    ('1', 'ORGAN', 'Identify which organ - size, shape, colour'),
    ('2', 'SURFACE', 'Smooth / nodular / granular / scarred / irregular'),
    ('3', 'CUT SURFACE', 'Colour, texture, any masses, cavities, necrosis'),
    ('4', 'ABNORMALITY', 'Location, size, edges, contents, walls'),
    ('5', 'DIAGNOSIS', 'State your diagnosis confidently'),
    ('6', 'BUZZWORD', 'Give the ONE classic distinguishing feature'),
]

# ── Page callbacks ────────────────────────────────────────────────────────────
def add_page_number(canvas, doc):
    canvas.saveState()
    canvas.setFont('Helvetica', 7)
    canvas.setFillColor(colors.HexColor('#888888'))
    canvas.drawCentredString(PAGE_W / 2, 0.7 * cm,
        f'Pathology Museum Specimen Reference  |  Page {doc.page}  |  Gross Appearance Quick Reference')
    # Top stripe
    canvas.setFillColor(C_DARK)
    canvas.rect(0, PAGE_H - 1*cm, PAGE_W, 1*cm, fill=1, stroke=0)
    canvas.setFillColor(colors.white)
    canvas.setFont('Helvetica-Bold', 9)
    canvas.drawCentredString(PAGE_W/2, PAGE_H - 0.65*cm,
        'PATHOLOGY MUSEUM SPECIMENS  |  GROSS / MACROSCOPIC APPEARANCE')
    canvas.restoreState()

# ── Build PDF ─────────────────────────────────────────────────────────────────
def build():
    out_path = '/tmp/workspace/museum-specimen-pdf/Museum_Specimen_Gross_Appearance.pdf'
    doc = SimpleDocTemplate(
        out_path,
        pagesize=A4,
        leftMargin=MARGIN, rightMargin=MARGIN,
        topMargin=1.4*cm, bottomMargin=1.4*cm,
        title='Pathology Museum Specimens - Gross Appearance',
        author='Orris Medical Reference',
    )

    story = []
    W = PAGE_W - 2*MARGIN

    # ── Cover block ──────────────────────────────────────────────────────────
    cover_data = [[
        Paragraph('🔬 Museum Specimen', TITLE_STYLE),
    ]]
    cover2 = [[
        Paragraph('GROSS / MACROSCOPIC APPEARANCE QUICK REFERENCE', make_style('Sub2',
            fontSize=11, alignment=TA_CENTER, fontName='Helvetica-Bold',
            textColor=C_DARK, spaceAfter=2)),
    ]]
    cover3 = [[
        Paragraph('Kidney · Bladder · Testis · GI · Gallbladder · Liver', SUBTITLE_STYLE),
    ]]
    for d in [cover_data, cover2, cover3]:
        t = Table(d, colWidths=[W])
        t.setStyle(TableStyle([
            ('ALIGN', (0,0), (-1,-1), 'CENTER'),
            ('BOTTOMPADDING', (0,0), (-1,-1), 2),
            ('TOPPADDING', (0,0), (-1,-1), 2),
        ]))
        story.append(t)

    story.append(HRFlowable(width=W, thickness=2, color=C_DARK, spaceAfter=8, spaceBefore=4))

    # ── Section builder helper ───────────────────────────────────────────────
    def add_section(icon, title, color, rows):
        story.append(Spacer(1, 6))
        story.append(section_header(f'{icon}  {title}', color))
        story.append(Spacer(1, 3))
        story.append(specimen_table(rows, color))

    # ── KIDNEY ───────────────────────────────────────────────────────────────
    add_section('🔴', 'KIDNEY', C_KIDNEY, KIDNEY_ROWS)

    # ── BLADDER ──────────────────────────────────────────────────────────────
    add_section('🔵', 'BLADDER', C_BLADDER, BLADDER_ROWS)

    # ── TESTIS ───────────────────────────────────────────────────────────────
    add_section('🟢', 'TESTIS', C_TESTIS, TESTIS_ROWS)

    story.append(PageBreak())

    # ── GI ───────────────────────────────────────────────────────────────────
    add_section('🟠', 'GASTROINTESTINAL TRACT (GI)', C_GI, GI_ROWS)

    # ── GB ───────────────────────────────────────────────────────────────────
    add_section('🟡', 'GALLBLADDER (GB)', C_GB, GB_ROWS)

    story.append(PageBreak())

    # ── LIVER ────────────────────────────────────────────────────────────────
    add_section('🟣', 'LIVER', C_LIVER, LIVER_ROWS)

    story.append(Spacer(1, 10))

    # ── Viva Approach Box ────────────────────────────────────────────────────
    story.append(section_header('📋  HOW TO APPROACH ANY MUSEUM SPECIMEN (Viva Formula)', C_TIPS))
    story.append(Spacer(1, 4))

    step_data = [['Step', 'Focus', 'What to Say']]
    for num, focus, desc in APPROACH_STEPS:
        step_data.append([
            Paragraph(f'<b>{num}</b>', make_style('SN', fontSize=9, fontName='Helvetica-Bold',
                textColor=C_TIPS, alignment=TA_CENTER)),
            Paragraph(f'<b>{focus}</b>', make_style('SF', fontSize=8.5, fontName='Helvetica-Bold',
                textColor=C_DARK)),
            Paragraph(desc, TIP_BODY_STYLE),
        ])

    st = Table(step_data, colWidths=[1.2*cm, 3.5*cm, W - 4.7*cm], repeatRows=1)
    st.setStyle(TableStyle([
        ('BACKGROUND',    (0,0), (-1,0), C_TIPS),
        ('TEXTCOLOR',     (0,0), (-1,0), C_HEADER_TXT),
        ('FONTNAME',      (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE',      (0,0), (-1,0), 8),
        ('ROWBACKGROUNDS',(0,1), (-1,-1), [C_LIGHT_GREY, C_ROW_ALT]),
        ('GRID',          (0,0), (-1,-1), 0.4, colors.HexColor('#CCCCCC')),
        ('TOPPADDING',    (0,0), (-1,-1), 4),
        ('BOTTOMPADDING', (0,0), (-1,-1), 4),
        ('LEFTPADDING',   (0,0), (-1,-1), 6),
        ('RIGHTPADDING',  (0,0), (-1,-1), 6),
        ('ALIGN',         (0,0), (0,-1), 'CENTER'),
        ('VALIGN',        (0,0), (-1,-1), 'MIDDLE'),
    ]))
    story.append(st)

    story.append(Spacer(1, 10))

    # ── Key Buzzwords Box ────────────────────────────────────────────────────
    story.append(section_header('⭐  EXAMINER FAVOURITE BUZZWORDS', C_DARK))
    story.append(Spacer(1, 4))

    buzzwords = [
        ('Renal Cell Carcinoma', '"Variegated / multicolored cut surface"', C_KIDNEY),
        ('Seminoma', '"Homogeneous cream-white fish-flesh"', C_TESTIS),
        ('Linitis Plastica', '"Leather-bottle stomach"', C_GI),
        ('Nutmeg Liver', '"Cut surface like a nutmeg"', C_LIVER),
        ('Amoebic Liver Abscess', '"Anchovy sauce / chocolate-coloured pus"', C_LIVER),
        ('Polycystic Kidney', '"Innumerable cysts, no normal parenchyma"', C_KIDNEY),
        ('Alcoholic Cirrhosis', '"Hobnail liver, micronodular"', C_LIVER),
        ('Gallbladder (Cholesterol)', '"Strawberry gallbladder"', C_GB),
        ('Wilms\' Tumor', '"Fish-flesh, well-encapsulated, child\'s kidney"', C_KIDNEY),
        ('Hydatid Cyst', '"Laminated white wall, daughter cysts, hydatid sand"', C_LIVER),
    ]

    bw_data = [['Specimen', 'Classic Examiner Buzzword']]
    for spec, bw, col in buzzwords:
        bw_data.append([
            Paragraph(f'<b>{spec}</b>', make_style('BS', fontSize=8.5, fontName='Helvetica-Bold', textColor=col)),
            Paragraph(f'<i>{bw}</i>', make_style('BD', fontSize=8.5, fontName='Helvetica', textColor=C_DARK)),
        ])

    bwt = Table(bw_data, colWidths=[5*cm, W - 5*cm], repeatRows=1)
    bwt.setStyle(TableStyle([
        ('BACKGROUND',    (0,0), (-1,0), C_DARK),
        ('TEXTCOLOR',     (0,0), (-1,0), C_HEADER_TXT),
        ('FONTNAME',      (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE',      (0,0), (-1,0), 8),
        ('ROWBACKGROUNDS',(0,1), (-1,-1), [C_LIGHT_GREY, colors.HexColor('#EAF4EA')]),
        ('GRID',          (0,0), (-1,-1), 0.4, colors.HexColor('#CCCCCC')),
        ('TOPPADDING',    (0,0), (-1,-1), 5),
        ('BOTTOMPADDING', (0,0), (-1,-1), 5),
        ('LEFTPADDING',   (0,0), (-1,-1), 8),
        ('RIGHTPADDING',  (0,0), (-1,-1), 8),
        ('VALIGN',        (0,0), (-1,-1), 'MIDDLE'),
    ]))
    story.append(bwt)

    story.append(Spacer(1, 8))
    story.append(Paragraph('Reference: Robbins & Cotran Pathologic Basis of Disease | Orris Medical Reference | July 2026', FOOTER_STYLE))

    doc.build(story, onFirstPage=add_page_number, onLaterPages=add_page_number)
    print(f'PDF saved to: {out_path}')
    return out_path

if __name__ == '__main__':
    build()