#!/usr/bin/env python3
"""
Professional PDF Generator for TimeTrack Pro - Complete Version
Creates comprehensive technical documentation
"""

from reportlab.lib import colors
from reportlab.lib.pagesizes import letter
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import inch
from reportlab.lib.enums import TA_LEFT, TA_CENTER, TA_RIGHT, TA_JUSTIFY
from reportlab.platypus import (
    SimpleDocTemplate, Paragraph, Spacer, PageBreak, Table, TableStyle,
    KeepTogether, HRFlowable
)
from reportlab.pdfgen import canvas

# Professional colors
PRIMARY = colors.HexColor('#2C3E50')
ACCENT = colors.HexColor('#2980B9')
LIGHT_ACCENT = colors.HexColor('#3498DB')
SUCCESS = colors.HexColor('#27AE60')
GREY = colors.HexColor('#7F8C8D')
LIGHT_GREY = colors.HexColor('#ECF0F1')

OUTPUT = r"C:\Users\alexi\Documents\projects\timetrack-pro\TimeTrack_Pro_Complete_Documentation.pdf"


class NumberedCanvas(canvas.Canvas):
    def __init__(self, *args, **kwargs):
        canvas.Canvas.__init__(self, *args, **kwargs)
        self._saved_page_states = []

    def showPage(self):
        self._saved_page_states.append(dict(self.__dict__))
        self._startPage()

    def save(self):
        num_pages = len(self._saved_page_states)
        for state in self._saved_page_states:
            self.__dict__.update(state)
            self.draw_decorations(num_pages)
            canvas.Canvas.showPage(self)
        canvas.Canvas.save(self)

    def draw_decorations(self, count):
        self.saveState()
        self.setFont('Helvetica', 9)
        self.setFillColor(GREY)

        # Page number
        self.drawCentredString(letter[0]/2, 0.5*inch, f"Page {self._pageNumber} of {count}")

        # Header (skip page 1)
        if self._pageNumber > 1:
            self.drawString(0.75*inch, letter[1]-0.5*inch, "TimeTrack Pro - Technical Reference")
            self.drawRightString(letter[0]-0.75*inch, letter[1]-0.5*inch, "Alexis Trouvé | 2025")

        self.restoreState()


def get_styles():
    """Get custom styles"""
    s = getSampleStyleSheet()

    # Add custom styles with unique names
    s.add(ParagraphStyle(
        name='CTitle', parent=s['Heading1'], fontSize=48, textColor=PRIMARY,
        spaceAfter=20, alignment=TA_CENTER, fontName='Helvetica-Bold'))

    s.add(ParagraphStyle(
        name='CSubtitle', parent=s['Normal'], fontSize=24, textColor=ACCENT,
        spaceAfter=30, alignment=TA_CENTER))

    s.add(ParagraphStyle(
        name='SHead', parent=s['Heading1'], fontSize=20, textColor=colors.white,
        backColor=PRIMARY, spaceAfter=16, spaceBefore=12, leftIndent=10,
        fontName='Helvetica-Bold', leading=28))

    s.add(ParagraphStyle(
        name='SubHead', parent=s['Heading2'], fontSize=14, textColor=ACCENT,
        spaceAfter=10, spaceBefore=12, fontName='Helvetica-Bold'))

    s.add(ParagraphStyle(
        name='Body', parent=s['Normal'], fontSize=11, textColor=PRIMARY,
        alignment=TA_JUSTIFY, spaceAfter=8, leading=14))

    s.add(ParagraphStyle(
        name='Bull', parent=s['Normal'], fontSize=11, textColor=PRIMARY,
        leftIndent=30, spaceAfter=6, leading=14))

    s.add(ParagraphStyle(
        name='CodeBlock', parent=s['Normal'], fontSize=9, textColor=PRIMARY,
        fontName='Courier', leftIndent=20, backColor=LIGHT_GREY, spaceAfter=8))

    return s


def build_pdf():
    doc = SimpleDocTemplate(OUTPUT, pagesize=letter, rightMargin=0.75*inch,
                           leftMargin=0.75*inch, topMargin=1*inch,
                           bottomMargin=0.75*inch,
                           title="TimeTrack Pro Technical Reference",
                           author="Alexis Trouvé")

    story = []
    s = get_styles()

    print("Building PDF sections...")

    # ========== COVER PAGE ==========
    print("  - Cover page")
    story.append(Spacer(1, 1.5*inch))
    story.append(Paragraph("TimeTrack Pro", s['CTitle']))
    story.append(Spacer(1, 0.3*inch))
    story.append(Paragraph("Technical & Functional Reference", s['CSubtitle']))
    story.append(Spacer(1, 0.2*inch))
    story.append(HRFlowable(width="70%", thickness=2, color=ACCENT,
                           spaceAfter=30, spaceBefore=10, hAlign='CENTER'))

    desc = ParagraphStyle('CD', parent=s['Body'], fontSize=13, alignment=TA_CENTER,
                         fontName='Helvetica-Oblique')
    story.append(Paragraph("Professional Time Tracking Application", desc))
    story.append(Paragraph("Built with Microsoft Access & VBA", desc))
    story.append(Paragraph("Automated Development via MCP VBA Server", desc))
    story.append(Spacer(1, 0.5*inch))

    # Highlights table
    hl_data = [
        ['Project Highlights', ''],
        ['Total VBA Code', '915 Lines'],
        ['Modular Components', '7 Modules'],
        ['Database Tables', '3 Normalized Tables'],
        ['Public Functions', '45+ Functions'],
        ['Development Time Saved', '45% via Automation'],
        ['Code Quality', '25% Comment Ratio'],
    ]

    hl_table = Table(hl_data, colWidths=[3*inch, 2*inch])
    hl_table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('ALIGN', (0,0), (-1,0), 'CENTER'),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 14),
        ('BOTTOMPADDING', (0,0), (-1,0), 12),
        ('TOPPADDING', (0,0), (-1,0), 12),
        ('BACKGROUND', (0,1), (0,-1), LIGHT_GREY),
        ('FONTNAME', (0,1), (0,-1), 'Helvetica-Bold'),
        ('ALIGN', (1,1), (1,-1), 'RIGHT'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 10),
        ('RIGHTPADDING', (0,0), (-1,-1), 10),
        ('TOPPADDING', (0,1), (-1,-1), 8),
        ('BOTTOMPADDING', (0,1), (-1,-1), 8),
    ]))

    story.append(hl_table)
    story.append(Spacer(1, 1*inch))

    auth = ParagraphStyle('Auth', parent=s['Body'], fontSize=13, alignment=TA_CENTER,
                         fontName='Helvetica-Bold')
    cont = ParagraphStyle('Cont', parent=s['Body'], fontSize=11, alignment=TA_CENTER,
                         textColor=ACCENT)
    vers = ParagraphStyle('Vers', parent=s['Body'], fontSize=10, alignment=TA_CENTER,
                         textColor=GREY)

    story.append(Paragraph("Alexis Trouvé", auth))
    story.append(Spacer(1, 0.1*inch))
    story.append(Paragraph("alexistrouve.pro@gmail.com", cont))
    story.append(Paragraph('<link href="https://github.com/AlexisTrouve?tab=repositories">github.com/AlexisTrouve</link>', cont))
    story.append(Spacer(1, 0.3*inch))
    story.append(Paragraph("Version 1.0 | January 2025", vers))
    story.append(PageBreak())

    # ========== TABLE OF CONTENTS ==========
    print("  - Table of contents")
    story.append(Paragraph("Table of Contents", s['SHead']))
    story.append(Spacer(1, 0.2*inch))

    toc_items = [
        "1. Executive Summary",
        "2. Project Overview",
        "3. Database Architecture",
        "4. VBA Module Architecture",
        "5. Functional Specifications",
        "6. MCP VBA Server Automation",
        "7. Use Cases & Applications",
        "8. Installation & Deployment",
        "9. Professional Services Available",
        "10. Appendices & Resources"
    ]

    for item in toc_items:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(PageBreak())

    # ========== SECTION 1 ==========
    print("  - Section 1: Executive Summary")
    story.append(Paragraph("1. Executive Summary", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph(
        """TimeTrack Pro is a professional time tracking application built on Microsoft Access,
        showcasing advanced database design, VBA automation, and modern development practices.
        This project demonstrates the capability to deliver production-ready business applications
        through automated development workflows using the VBA MCP Server.""", s['Body']))
    story.append(Spacer(1, 0.1*inch))

    story.append(Paragraph(
        """<b><font color="#2980B9">Key Achievement:</font></b> Complete application development
        (database structure, business logic, queries, and VBA modules) automated via MCP
        (Model Context Protocol), demonstrating cutting-edge AI-assisted development.""", s['Body']))
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("1.1 Project Statistics", s['SubHead']))

    stats = [
        ['Metric', 'Value', 'Description'],
        ['Total VBA Lines', '915', 'Professional, commented code'],
        ['VBA Modules', '7', 'Modular architecture'],
        ['Database Tables', '3', 'Normalized structure'],
        ['Public Functions', '45+', 'Reusable components'],
        ['Time Saved', '45%', 'Via MCP automation'],
        ['Comment Ratio', '25%', 'Well-documented'],
        ['Error Handling', '100%', 'All public functions'],
    ]

    st = Table(stats, colWidths=[2*inch, 1.5*inch, 3*inch])
    st.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 11),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,1), (-1,-1), 6),
        ('BOTTOMPADDING', (0,1), (-1,-1), 6),
    ]))

    story.append(st)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("1.2 Current Data", s['SubHead']))

    usage = [
        ['Metric', 'Value'],
        ['Active Clients', '4'],
        ['Active Projects', '6'],
        ['Time Entries', '15+'],
        ['Hours Tracked', '58 hours'],
        ['Revenue Calculated', '€4,732.50'],
    ]

    ut = Table(usage, colWidths=[3*inch, 2*inch])
    ut.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), ACCENT),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 11),
        ('FONTNAME', (1,1), (1,-1), 'Helvetica-Bold'),
        ('FONTSIZE', (1,1), (1,-1), 12),
        ('TEXTCOLOR', (1,1), (1,-1), SUCCESS),
        ('ALIGN', (1,0), (1,-1), 'RIGHT'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 10),
        ('RIGHTPADDING', (0,0), (-1,-1), 10),
        ('TOPPADDING', (0,0), (-1,-1), 8),
        ('BOTTOMPADDING', (0,0), (-1,-1), 8),
    ]))

    story.append(ut)
    story.append(PageBreak())

    # ========== SECTION 2 ==========
    print("  - Section 2: Project Overview")
    story.append(Paragraph("2. Project Overview", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("2.1 Purpose", s['SubHead']))
    story.append(Paragraph("TimeTrack Pro is a time management tool designed for freelancers, consultants, and small teams to:", s['Body']))

    for item in ["Track billable hours across multiple clients and projects",
                 "Calculate revenue automatically based on hourly rates",
                 "Generate professional reports for invoicing",
                 "Maintain complete audit trail of time entries"]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(Spacer(1, 0.15*inch))
    story.append(Paragraph("2.2 Target Audience", s['SubHead']))

    aud = [
        ['Audience', 'Use Case'],
        ['Freelancers', 'Independent consultants tracking multiple client projects'],
        ['Small Teams', 'Agencies managing client work and resource allocation'],
        ['Consultants', 'Professional services requiring detailed time records'],
    ]

    at = Table(aud, colWidths=[1.5*inch, 5*inch])
    at.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), ACCENT),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 8),
        ('BOTTOMPADDING', (0,1), (-1,-1), 8),
    ]))

    story.append(at)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("2.3 Technology Stack", s['SubHead']))

    tech = [
        ['Component', 'Technology', 'Version'],
        ['Database', 'Microsoft Access', '2016+/Office 365'],
        ['Language', 'VBA', '7.1'],
        ['Automation', 'VBA MCP Server', 'v0.6.0+'],
        ['Export', 'PDF, Excel', 'Native'],
        ['Version Control', 'Git', '2.x'],
    ]

    tt = Table(tech, colWidths=[2*inch, 2.2*inch, 2.3*inch])
    tt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 6),
        ('BOTTOMPADDING', (0,1), (-1,-1), 6),
    ]))

    story.append(tt)
    story.append(PageBreak())

    # ========== SECTION 3 ==========
    print("  - Section 3: Database Architecture")
    story.append(Paragraph("3. Database Architecture", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph(
        "The application uses a normalized relational database following third normal form (3NF). Three core tables with enforced referential integrity.", s['Body']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("3.1 Entity Relationships", s['SubHead']))

    erd = """
    tbl_Clients (1) ──── (N) tbl_Projets (1) ──── (N) tbl_Temps

    • One Client has many Projects (1:N)
    • One Project has many Time Entries (1:N)
    • Referential integrity enforced with CASCADE
    """
    story.append(Paragraph(erd, s['CodeBlock']))
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("3.2 Table: tbl_Clients", s['SubHead']))

    cl = [
        ['Field', 'Type', 'Constraints', 'Description'],
        ['ClientID', 'AutoNumber', 'PRIMARY KEY', 'Unique identifier'],
        ['Nom', 'Text(100)', 'NOT NULL', 'Client name'],
        ['Email', 'Text(100)', 'VALIDATED', 'Email with format check'],
        ['Telephone', 'Text(20)', 'NULL', 'Phone number'],
        ['Notes', 'Memo', 'NULL', 'Additional notes'],
        ['DateCreation', 'DateTime', 'DEFAULT Now()', 'Creation timestamp'],
    ]

    clt = Table(cl, colWidths=[1.3*inch, 1.3*inch, 1.5*inch, 2.4*inch])
    clt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 9),
        ('FONTSIZE', (0,1), (-1,-1), 8),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ('TOPPADDING', (0,0), (-1,0), 8),
        ('BOTTOMPADDING', (0,0), (-1,0), 8),
        ('TOPPADDING', (0,1), (-1,-1), 5),
        ('BOTTOMPADDING', (0,1), (-1,-1), 5),
    ]))

    story.append(clt)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("3.3 Table: tbl_Projets", s['SubHead']))

    pr = [
        ['Field', 'Type', 'Constraints', 'Description'],
        ['ProjetID', 'AutoNumber', 'PRIMARY KEY', 'Unique identifier'],
        ['ClientID', 'Long', 'FOREIGN KEY', 'Ref to tbl_Clients'],
        ['Nom', 'Text(100)', 'NOT NULL', 'Project name'],
        ['Description', 'Memo', 'NULL', 'Project details'],
        ['TauxHoraire', 'Currency', 'DEFAULT 0', 'Hourly rate (EUR)'],
        ['Actif', 'Yes/No', 'DEFAULT True', 'Active/archived'],
        ['DateCreation', 'DateTime', 'DEFAULT Now()', 'Creation timestamp'],
    ]

    prt = Table(pr, colWidths=[1.3*inch, 1.3*inch, 1.5*inch, 2.4*inch])
    prt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 9),
        ('FONTSIZE', (0,1), (-1,-1), 8),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ('TOPPADDING', (0,0), (-1,0), 8),
        ('BOTTOMPADDING', (0,0), (-1,0), 8),
        ('TOPPADDING', (0,1), (-1,-1), 5),
        ('BOTTOMPADDING', (0,1), (-1,-1), 5),
    ]))

    story.append(prt)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("3.4 Table: tbl_Temps", s['SubHead']))

    tm = [
        ['Field', 'Type', 'Constraints', 'Description'],
        ['TempsID', 'AutoNumber', 'PRIMARY KEY', 'Unique identifier'],
        ['ProjetID', 'Long', 'FOREIGN KEY', 'Ref to tbl_Projets'],
        ['Date', 'DateTime', 'NOT NULL', 'Entry date (no future)'],
        ['Duree', 'Double', 'NOT NULL, > 0', 'Hours (decimal)'],
        ['Description', 'Memo', 'NULL', 'Work description'],
        ['DateCreation', 'DateTime', 'DEFAULT Now()', 'Creation timestamp'],
    ]

    tmt = Table(tm, colWidths=[1.3*inch, 1.3*inch, 1.5*inch, 2.4*inch])
    tmt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 9),
        ('FONTSIZE', (0,1), (-1,-1), 8),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 6),
        ('RIGHTPADDING', (0,0), (-1,-1), 6),
        ('TOPPADDING', (0,0), (-1,0), 8),
        ('BOTTOMPADDING', (0,0), (-1,0), 8),
        ('TOPPADDING', (0,1), (-1,-1), 5),
        ('BOTTOMPADDING', (0,1), (-1,-1), 5),
    ]))

    story.append(tmt)
    story.append(PageBreak())

    # ========== SECTION 4 ==========
    print("  - Section 4: VBA Architecture")
    story.append(Paragraph("4. VBA Module Architecture", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph(
        "Modular VBA architecture with 7 core modules totaling 915 lines of professional, commented code. Clear separation of concerns following best practices.", s['Body']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("4.1 Module Overview", s['SubHead']))

    mod = [
        ['Module', 'Purpose', 'LOC', 'Functions'],
        ['mod_Config', 'App configuration & constants', '80', '—'],
        ['mod_Navigation', 'Form navigation & UI flow', '120', '7'],
        ['mod_DataAccess', 'CRUD operations & DB layer', '200', '15+'],
        ['mod_Calculs', 'Business logic & calculations', '150', '8'],
        ['mod_Export', 'Report generation & export', '120', '5'],
        ['mod_Utils', 'Helper functions & validation', '100', '8'],
        ['mod_FormBuilder', 'Automated form creation', '145', '6'],
    ]

    modt = Table(mod, colWidths=[1.5*inch, 2.5*inch, 0.7*inch, 1*inch])
    modt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 9),
        ('FONTSIZE', (0,1), (-1,-1), 9),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('ALIGN', (2,0), (3,-1), 'CENTER'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 6),
        ('BOTTOMPADDING', (0,1), (-1,-1), 6),
    ]))

    story.append(modt)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("4.2 Code Quality Metrics", s['SubHead']))

    for item in [
        "Total VBA Lines: <b>915</b>",
        "Average Module Size: <b>~130 lines</b>",
        "Total Functions: <b>45+</b>",
        "Comment Ratio: <b>25%</b>",
        "Error Handling: <b>100%</b> (all public functions)",
        "Coding Standard: <b>Option Explicit</b>, meaningful names, consistent indentation"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(PageBreak())

    # ========== SECTION 5 ==========
    print("  - Section 5: Functional Specifications")
    story.append(Paragraph("5. Functional Specifications", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("5.1 Core Features", s['SubHead']))

    feat = [
        ['Feature', 'Description', 'Status'],
        ['Client Management', 'Full CRUD for clients with contacts', '✓ Complete'],
        ['Project Management', 'Projects linked to clients with rates', '✓ Complete'],
        ['Time Entry', 'Quick entry with validation', '✓ Complete'],
        ['Automatic Calculations', 'Revenue by project/client', '✓ Complete'],
        ['Report Generation', 'Exportable PDF/Excel reports', '✓ Complete'],
        ['Data Validation', 'Email, phone, date validation', '✓ Complete'],
    ]

    ft = Table(feat, colWidths=[2*inch, 3*inch, 1.5*inch])
    ft.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), ACCENT),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 10),
        ('FONTSIZE', (0,1), (-1,-1), 9),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 6),
        ('BOTTOMPADDING', (0,1), (-1,-1), 6),
        ('TEXTCOLOR', (2,1), (2,-1), SUCCESS),
        ('FONTNAME', (2,1), (2,-1), 'Helvetica-Bold'),
    ]))

    story.append(ft)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("5.2 User Interface", s['SubHead']))

    ui = [
        ['Form', 'Purpose'],
        ['frm_Accueil', 'Main dashboard with navigation & statistics'],
        ['frm_Clients', 'Client list with add/edit/delete'],
        ['frm_Projets', 'Project management with client filter'],
        ['frm_SaisieTemps', 'Quick time entry (<30 sec target)'],
        ['frm_Historique', 'Time history with filters & export'],
    ]

    uit = Table(ui, colWidths=[2*inch, 4.5*inch])
    uit.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 8),
        ('BOTTOMPADDING', (0,1), (-1,-1), 8),
    ]))

    story.append(uit)
    story.append(PageBreak())

    # ========== SECTION 6 ==========
    print("  - Section 6: MCP VBA Automation")
    story.append(Paragraph("6. MCP VBA Server Automation", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph(
        """This project showcases advanced automation using the VBA MCP Server (Model Context Protocol),
        enabling AI-assisted development of Access applications. This cutting-edge approach demonstrates
        the future of database application development.""", s['Body']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("6.1 Development Efficiency", s['SubHead']))

    dev = [
        ['Phase', 'Estimated', 'Actual', 'Method'],
        ['Database Design', '1h', '0.5h', 'MCP Automated'],
        ['Test Data', '30min', '15min', 'MCP Automated'],
        ['VBA Modules', '3h', '1h', 'MCP Automated'],
        ['SQL Queries', '30min', '20min', 'MCP Automated'],
        ['Forms', '2h', '1h', 'Script + Manual'],
        ['Testing & Docs', '2h', '2h', 'Manual'],
        ['TOTAL', '9h', '~5h', '45% Time Saved'],
    ]

    devt = Table(dev, colWidths=[1.8*inch, 1.2*inch, 1.2*inch, 2.3*inch])
    devt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 10),
        ('FONTSIZE', (0,1), (-1,-1), 9),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-2), [colors.white, LIGHT_GREY]),
        ('BACKGROUND', (0,-1), (-1,-1), SUCCESS),
        ('TEXTCOLOR', (0,-1), (-1,-1), colors.white),
        ('FONTNAME', (0,-1), (-1,-1), 'Helvetica-Bold'),
        ('FONTSIZE', (0,-1), (-1,-1), 11),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,-1), 8),
        ('BOTTOMPADDING', (0,0), (-1,-1), 8),
    ]))

    story.append(devt)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("6.2 MCP Tools Used", s['SubHead']))

    for item in [
        "<b>run_access_query</b> - DDL/DML SQL execution",
        "<b>inject_vba</b> - Module code injection",
        "<b>validate_vba_code</b> - Pre-injection syntax check",
        "<b>get/set_worksheet_data</b> - Bulk data operations",
        "<b>list_access_tables</b> - Schema verification",
        "<b>compile_vba</b> - Compilation error detection",
        "<b>backup_vba</b> - Safety backups before changes"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(PageBreak())

    # ========== SECTION 7 ==========
    print("  - Section 7: Use Cases")
    story.append(Paragraph("7. Use Cases & Applications", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("7.1 Freelance Consultant", s['SubHead']))
    story.append(Paragraph(
        """<b>Scenario:</b> Independent consultant managing 5 clients with 8 ongoing projects.""",
        s['Body']))

    for item in [
        "Log time daily (2 min/day)",
        "Review weekly hours by project",
        "Generate monthly client reports",
        "Export to Excel for accounting"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(Spacer(1, 0.1*inch))

    story.append(Paragraph("7.2 Small Design Agency", s['SubHead']))
    story.append(Paragraph(
        """<b>Scenario:</b> 3-person team tracking time across 10 client projects.""",
        s['Body']))

    for item in [
        "Team members log time per project",
        "Manager reviews hours weekly",
        "Generate client reports at milestones",
        "Calculate project profitability"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(Spacer(1, 0.1*inch))

    story.append(Paragraph("7.3 IT Contractor", s['SubHead']))
    story.append(Paragraph(
        """<b>Scenario:</b> IT professional with retainer clients and hourly projects.""",
        s['Body']))

    for item in [
        "Different rates per project/client",
        "Track support vs project hours",
        "Monitor retainer budgets",
        "Detailed invoices with descriptions"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(PageBreak())

    # ========== SECTION 8 ==========
    print("  - Section 8: Installation")
    story.append(Paragraph("8. Installation & Deployment", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("8.1 Prerequisites", s['SubHead']))

    for item in [
        "Windows 10/11",
        "Microsoft Access 2016+ or Office 365 with Access",
        "Macro security: Enable VBA macros"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("8.2 Quick Start", s['SubHead']))

    inst = """
    1. Clone/download project
    2. Open db/TimeTrackPro.accdb
    3. Enable macros when prompted
    4. Import forms (first time):
       - Alt+F11 → Import → scripts/modules/mod_FormBuilder.bas
       - Ctrl+G → BuildAllForms → Enter
    5. Start using application
    """
    story.append(Paragraph(inst, s['CodeBlock']))
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("8.3 Deployment Options", s['SubHead']))

    dep = [
        ['Option', 'Description', 'Best For'],
        ['Single-User', 'Copy .accdb to user machine', 'Personal use'],
        ['Split Database', 'Frontend + backend on network', 'Team (< 10 users)'],
        ['SQL Server', 'Migrate to SQL Server backend', 'Enterprise'],
    ]

    dept = Table(dep, colWidths=[1.5*inch, 3*inch, 2*inch])
    dept.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), ACCENT),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 8),
        ('BOTTOMPADDING', (0,1), (-1,-1), 8),
    ]))

    story.append(dept)
    story.append(PageBreak())

    # ========== SECTION 9 ==========
    print("  - Section 9: Professional Services")
    story.append(Paragraph("9. Professional Services Available", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph(
        "This project demonstrates expertise in the following areas:", s['Body']))
    story.append(Spacer(1, 0.15*inch))

    serv = [
        ['Service', 'Description'],
        ['Microsoft Access Development', 'Forms, reports, VBA automation, SQL optimization'],
        ['Database Design', 'Normalization, indexing, referential integrity, performance'],
        ['Business Applications', 'Requirements, UX design, testing, deployment'],
        ['Process Automation', 'VBA macros, MCP integration, workflow optimization'],
        ['Legacy Modernization', 'Access to SQL Server/web migration'],
        ['AI-Assisted Development', 'MCP Server integration, cutting-edge automation'],
    ]

    servt = Table(serv, colWidths=[2.3*inch, 4.2*inch])
    servt.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTNAME', (0,1), (0,-1), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 11),
        ('FONTSIZE', (0,1), (-1,-1), 10),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'TOP'),
        ('LEFTPADDING', (0,0), (-1,-1), 10),
        ('RIGHTPADDING', (0,0), (-1,-1), 10),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 8),
        ('BOTTOMPADDING', (0,1), (-1,-1), 8),
    ]))

    story.append(servt)
    story.append(Spacer(1, 0.3*inch))

    # Contact box
    contact_data = [[
        Paragraph("<b>Contact Information</b>", ParagraphStyle('CB', parent=s['Body'],
                 fontSize=14, alignment=TA_CENTER, textColor=colors.white,
                 fontName='Helvetica-Bold')),
        Paragraph('Alexis Trouvé<br/>alexistrouve.pro@gmail.com<br/><link href="https://github.com/AlexisTrouve?tab=repositories" color="white">github.com/AlexisTrouve</link><br/><i>Response time: Within 24 hours</i>',
                 ParagraphStyle('CC', parent=s['Body'], fontSize=11,
                 alignment=TA_CENTER, textColor=colors.white))
    ]]

    ct = Table(contact_data, colWidths=[6.5*inch])
    ct.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,-1), PRIMARY),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 20),
        ('RIGHTPADDING', (0,0), (-1,-1), 20),
        ('TOPPADDING', (0,0), (-1,-1), 15),
        ('BOTTOMPADDING', (0,0), (-1,-1), 15),
    ]))

    story.append(ct)
    story.append(PageBreak())

    # ========== SECTION 10 ==========
    print("  - Section 10: Appendices")
    story.append(Paragraph("10. Appendices & Resources", s['SHead']))
    story.append(Spacer(1, 0.15*inch))

    story.append(Paragraph("10.1 Documentation Files", s['SubHead']))

    docs = [
        ['File', 'Purpose'],
        ['README.md', 'Project overview and quick start'],
        ['TECHNICAL_REFERENCE.md', 'Complete technical reference'],
        ['DATABASE.md', 'Detailed database schema'],
        ['VBA_MODULES.md', 'VBA code documentation'],
        ['PLAN.md', 'Project development plan'],
        ['CHANGELOG.md', 'Version history'],
        ['docs/MCP_VBA_GUIDE.md', 'MCP VBA usage guide'],
    ]

    docst = Table(docs, colWidths=[2.5*inch, 4*inch])
    docst.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), ACCENT),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTNAME', (0,1), (0,-1), 'Courier'),
        ('FONTSIZE', (0,0), (-1,0), 10),
        ('FONTSIZE', (0,1), (-1,-1), 9),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 8),
        ('RIGHTPADDING', (0,0), (-1,-1), 8),
        ('TOPPADDING', (0,0), (-1,0), 10),
        ('BOTTOMPADDING', (0,0), (-1,0), 10),
        ('TOPPADDING', (0,1), (-1,-1), 6),
        ('BOTTOMPADDING', (0,1), (-1,-1), 6),
    ]))

    story.append(docst)
    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("10.2 License & Usage", s['SubHead']))

    for item in [
        "<b>License:</b> MIT License",
        "<b>Commercial Use:</b> Permitted",
        "<b>Modification:</b> Permitted",
        "<b>Distribution:</b> Permitted",
        "<b>Private Use:</b> Permitted"
    ]:
        story.append(Paragraph(f"• {item}", s['Bull']))

    story.append(Spacer(1, 0.2*inch))

    story.append(Paragraph("10.3 Version Information", s['SubHead']))

    ver = [
        ['Item', 'Details'],
        ['Document Version', '1.0'],
        ['Application Version', '1.0'],
        ['Last Updated', 'January 13, 2025'],
        ['Status', 'Production Ready'],
    ]

    vert = Table(ver, colWidths=[2*inch, 4.5*inch])
    vert.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), PRIMARY),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 10),
        ('GRID', (0,0), (-1,-1), 0.5, GREY),
        ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, LIGHT_GREY]),
        ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
        ('LEFTPADDING', (0,0), (-1,-1), 10),
        ('RIGHTPADDING', (0,0), (-1,-1), 10),
        ('TOPPADDING', (0,0), (-1,-1), 8),
        ('BOTTOMPADDING', (0,0), (-1,-1), 8),
    ]))

    story.append(vert)
    story.append(Spacer(1, 0.5*inch))

    # Final note
    final = ParagraphStyle('Final', parent=s['Body'], fontSize=10,
                          alignment=TA_CENTER, textColor=GREY,
                          fontName='Helvetica-Oblique')

    story.append(HRFlowable(width="50%", thickness=1, color=GREY,
                           spaceAfter=15, spaceBefore=15, hAlign='CENTER'))
    story.append(Paragraph(
        "This document serves as the authoritative technical and functional reference for TimeTrack Pro.",
        final))
    story.append(Paragraph(
        "For development assistance or custom modifications, contact the author.",
        final))

    # Build PDF
    print("\nBuilding PDF with page numbers...")
    doc.build(story, canvasmaker=NumberedCanvas)

    print(f"\n{'='*60}")
    print(f"SUCCESS - Professional PDF generated!")
    print(f"{'='*60}")
    print(f"File: {OUTPUT}")
    import os
    size = os.path.getsize(OUTPUT) / 1024
    print(f"Size: {size:.1f} KB")
    print(f"Sections: 10 complete sections")
    print(f"Tables: 15+ professional tables")
    print(f"Pages: ~15-20 pages with headers/footers")
    print(f"{'='*60}\n")


if __name__ == '__main__':
    build_pdf()