feat: implement professional PDF negotiation reports and terminology refinement

.gitignore

@@ -29,3 +29,6 @@ Thumbs.db
 .vscode/
 .idea/
 *.swp
+
+.vercel
+access_codes.csv

.vercelignore

@@ -0,0 +1,18 @@
+/.git
+/.vscode
+/data
+/scratch
+/src
+/__pycache__
+/fairvalue_xgboost.json
+*.py
+/README.md
+/README2.md
+/pitch_deck.md
+/tech_stack.md
+/data_schema.md
+/Dockerfile
+/render.yaml
+/requirements.txt
+/error.log
+/api

FairValue High-Conversion Outreach.txt

@@ -0,0 +1,88 @@
+FairValue: High-Conversion Outreach Sequence
+Strategy: Transformation over Features
+The Problem: Clubs overpay by 20-30% due to "hype" and agent pressure.
+The Transformation: Data-backed confidence that saves £10M+ per window and guarantees PSR safety.
+Email 1: The "Intrinsic Value" Hook
+Subject: Eliminating overpayment on [Target Player Name]
+
+Hi [Name],
+
+Most clubs enter the summer window knowing exactly what a player is listed for, but few know what they are actually worth.
+
+We’ve built FairValue to solve the £20M "hype gap." By isolating pure performance metrics from market noise, we provide Directors of Football with a mathematical ceiling for any target.
+
+In an era of strict PSR compliance, being wrong by £10M isn't just a mistake—it's a multi-year recruitment handicap.
+
+Do you have 10 minutes next Tuesday to see how we’re quantifying intrinsic talent for Premier League scouting departments?
+
+Best,
+
+[Your Name]
+
+Email 2: The Follow-Up (The Risk)
+Subject: The cost of the "Eye Test" alone
+
+Hi [Name],
+
+Following up on my previous note.
+
+The "eye test" tells you if a player can play. FairValue tells you if they fit your 5-year financial model.
+
+We recently modeled a high-profile PL move where the club overpaid by £18M purely on "sentiment." That’s a whole second squad player lost to market noise.
+
+We help you benchmark the depreciation hit of age and contract length before the first bid is even made.
+
+Worth a quick look?
+
+Best,
+
+[Your Name]
+
+Email 3: The Follow-Up (Negotiation Leverage)
+Subject: Bringing math to the table
+
+Hi [Name],
+
+When agents drive the price up, what is your counter-leverage?
+
+Our partners use FairValue's Market Impact Reports as a defensive wall in negotiations. Having an auditable, performance-based "Hard Cap" changes the power dynamic in the transfer room.
+
+It’s not just about spending less; it’s about spending precisely.
+
+Happy to share a sample valuation report for a current PL target if you're interested.
+
+Best,
+
+[Your Name]
+
+Email 4: The Follow-Up (PSR Safeguard)
+Subject: Safeguarding your 2025/26 budget
+
+Hi [Name],
+
+With the latest PSR rulings, the margin for error has vanished.
+
+FairValue doesn't just estimate prices; it models the amortisation hit and "Intrinsic Value" of your targets to ensure every signing is a financial asset, not a liability.
+
+If you're currently profiling targets for the upcoming window, I'd love to show you how we're de-risking acquisitions for elite investment groups and DOFs.
+
+Best,
+
+[Your Name]
+
+Email 5: The Final Call (Low Friction)
+Subject: One last thing, [Name]
+
+Hi [Name],
+
+I'll stop crowding your inbox after this.
+
+I know how busy the recruitment cycle is. If you're not looking to overhaul your valuation methodology right now, I completely understand.
+
+However, if you'd like a "second opinion" on a single high-stakes target you're tracking, I'm happy to run a one-off evaluation for you—no strings attached.
+
+If not, I'll check back in after the window closes.
+
+Best,
+
+[Your Name]

README.md

@@ -3,10 +3,7 @@ title: FairValue Transfer Cap Estimator
 emoji: ⚽
 colorFrom: green
 colorTo: gray
-sdk: streamlit
-sdk_version: 1.32.0
-python_version: 3.11
-app_file: app.py
+sdk: docker
 pinned: true
 license: mit
 ---

api/main.py

@@ -8,6 +8,7 @@ import time
 import xgboost as xgb
 from ddgs import DDGS
 from textblob import TextBlob
+import pathlib
 
 app = FastAPI(
     title="FairValue Strategic AI API",
@@ -24,6 +25,51 @@ app.add_middleware(
     allow_headers=["*"],
 )
 
+ACCESS_CODES_PATH = pathlib.Path(__file__).parent / "access_codes.csv"
+
+class CodeRequest(BaseModel):
+    code: str
+
+@app.post("/api/validate-code")
+async def validate_code(req: CodeRequest):
+    """
+    Validates a secret access code against the local CSV database.
+    Each code is restricted to a maximum of 15 uses.
+    """
+    # Always allow master bypass code
+    if req.code == "FairValue-103":
+        return {"status": "success", "message": "Master bypass active"}
+
+    if not os.path.exists(ACCESS_CODES_PATH):
+        raise HTTPException(status_code=500, detail="Access database unavailable")
+
+    try:
+        df = pd.read_csv(ACCESS_CODES_PATH)
+        df['code'] = df['code'].astype(str)
+        
+        if req.code not in df['code'].values:
+            raise HTTPException(status_code=403, detail="Invalid access code")
+
+        row_idx = df.index[df['code'] == req.code].tolist()[0]
+        current_uses = int(df.at[row_idx, 'uses'])
+
+        if current_uses >= 15:
+            raise HTTPException(status_code=403, detail="Access code expired (max 15 uses reached)")
+
+        # Increment and persist
+        df.at[row_idx, 'uses'] = current_uses + 1
+        df.to_csv(ACCESS_CODES_PATH, index=False)
+
+        return {
+            "status": "success", 
+            "uses_remaining": 15 - (current_uses + 1)
+        }
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Database error: {str(e)}")
+
+
 
 @app.get("/")
 def health_check():

fairvalue-webapp/.gitignore

@@ -22,3 +22,5 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+
+.vercel

fairvalue-webapp/package-lock.json

@@ -8,6 +8,10 @@
       "name": "fairvalue-webapp",
       "version": "1.0.0",
       "dependencies": {
+        "framer-motion": "^12.38.0",
+        "html2canvas": "^1.4.1",
+        "jspdf": "^4.2.1",
+        "lucide-react": "^1.8.0",
         "react": "^18.3.1",
         "react-dom": "^18.3.1",
         "react-router-dom": "^6.23.1",
@@ -1234,6 +1238,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/pako": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/@types/pako/-/pako-2.0.4.tgz",
+      "integrity": "sha512-VWDCbrLeVXJM9fihYodcLiIv0ku+AlOa/TQ1SvYOaBuyrSKgEcro95LJyIsJ4vSo6BXIxOKxiJAat04CmST9Fw==",
+      "license": "MIT"
+    },
     "node_modules/@types/prop-types": {
       "version": "15.7.15",
       "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
@@ -1241,6 +1251,13 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/raf": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/@types/raf/-/raf-3.4.3.tgz",
+      "integrity": "sha512-c4YAvMedbPZ5tEyxzQdMoOhhJ4RD3rngZIdwC2/qDN3d7JpEhB6fiBRKVY1lg5B7Wk+uPBjn5f39j1/2MY1oOw==",
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/@types/react": {
       "version": "18.3.28",
       "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.28.tgz",
@@ -1262,6 +1279,13 @@
         "@types/react": "^18.0.0"
       }
     },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/@vitejs/plugin-react": {
       "version": "4.7.0",
       "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-4.7.0.tgz",
@@ -1283,6 +1307,15 @@
         "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
       }
     },
+    "node_modules/base64-arraybuffer": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/base64-arraybuffer/-/base64-arraybuffer-1.0.2.tgz",
+      "integrity": "sha512-I3yl4r9QB5ZRY3XuJVEPfc2XhZO6YweFPI+UovAzn+8/hb3oJ6lnysaFcjVpkCPfVWFUDvoZ8kmVDP7WyRtYtQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6.0"
+      }
+    },
     "node_modules/baseline-browser-mapping": {
       "version": "2.10.21",
       "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.21.tgz",
@@ -1351,6 +1384,26 @@
       ],
       "license": "CC-BY-4.0"
     },
+    "node_modules/canvg": {
+      "version": "3.0.11",
+      "resolved": "https://registry.npmjs.org/canvg/-/canvg-3.0.11.tgz",
+      "integrity": "sha512-5ON+q7jCTgMp9cjpu4Jo6XbvfYwSB2Ow3kzHKfIyJfaCAOHLbdKPQqGKgfED/R5B+3TFFfe8pegYA+b423SRyA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@babel/runtime": "^7.12.5",
+        "@types/raf": "^3.4.0",
+        "core-js": "^3.8.3",
+        "raf": "^3.4.1",
+        "regenerator-runtime": "^0.13.7",
+        "rgbcolor": "^1.0.1",
+        "stackblur-canvas": "^2.0.0",
+        "svg-pathdata": "^6.0.3"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
     "node_modules/clsx": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
@@ -1367,6 +1420,27 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/core-js": {
+      "version": "3.49.0",
+      "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.49.0.tgz",
+      "integrity": "sha512-es1U2+YTtzpwkxVLwAFdSpaIMyQaq0PBgm3YD1W3Qpsn1NAmO3KSgZfu+oGSWVu6NvLHoHCV/aYcsE5wiB7ALg==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/core-js"
+      }
+    },
+    "node_modules/css-line-break": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/css-line-break/-/css-line-break-2.1.0.tgz",
+      "integrity": "sha512-FHcKFCZcAha3LwfVBhCQbW2nCNbkZXn7KVUJcsT5/P8YmfsVja0FMPJr0B903j/E69HUphKiV9iQArX8SDYA4w==",
+      "license": "MIT",
+      "dependencies": {
+        "utrie": "^1.0.2"
+      }
+    },
     "node_modules/csstype": {
       "version": "3.2.3",
       "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
@@ -1528,6 +1602,16 @@
         "csstype": "^3.0.2"
       }
     },
+    "node_modules/dompurify": {
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.2.tgz",
+      "integrity": "sha512-lHeS9SA/IKeIFFyYciHBr2n0v1VMPlSj843HdLOwjb2OxNwdq9Xykxqhk+FE42MzAdHvInbAolSE4mhahPpjXA==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
+      "optional": true,
+      "optionalDependencies": {
+        "@types/trusted-types": "^2.0.7"
+      }
+    },
     "node_modules/electron-to-chromium": {
       "version": "1.5.343",
       "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.343.tgz",
@@ -1599,6 +1683,50 @@
         "node": ">=6.0.0"
       }
     },
+    "node_modules/fast-png": {
+      "version": "6.4.0",
+      "resolved": "https://registry.npmjs.org/fast-png/-/fast-png-6.4.0.tgz",
+      "integrity": "sha512-kAqZq1TlgBjZcLr5mcN6NP5Rv4V2f22z00c3g8vRrwkcqjerx7BEhPbOnWCPqaHUl2XWQBJQvOT/FQhdMT7X/Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/pako": "^2.0.3",
+        "iobuffer": "^5.3.2",
+        "pako": "^2.1.0"
+      }
+    },
+    "node_modules/fflate": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz",
+      "integrity": "sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==",
+      "license": "MIT"
+    },
+    "node_modules/framer-motion": {
+      "version": "12.38.0",
+      "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.38.0.tgz",
+      "integrity": "sha512-rFYkY/pigbcswl1XQSb7q424kSTQ8q6eAC+YUsSKooHQYuLdzdHjrt6uxUC+PRAO++q5IS7+TamgIw1AphxR+g==",
+      "license": "MIT",
+      "dependencies": {
+        "motion-dom": "^12.38.0",
+        "motion-utils": "^12.36.0",
+        "tslib": "^2.4.0"
+      },
+      "peerDependencies": {
+        "@emotion/is-prop-valid": "*",
+        "react": "^18.0.0 || ^19.0.0",
+        "react-dom": "^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@emotion/is-prop-valid": {
+          "optional": true
+        },
+        "react": {
+          "optional": true
+        },
+        "react-dom": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/fsevents": {
       "version": "2.3.3",
       "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -1624,6 +1752,19 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/html2canvas": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/html2canvas/-/html2canvas-1.4.1.tgz",
+      "integrity": "sha512-fPU6BHNpsyIhr8yyMpTLLxAbkaK8ArIBcmZIRiBLiDhjeqvXolaEmDGmELFuX9I4xDcaKKcJl+TKZLqruBbmWA==",
+      "license": "MIT",
+      "dependencies": {
+        "css-line-break": "^2.1.0",
+        "text-segmentation": "^1.0.3"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
     "node_modules/internmap": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/internmap/-/internmap-2.0.3.tgz",
@@ -1633,6 +1774,12 @@
         "node": ">=12"
       }
     },
+    "node_modules/iobuffer": {
+      "version": "5.4.0",
+      "resolved": "https://registry.npmjs.org/iobuffer/-/iobuffer-5.4.0.tgz",
+      "integrity": "sha512-DRebOWuqDvxunfkNJAlc3IzWIPD5xVxwUNbHr7xKB8E6aLJxIPfNX3CoMJghcFjpv6RWQsrcJbghtEwSPoJqMA==",
+      "license": "MIT"
+    },
     "node_modules/js-tokens": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
@@ -1665,6 +1812,23 @@
         "node": ">=6"
       }
     },
+    "node_modules/jspdf": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/jspdf/-/jspdf-4.2.1.tgz",
+      "integrity": "sha512-YyAXyvnmjTbR4bHQRLzex3CuINCDlQnBqoSYyjJwTP2x9jDLuKDzy7aKUl0hgx3uhcl7xzg32agn5vlie6HIlQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.28.6",
+        "fast-png": "^6.2.0",
+        "fflate": "^0.8.1"
+      },
+      "optionalDependencies": {
+        "canvg": "^3.0.11",
+        "core-js": "^3.6.0",
+        "dompurify": "^3.3.1",
+        "html2canvas": "^1.0.0-rc.5"
+      }
+    },
     "node_modules/lodash": {
       "version": "4.18.1",
       "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
@@ -1693,6 +1857,30 @@
         "yallist": "^3.0.2"
       }
     },
+    "node_modules/lucide-react": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-1.8.0.tgz",
+      "integrity": "sha512-WuvlsjngSk7TnTBJ1hsCy3ql9V9VOdcPkd3PKcSmM34vJD8KG6molxz7m7zbYFgICwsanQWmJ13JlYs4Zp7Arw==",
+      "license": "ISC",
+      "peerDependencies": {
+        "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/motion-dom": {
+      "version": "12.38.0",
+      "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.38.0.tgz",
+      "integrity": "sha512-pdkHLD8QYRp8VfiNLb8xIBJis1byQ9gPT3Jnh2jqfFtAsWUA3dEepDlsWe/xMpO8McV+VdpKVcp+E+TGJEtOoA==",
+      "license": "MIT",
+      "dependencies": {
+        "motion-utils": "^12.36.0"
+      }
+    },
+    "node_modules/motion-utils": {
+      "version": "12.36.0",
+      "resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.36.0.tgz",
+      "integrity": "sha512-eHWisygbiwVvf6PZ1vhaHCLamvkSbPIeAYxWUuL3a2PD/TROgE7FvfHWTIH4vMl798QLfMw15nRqIaRDXTlYRg==",
+      "license": "MIT"
+    },
     "node_modules/ms": {
       "version": "2.1.3",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
@@ -1735,6 +1923,19 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/pako": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-2.1.0.tgz",
+      "integrity": "sha512-w+eufiZ1WuJYgPXbV/PO3NCMEc3xqylkKHzp8bxp1uW4qaSNQUkwmLLEc3kKsfz8lpV1F8Ht3U1Cm+9Srog2ug==",
+      "license": "(MIT AND Zlib)"
+    },
+    "node_modules/performance-now": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz",
+      "integrity": "sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==",
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/picocolors": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
@@ -1788,6 +1989,16 @@
       "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
       "license": "MIT"
     },
+    "node_modules/raf": {
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/raf/-/raf-3.4.1.tgz",
+      "integrity": "sha512-Sq4CW4QhwOHE8ucn6J34MqtZCeWFP2aQSmrlroYgqAV1PjStIhJXxYuTgUIfkEk7zTLjmIjLmU5q+fbD1NnOJA==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "performance-now": "^2.1.0"
+      }
+    },
     "node_modules/react": {
       "version": "18.3.1",
       "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
@@ -1924,6 +2135,23 @@
         "decimal.js-light": "^2.4.1"
       }
     },
+    "node_modules/regenerator-runtime": {
+      "version": "0.13.11",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
+      "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/rgbcolor": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/rgbcolor/-/rgbcolor-1.0.1.tgz",
+      "integrity": "sha512-9aZLIrhRaD97sgVhtJOW6ckOEh6/GnvQtdVNfdZ6s67+3/XwLS9lBcQYzEEhYVeUowN7pRzMLsyGhK2i/xvWbw==",
+      "license": "MIT OR SEE LICENSE IN FEEL-FREE.md",
+      "optional": true,
+      "engines": {
+        "node": ">= 0.8.15"
+      }
+    },
     "node_modules/rollup": {
       "version": "4.60.2",
       "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz",
@@ -1998,12 +2226,47 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/stackblur-canvas": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/stackblur-canvas/-/stackblur-canvas-2.7.0.tgz",
+      "integrity": "sha512-yf7OENo23AGJhBriGx0QivY5JP6Y1HbrrDI6WLt6C5auYZXlQrheoY8hD4ibekFKz1HOfE48Ww8kMWMnJD/zcQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=0.1.14"
+      }
+    },
+    "node_modules/svg-pathdata": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/svg-pathdata/-/svg-pathdata-6.0.3.tgz",
+      "integrity": "sha512-qsjeeq5YjBZ5eMdFuUa4ZosMLxgr5RZ+F+Y1OrDhuOCEInRMA3x74XdBtggJcj9kOeInz0WE+LgCPDkZFlBYJw==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/text-segmentation": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/text-segmentation/-/text-segmentation-1.0.3.tgz",
+      "integrity": "sha512-iOiPUo/BGnZ6+54OsWxZidGCsdU8YbE4PSpdPinp7DeMtUJNJBoJ/ouUSTJjHkh1KntHaltHl/gDs2FC4i5+Nw==",
+      "license": "MIT",
+      "dependencies": {
+        "utrie": "^1.0.2"
+      }
+    },
     "node_modules/tiny-invariant": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz",
       "integrity": "sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==",
       "license": "MIT"
     },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD"
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -2049,6 +2312,15 @@
         "browserslist": ">= 4.21.0"
       }
     },
+    "node_modules/utrie": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/utrie/-/utrie-1.0.2.tgz",
+      "integrity": "sha512-1MLa5ouZiOmQzUbjbu9VmjLzn1QLXBhwpUa7kdLUQK+KQ5KA9I1vk5U4YHe/X2Ch7PYnJfWuWT+VbuxbGwljhw==",
+      "license": "MIT",
+      "dependencies": {
+        "base64-arraybuffer": "^1.0.2"
+      }
+    },
     "node_modules/victory-vendor": {
       "version": "36.9.2",
       "resolved": "https://registry.npmjs.org/victory-vendor/-/victory-vendor-36.9.2.tgz",

fairvalue-webapp/package.json

@@ -10,6 +10,10 @@
     "preview": "vite preview"
   },
   "dependencies": {
+    "framer-motion": "^12.38.0",
+    "html2canvas": "^1.4.1",
+    "jspdf": "^4.2.1",
+    "lucide-react": "^1.8.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.23.1",

fairvalue-webapp/src/App.tsx

@@ -4,16 +4,19 @@ import Landing from './pages/Landing'
 import Estimator from './pages/Estimator'
 import FFPAdvisor from './pages/FFPAdvisor'
 import Intel from './pages/Intel'
+import AboutDeveloper from './pages/AboutDeveloper'
+import SecretGate, { useAccessControl } from './components/SecretGate'
 
 export default function App() {
   return (
     <>
       <Navbar />
       <Routes>
-        <Route path="/"        element={<Landing   />} />
+        <Route path="/"         element={<Landing   />} />
         <Route path="/estimate" element={<Estimator />} />
-        <Route path="/ffp"      element={<FFPAdvisor />} />
+        <Route path="/ffp"      element={<FFPAdvisor/>} />
         <Route path="/intel"    element={<Intel     />} />
+        <Route path="/about"    element={<AboutDeveloper />} />
       </Routes>
     </>
   )

fairvalue-webapp/src/components/AccessModal.tsx

@@ -0,0 +1,147 @@
+import { useState } from 'react';
+import { motion, AnimatePresence } from 'framer-motion';
+import { Lock, KeyRound } from 'lucide-react';
+
+interface AccessModalProps {
+  onBetaRequest?: () => void;
+}
+
+export default function AccessModal({ onBetaRequest }: AccessModalProps) {
+  const [showCodeInput, setShowCodeInput] = useState(false);
+  const [code, setCode] = useState('');
+  const [error, setError] = useState(false);
+  const [loading, setLoading] = useState(false);
+  const [errorMessage, setErrorMessage] = useState('');
+
+  const handleUnlock = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setLoading(true);
+    setError(false);
+    setErrorMessage('');
+
+    try {
+      const apiUrl = import.meta.env.VITE_API_URL || 'http://localhost:8000';
+      const response = await fetch(`${apiUrl}/api/validate-code`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ code }),
+      });
+
+      const data = await response.json();
+
+      if (response.ok && data.status === 'success') {
+        sessionStorage.setItem('fv_access_granted', 'true');
+        window.location.reload();
+      } else {
+        setError(true);
+        setErrorMessage(data.detail || 'Invalid or expired code.');
+      }
+    } catch (err) {
+      setError(true);
+      setErrorMessage('Server connection failed. Try again later.');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="modal-overlay">
+      <motion.div 
+        initial={{ opacity: 0, y: 30, scale: 0.95 }}
+        animate={{ opacity: 1, y: 0, scale: 1 }}
+        transition={{ duration: 0.4, ease: "easeOut" }}
+        className="modal-content"
+      >
+        <div style={{ textAlign: 'center', marginBottom: '28px' }}>
+          <div style={{ 
+            width: 64, height: 64, borderRadius: '50%', 
+            background: 'rgba(59, 130, 246, 0.1)', 
+            display: 'flex', alignItems: 'center', justifyContent: 'center',
+            margin: '0 auto 20px',
+            border: '1px solid rgba(59, 130, 246, 0.2)'
+          }}>
+            <Lock size={28} color="#3b82f6" />
+          </div>
+          <h2 style={{ marginBottom: '12px', fontSize: '1.6rem' }} className="display-font">Premium Access Required</h2>
+          <p style={{ fontSize: '0.95rem' }}>
+            You have reached the maximum limit of 3 free AI transfer evaluations. 
+            Request full enterprise access to unlock unlimited SHAP profiling, live intelligence grids, and PSR compliance modeling.
+          </p>
+        </div>
+
+        <AnimatePresence mode="wait">
+          {!showCodeInput ? (
+            <motion.form 
+              key="request-form"
+              initial={{ opacity: 0, x: -20 }}
+              animate={{ opacity: 1, x: 0 }}
+              exit={{ opacity: 0, x: 20 }}
+              action="https://formsubmit.co/oladeji.lawrence@gmail.com" 
+              method="POST"
+              style={{ display: 'flex', flexDirection: 'column', gap: '16px' }}
+            >
+              <input type="text" name="_honey" style={{ display: 'none' }} />
+              <input type="hidden" name="_subject" value="FairValue Enterprise Access Request!" />
+              <input type="hidden" name="_captcha" value="false" />
+
+              <div className="input-group">
+                <label className="field-label">Full Name</label>
+                <input type="text" name="name" className="input" placeholder="e.g. Edu Gaspar" required />
+              </div>
+
+              <div className="input-group">
+                <label className="field-label">Work Email</label>
+                <input type="email" name="email" className="input" placeholder="director@club.com" required />
+              </div>
+
+              <div className="input-group">
+                <label className="field-label">Organisation / Club</label>
+                <input type="text" name="organisation" className="input" placeholder="Arsenal FC" required />
+              </div>
+
+              <button type="submit" className="btn btn-secondary" style={{ marginTop: '12px', width: '100%' }}>
+                Request Enterprise Access
+              </button>
+
+              <button type="button" onClick={() => setShowCodeInput(true)} className="btn btn-ghost" style={{ width: '100%', fontSize: '0.85rem', padding: '10px' }}>
+                <KeyRound size={14} style={{ marginRight: 6 }}/> Already have an access code?
+              </button>
+            </motion.form>
+          ) : (
+            <motion.form 
+              key="code-form"
+              initial={{ opacity: 0, x: 20 }}
+              animate={{ opacity: 1, x: 0 }}
+              exit={{ opacity: 0, x: -20 }}
+              onSubmit={handleUnlock}
+              style={{ display: 'flex', flexDirection: 'column', gap: '16px' }}
+            >
+              <div className="input-group" style={{ marginBottom: '8px' }}>
+                <label className="field-label">Enter Secret Code</label>
+                <input 
+                  type="password" 
+                  className="input" 
+                  placeholder="e.g. FV-ALPHA-101" 
+                  value={code}
+                  onChange={(e) => { setCode(e.target.value); setError(false); }}
+                  style={{ borderColor: error ? 'var(--loss-color)' : '' }}
+                  autoFocus
+                  disabled={loading}
+                />
+                {error && <span style={{ color: 'var(--loss-color)', fontSize: '0.8rem', marginTop: '4px' }}>{errorMessage}</span>}
+              </div>
+
+              <button type="submit" className="btn btn-secondary" style={{ width: '100%' }} disabled={loading}>
+                {loading ? 'Validating Access...' : 'Unlock Platform'}
+              </button>
+
+              <button type="button" onClick={() => setShowCodeInput(false)} className="btn btn-ghost" style={{ width: '100%', fontSize: '0.85rem', padding: '10px' }}>
+                ← Back to Request Form
+              </button>
+            </motion.form>
+          )}
+        </AnimatePresence>
+      </motion.div>
+    </div>
+  );
+}

fairvalue-webapp/src/components/DefinitionOfTerms.tsx

@@ -0,0 +1,45 @@
+export default function DefinitionOfTerms() {
+  return (
+    <div className="glass" style={{ padding: '32px', marginTop: '32px' }}>
+      <h3 style={{ marginBottom: '20px', color: 'var(--text-1)' }}>Definition of Terms</h3>
+      <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(280px, 1fr))', gap: '24px' }}>
+        
+        <div>
+          <h4 style={{ color: 'var(--profit-color)', marginBottom: '6px' }}>Intrinsic Performance Value</h4>
+          <p style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>
+            The player's raw talent value, calculated purely from on-pitch statistics (goals, assists, defensive actions, pass completion) independent of external factors.
+          </p>
+        </div>
+
+        <div>
+          <h4 style={{ color: 'var(--accent-blue)', marginBottom: '6px' }}>Age & Contract Impact (SHAP)</h4>
+          <p style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>
+            The financial adjustment applied to the player's value based on their age and remaining contract years, isolating exact premiums or penalties using Explainable AI (SHAP).
+          </p>
+        </div>
+
+        <div>
+          <h4 style={{ color: '#a78bfa', marginBottom: '6px' }}>ML Baseline Value</h4>
+          <p style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>
+            The objective base market valuation before considering live news, transfer speculation, and recent injury data.
+          </p>
+        </div>
+
+        <div>
+          <h4 style={{ color: '#fbbf24', marginBottom: '6px' }}>NLP Multiplier</h4>
+          <p style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>
+            A dynamic market adjustment factor generated by scanning live news sentiment, agent rumors, and recent injury reports.
+          </p>
+        </div>
+
+        <div>
+          <h4 style={{ color: 'var(--profit-color)', marginBottom: '6px' }}>Fair Value</h4>
+          <p style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>
+            The absolute maximum recommended price (financial ceiling). If the asking price exceeds this Fair Value, it represents a significant overpayment risk based on real-time market and predictive metrics.
+          </p>
+        </div>
+
+      </div>
+    </div>
+  )
+}

fairvalue-webapp/src/components/Navbar.tsx

@@ -4,6 +4,7 @@ const links = [
   { to: '/estimate', label: 'Transfer Estimator' },
   { to: '/ffp',      label: 'PSR Advisor' },
   { to: '/intel',    label: 'Live Intel' },
+  { to: '/about',    label: 'About the Architect' },
 ]
 
 export default function Navbar() {
@@ -42,8 +43,8 @@ export default function Navbar() {
                 borderRadius: 8,
                 fontSize: '0.85rem',
                 fontWeight: isActive ? 600 : 400,
-                color: isActive ? 'var(--green)' : 'var(--text-2)',
-                background: isActive ? 'var(--green-dim)' : 'transparent',
+                color: isActive ? 'var(--profit-color)' : 'var(--text-2)',
+                background: isActive ? 'rgba(34,197,94,0.15)' : 'transparent',
                 transition: 'all 0.2s',
                 textDecoration: 'none',
               })}
@@ -53,7 +54,7 @@ export default function Navbar() {
 
         {/* Badge */}
         <span className="badge badge-blue" style={{ fontSize:'0.68rem', display:'flex', alignItems:'center', gap:5 }}>
-          <span style={{ width:6, height:6, borderRadius:'50%', background:'var(--green)', display:'inline-block', animation:'pulse-ring 2s infinite' }}/>
+          <span style={{ width:6, height:6, borderRadius:'50%', background:'var(--profit-color)', display:'inline-block', animation:'pulse-ring 2s infinite' }}/>
           XGBoost + SHAP
         </span>
       </div>

fairvalue-webapp/src/components/ReportTemplate.tsx

@@ -0,0 +1,210 @@
+import React, { forwardRef } from 'react'
+
+export interface ReportProps {
+  form: {
+    selected_name: string
+    current_club: string
+    interested_club: string
+    contract_years: number
+    age: number
+    injuries_24m: number
+    asking_price: number
+    market_value_estimation: number
+  }
+  result: {
+    ledger: {
+      intrinsic_performance_value: number
+      category: string
+      depreciation: number
+      baseline_value: number
+      external_multiplier: number
+      hard_cap: number
+    }
+    nlp_results?: {
+      durability: number
+      recency: number
+      agent: number
+    }
+  }
+}
+
+export const ReportTemplate = forwardRef<HTMLDivElement, ReportProps>(({ form, result }, ref) => {
+  const L = result.ledger
+  const isOverpay = form.asking_price > L.hard_cap
+  const dateStr = new Date().toLocaleString('en-US', { dateStyle: 'long', timeStyle: 'short' })
+
+  return (
+    <div
+      ref={ref}
+      className="printable-report"
+      style={{
+        backgroundColor: '#ffffff',
+        color: '#0f172a',
+        fontFamily: "'Inter', sans-serif",
+        boxSizing: 'border-box',
+        display: 'none', // Hidden on screen, shown in print via CSS
+      }}
+    >
+      {/* HEADER */}
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', borderBottom: '2px solid #e2e8f0', paddingBottom: '24px', marginBottom: '32px' }}>
+        <div>
+          <h1 style={{ fontSize: '32px', fontWeight: 800, margin: 0, color: '#020617', letterSpacing: '-0.03em' }}>
+            FairValue Strategic Report
+          </h1>
+          <p style={{ fontSize: '14px', color: '#64748b', marginTop: '4px' }}>
+            AI-Driven Transfer Valuation Intelligence
+          </p>
+        </div>
+        <div style={{ textAlign: 'right', fontSize: '12px', color: '#475569', lineHeight: 1.6 }}>
+          <div style={{ fontWeight: 600, color: '#0f172a' }}>Lawrence Oladeji</div>
+          <div>oladeji.lawrence@gmail.com</div>
+          <div><a href="https://wa.me/2349038819790" style={{ color: '#0f172a', textDecoration: 'none' }}>WhatsApp</a></div>
+          <div><a href="https://premiership-player-fair-value.vercel.app/" style={{ color: '#2563eb', textDecoration: 'none' }}>Website</a></div>
+          <div style={{ marginTop: '8px', color: '#94a3b8' }}>Generated: {dateStr}</div>
+        </div>
+      </div>
+
+      {/* PLAYER PROFILE */}
+      <div style={{ marginBottom: '32px', pageBreakInside: 'avoid', breakInside: 'avoid' }}>
+        <h2 style={{ fontSize: '18px', fontWeight: 700, color: '#334155', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '16px' }}>
+          Player Profile & Parameters
+        </h2>
+        <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '16px', background: '#f8fafc', padding: '24px', borderRadius: '12px', border: '1px solid #e2e8f0' }}>
+          <div>
+            <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Target Player</div>
+            <div style={{ fontSize: '20px', fontWeight: 700, color: '#0f172a' }}>{form.selected_name || 'N/A'}</div>
+          </div>
+          <div>
+            <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Transfer Direction</div>
+            <div style={{ fontSize: '16px', fontWeight: 600, color: '#0f172a' }}>
+              {form.current_club || 'Unknown'} → {form.interested_club || 'Unknown'}
+            </div>
+          </div>
+          <div>
+            <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Age</div>
+            <div style={{ fontSize: '16px', fontWeight: 600, color: '#0f172a' }}>{form.age} years</div>
+          </div>
+          <div>
+            <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Contract Remaining</div>
+            <div style={{ fontSize: '16px', fontWeight: 600, color: '#0f172a' }}>{form.contract_years} years</div>
+          </div>
+        </div>
+      </div>
+
+      {/* FINANCIAL VALUATION LEDGER */}
+      <div style={{ marginBottom: '32px', pageBreakInside: 'avoid', breakInside: 'avoid' }}>
+        <h2 style={{ fontSize: '18px', fontWeight: 700, color: '#334155', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '16px' }}>
+          AI Valuation Ledger
+        </h2>
+        <table style={{ width: '100%', borderCollapse: 'collapse', fontSize: '14px' }}>
+          <tbody>
+            <tr style={{ borderBottom: '1px solid #e2e8f0' }}>
+              <td style={{ padding: '12px 0', color: '#475569', fontWeight: 500 }}>Intrinsic Performance Value</td>
+              <td style={{ padding: '12px 0', textAlign: 'right', fontWeight: 700, color: '#0f172a' }}>£{L.intrinsic_performance_value.toFixed(1)}m</td>
+            </tr>
+            <tr style={{ borderBottom: '1px solid #e2e8f0' }}>
+              <td style={{ padding: '12px 0', color: '#475569', fontWeight: 500 }}>
+                Age & Contract Impact (SHAP) — {L.depreciation < 0 ? 'Penalty' : 'Premium'}
+              </td>
+              <td style={{ padding: '12px 0', textAlign: 'right', fontWeight: 700, color: L.depreciation < 0 ? '#ef4444' : '#22c55e' }}>
+                {L.depreciation >= 0 ? '+' : ''}£{L.depreciation.toFixed(1)}m
+              </td>
+            </tr>
+            <tr style={{ borderBottom: '1px solid #e2e8f0' }}>
+              <td style={{ padding: '12px 0', color: '#475569', fontWeight: 500 }}>ML Baseline Value</td>
+              <td style={{ padding: '12px 0', textAlign: 'right', fontWeight: 700, color: '#0f172a' }}>£{L.baseline_value.toFixed(1)}m</td>
+            </tr>
+            <tr style={{ borderBottom: '1px solid #e2e8f0' }}>
+              <td style={{ padding: '12px 0', color: '#475569', fontWeight: 500 }}>Live NLP Market Multiplier</td>
+              <td style={{ padding: '12px 0', textAlign: 'right', fontWeight: 700, color: L.external_multiplier > 1 ? '#22c55e' : '#ef4444' }}>
+                ×{L.external_multiplier.toFixed(3)}
+              </td>
+            </tr>
+            <tr style={{ backgroundColor: '#f0fdf4', border: '1px solid #bbf7d0' }}>
+              <td style={{ padding: '16px 12px', color: '#166534', fontWeight: 700, fontSize: '16px' }}>Calculated Fair Value</td>
+              <td style={{ padding: '16px 12px', textAlign: 'right', fontWeight: 800, fontSize: '20px', color: '#16a34a' }}>
+                £{L.hard_cap.toFixed(1)}m
+              </td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+
+      {/* NLP INTELLIGENCE BREAKDOWN */}
+      {result.nlp_results && (
+        <div style={{ marginBottom: '32px', pageBreakInside: 'avoid', breakInside: 'avoid' }}>
+          <h2 style={{ fontSize: '18px', fontWeight: 700, color: '#334155', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '16px' }}>
+            Live Market Intelligence (NLP Breakdown)
+          </h2>
+          <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr 1fr', gap: '16px', background: '#f8fafc', padding: '24px', borderRadius: '12px', border: '1px solid #e2e8f0' }}>
+            <div>
+              <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Recent Form & Impact</div>
+              <div style={{ fontSize: '18px', fontWeight: 700, color: result.nlp_results.recency < 0 ? '#ef4444' : '#22c55e' }}>
+                {result.nlp_results.recency > 0 ? '+' : ''}{result.nlp_results.recency.toFixed(2)}
+              </div>
+            </div>
+            <div>
+              <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Injury / Availability</div>
+              <div style={{ fontSize: '18px', fontWeight: 700, color: result.nlp_results.durability < 0 ? '#ef4444' : '#0f172a' }}>
+                {result.nlp_results.durability > 0 ? '+' : ''}{result.nlp_results.durability.toFixed(2)}
+              </div>
+            </div>
+            <div>
+              <div style={{ fontSize: '11px', color: '#64748b', textTransform: 'uppercase' }}>Transfer Speculation</div>
+              <div style={{ fontSize: '18px', fontWeight: 700, color: result.nlp_results.agent < 0 ? '#ef4444' : '#22c55e' }}>
+                {result.nlp_results.agent > 0 ? '+' : ''}{result.nlp_results.agent.toFixed(2)}
+              </div>
+            </div>
+          </div>
+          <div style={{ fontSize: '13px', color: '#64748b', marginTop: '12px', lineHeight: 1.5 }}>
+            <strong>How this works:</strong> The Live NLP Market Multiplier (currently <strong>×{L.external_multiplier.toFixed(3)}</strong>) is calculated from the sentiment scores above. A multiplier of exactly 1.000 means perfectly neutral market hype. A score above 1.0 indicates high demand and positive news, allowing the selling club to charge a premium. A score below 1.0 indicates negative press (e.g. poor form or injury history), creating leverage to negotiate a discount.
+          </div>
+        </div>
+      )}
+
+      {/* VERDICT & SUMMARY */}
+      <div style={{ marginBottom: '40px', pageBreakBefore: 'always', breakBefore: 'page' }}>
+        <h2 style={{ fontSize: '18px', fontWeight: 700, color: '#334155', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '16px' }}>
+          Executive Summary & Verdict
+        </h2>
+        <div style={{ padding: '24px', background: isOverpay ? '#fef2f2' : '#f0fdf4', border: `1px solid ${isOverpay ? '#fecaca' : '#bbf7d0'}`, borderRadius: '12px' }}>
+          <p style={{ fontSize: '15px', color: isOverpay ? '#991b1b' : '#166534', lineHeight: 1.6, marginBottom: '16px' }}>
+            <strong>Negotiation Intel:</strong> Based on the real-time evaluation engine, {form.selected_name}'s intrinsic value sits at £{L.intrinsic_performance_value.toFixed(1)}m. 
+            Adjusting for age and contract dynamics (£{L.depreciation.toFixed(1)}m) and live market NLP sentiment (×{L.external_multiplier.toFixed(3)}), 
+            the absolute financial ceiling (Fair Value) is strictly calculated at <strong>£{L.hard_cap.toFixed(1)}m</strong>.
+            <br/><br/>
+            <strong>Validation:</strong> {result.nlp_results.recency > 0 ? "Player's recent form commands a premium in the market." : "Recent form is suboptimal, creating leverage for a lower fee."} {L.depreciation < 0 ? "Age profile indicates significant depreciation risk—use this to negotiate down." : "Player's age and contract profile guarantees long-term asset retention, justifying a premium."}
+          </p>
+          <div style={{ fontSize: '18px', fontWeight: 800, color: isOverpay ? '#dc2626' : '#16a34a', borderTop: `1px solid ${isOverpay ? '#fca5a5' : '#86efac'}`, paddingTop: '16px' }}>
+            VERDICT: {isOverpay ? 'OVERPAY RISK' : 'FAIR DEAL - PROCEED WITH CONFIDENCE'}
+          </div>
+          <div style={{ fontSize: '14px', color: isOverpay ? '#b91c1c' : '#15803d', marginTop: '6px' }}>
+            The selling club's asking price of £{form.asking_price}m {isOverpay ? 'exceeds' : 'is safely within'} our calculated Fair Value.
+          </div>
+        </div>
+      </div>
+
+      {/* DEFINITION OF TERMS */}
+      <div style={{ borderTop: '2px solid #e2e8f0', paddingTop: '24px', pageBreakInside: 'avoid', breakInside: 'avoid' }}>
+        <h2 style={{ fontSize: '14px', fontWeight: 700, color: '#64748b', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '12px' }}>
+          Definition of Terms
+        </h2>
+        <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '16px', fontSize: '12px', color: '#475569', lineHeight: 1.5 }}>
+          <div>
+            <strong style={{ color: '#0f172a' }}>Intrinsic Performance Value:</strong> Player's raw talent value derived purely from on-pitch statistics.
+          </div>
+          <div>
+            <strong style={{ color: '#0f172a' }}>Age & Contract Impact:</strong> Financial adjustment based on age and remaining contract years.
+          </div>
+          <div>
+            <strong style={{ color: '#0f172a' }}>NLP Multiplier:</strong> Live web-scraping adjustment factor. Values {'>'} 1.0 indicate positive hype (premium), while values {'<'} 1.0 indicate negative press (discount).
+          </div>
+          <div>
+            <strong style={{ color: '#0f172a' }}>Fair Value:</strong> The absolute maximum recommended price (financial ceiling).
+          </div>
+        </div>
+      </div>
+
+    </div>
+  )
+})

fairvalue-webapp/src/components/SecretGate.tsx

@@ -0,0 +1,204 @@
+import { useState, useRef, useEffect } from 'react';
+import { motion, AnimatePresence } from 'framer-motion';
+import { ShieldCheck, KeyRound, AlertTriangle } from 'lucide-react';
+const STORAGE_KEY = 'fv_access_granted';
+
+export function useAccessControl() {
+  const [granted, setGranted] = useState<boolean>(() => {
+    return sessionStorage.getItem(STORAGE_KEY) === 'true';
+  });
+
+  const grant = () => {
+    sessionStorage.setItem(STORAGE_KEY, 'true');
+    setGranted(true);
+  };
+
+  return { granted, grant };
+}
+
+interface SecretGateProps {
+  onGranted: () => void;
+}
+
+export default function SecretGate({ onGranted }: SecretGateProps) {
+  const [code, setCode] = useState('');
+  const [error, setError] = useState(false);
+  const [errorMessage, setErrorMessage] = useState('');
+  const [shake, setShake] = useState(false);
+  const [loading, setLoading] = useState(false);
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  useEffect(() => {
+    inputRef.current?.focus();
+  }, []);
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setLoading(true);
+    setError(false);
+    setErrorMessage('');
+
+    try {
+      const apiUrl = import.meta.env.VITE_API_URL || 'http://localhost:8000';
+      const response = await fetch(`${apiUrl}/api/validate-code`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ code }),
+      });
+
+      const data = await response.json();
+
+      if (response.ok && data.status === 'success') {
+        onGranted();
+      } else {
+        setError(true);
+        setShake(true);
+        setErrorMessage(data.detail || 'Invalid or expired code.');
+        setCode('');
+        setTimeout(() => setShake(false), 600);
+      }
+    } catch (err) {
+      setError(true);
+      setShake(true);
+      setErrorMessage('Server connection failed.');
+      setTimeout(() => setShake(false), 600);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div style={{
+      position: 'fixed', inset: 0, zIndex: 9999,
+      background: 'radial-gradient(ellipse at 30% 20%, rgba(59,130,246,0.12) 0%, transparent 60%), radial-gradient(ellipse at 70% 80%, rgba(34,197,94,0.08) 0%, transparent 60%), var(--bg-0)',
+      display: 'flex', alignItems: 'center', justifyContent: 'center',
+      backdropFilter: 'blur(12px)',
+    }}>
+      {/* Ambient orbs */}
+      <div style={{ position: 'absolute', top: '10%', left: '15%', width: 400, height: 400, background: 'rgba(59,130,246,0.06)', borderRadius: '50%', filter: 'blur(120px)', pointerEvents: 'none' }} />
+      <div style={{ position: 'absolute', bottom: '15%', right: '10%', width: 350, height: 350, background: 'rgba(34,197,94,0.05)', borderRadius: '50%', filter: 'blur(100px)', pointerEvents: 'none' }} />
+
+      <motion.div
+        initial={{ opacity: 0, y: 40, scale: 0.96 }}
+        animate={shake ? { x: [-12, 12, -8, 8, -4, 4, 0] } : { opacity: 1, y: 0, scale: 1 }}
+        transition={shake ? { duration: 0.5 } : { duration: 0.5, ease: 'easeOut' }}
+        style={{
+          width: '100%', maxWidth: '460px', margin: '0 24px',
+          background: 'rgba(255,255,255,0.04)',
+          border: error ? '1px solid rgba(239,68,68,0.4)' : '1px solid rgba(255,255,255,0.08)',
+          borderRadius: '20px',
+          padding: '48px 40px',
+          backdropFilter: 'blur(24px)',
+          boxShadow: error
+            ? '0 0 0 1px rgba(239,68,68,0.2), 0 32px 80px rgba(0,0,0,0.5)'
+            : '0 32px 80px rgba(0,0,0,0.5), 0 0 0 1px rgba(255,255,255,0.04)',
+          transition: 'border-color 0.3s, box-shadow 0.3s',
+          position: 'relative',
+        }}
+      >
+        {/* Header */}
+        <div style={{ textAlign: 'center', marginBottom: '36px' }}>
+          <motion.div
+            animate={{ rotate: [0, -5, 5, -3, 3, 0] }}
+            transition={{ duration: 2, repeat: Infinity, repeatDelay: 4 }}
+            style={{
+              width: 72, height: 72, borderRadius: '50%',
+              background: 'linear-gradient(135deg, rgba(59,130,246,0.15), rgba(34,197,94,0.1))',
+              border: '1px solid rgba(59,130,246,0.25)',
+              display: 'flex', alignItems: 'center', justifyContent: 'center',
+              margin: '0 auto 24px',
+            }}
+          >
+            <KeyRound size={30} color="#60a5fa" />
+          </motion.div>
+
+          <div style={{
+            display: 'inline-flex', alignItems: 'center', gap: 6,
+            padding: '4px 14px',
+            background: 'rgba(59,130,246,0.1)',
+            border: '1px solid rgba(59,130,246,0.2)',
+            borderRadius: 100, marginBottom: 20,
+          }}>
+            <ShieldCheck size={12} color="#3b82f6" />
+            <span style={{ fontSize: '0.72rem', fontWeight: 700, color: '#60a5fa', letterSpacing: '0.1em', textTransform: 'uppercase' }}>
+              Restricted Access
+            </span>
+          </div>
+
+          <h2 style={{ fontSize: '1.75rem', fontWeight: 800, marginBottom: 12, letterSpacing: '-0.03em' }}
+              className="display-font">
+            Enter Access Code
+          </h2>
+          <p style={{ color: 'var(--text-3)', fontSize: '0.9rem', lineHeight: 1.7 }}>
+            This platform is restricted to authorised personnel. Enter your secret access code to continue.
+          </p>
+        </div>
+
+        {/* Form */}
+        <form onSubmit={handleSubmit} style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+          <div style={{ position: 'relative' }}>
+            <input
+              ref={inputRef}
+              type="password"
+              value={code}
+              onChange={e => { setCode(e.target.value); setError(false); }}
+              placeholder="FV-ALPHA-101"
+              autoComplete="off"
+              disabled={loading}
+              style={{
+                width: '100%',
+                padding: '14px 18px',
+                background: 'rgba(255,255,255,0.05)',
+                border: error ? '1px solid rgba(239,68,68,0.6)' : '1px solid rgba(255,255,255,0.1)',
+                borderRadius: 12,
+                color: 'var(--text-1)',
+                fontSize: '1rem',
+                letterSpacing: '0.15em',
+                outline: 'none',
+                transition: 'border-color 0.2s',
+                boxSizing: 'border-box',
+              }}
+            />
+          </div>
+
+          <AnimatePresence>
+            {error && (
+              <motion.div
+                initial={{ opacity: 0, y: -8 }}
+                animate={{ opacity: 1, y: 0 }}
+                exit={{ opacity: 0 }}
+                style={{
+                  display: 'flex', alignItems: 'center', gap: 8,
+                  padding: '10px 14px',
+                  background: 'rgba(239,68,68,0.08)',
+                  border: '1px solid rgba(239,68,68,0.2)',
+                  borderRadius: 10,
+                  color: '#f87171', fontSize: '0.85rem',
+                }}
+              >
+                <AlertTriangle size={15} />
+                {errorMessage}
+              </motion.div>
+            )}
+          </AnimatePresence>
+
+          <button
+            type="submit"
+            className="btn btn-secondary"
+            disabled={loading}
+            style={{ width: '100%', padding: '14px', fontSize: '0.95rem', fontWeight: 700, marginTop: 4, cursor: loading ? 'wait' : 'pointer' }}
+          >
+            {loading ? 'Verifying...' : 'Unlock Platform →'}
+          </button>
+        </form>
+
+        <p style={{ textAlign: 'center', marginTop: 24, fontSize: '0.78rem', color: 'var(--text-3)' }}>
+          Don't have an access code?{' '}
+          <a href="mailto:oladeji.lawrence@gmail.com" style={{ color: '#60a5fa', textDecoration: 'none' }}>
+            Request access →
+          </a>
+        </p>
+      </motion.div>
+    </div>
+  );
+}

fairvalue-webapp/src/hooks/useUsageLimiter.ts

@@ -0,0 +1,36 @@
+import { useState, useEffect } from 'react';
+
+const USAGE_KEY = 'fairvalue_evaluation_count';
+const MAX_USES = 3;
+
+export function useUsageLimiter() {
+  const [useCount, setUseCount] = useState<number>(0);
+  const [isLocked, setIsLocked] = useState<boolean>(false);
+
+  useEffect(() => {
+    if (sessionStorage.getItem('fv_access_granted') === 'true') return;
+    
+    const stored = localStorage.getItem(USAGE_KEY);
+    const count = stored ? parseInt(stored, 10) : 0;
+    setUseCount(count);
+    if (count >= MAX_USES) {
+      setIsLocked(true);
+    }
+  }, []);
+
+  const incrementUsage = () => {
+    if (sessionStorage.getItem('fv_access_granted') === 'true') return true;
+    
+    const newCount = useCount + 1;
+    setUseCount(newCount);
+    localStorage.setItem(USAGE_KEY, newCount.toString());
+    if (newCount >= MAX_USES) {
+      setIsLocked(true);
+      return false; // Tells the caller it just locked
+    }
+    return true; // Still allowed
+  };
+
+  return { useCount, isLocked, incrementUsage, MAX_USES };
+}
+

fairvalue-webapp/src/index.css

@@ -1,37 +1,33 @@
-@import url('https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,300;0,14..32,400;0,14..32,500;0,14..32,600;0,14..32,700;0,14..32,800;1,14..32,400&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700;800&family=Inter:wght@400;500;600&display=swap');
 
-/* ── Design Tokens ───────────────────────────────────────────────────────────── */
+/* ── UI/UX Pro Max: Financial Cinematic Dashboard Tokens ───────────────────────── */
 :root {
-  --bg-base:       #070711;
-  --bg-elevated:   #0d0d1a;
-  --bg-elevated-2: #131326;
+  --bg-base:       #04040a;
+  --bg-elevated:   #090913;
+  --bg-elevated-2: #121222;
 
-  --glass-bg:      rgba(255,255,255,0.04);
+  --glass-bg:      rgba(255,255,255,0.03);
   --glass-border:  rgba(255,255,255,0.08);
-  --glass-hover:   rgba(255,255,255,0.07);
+  --glass-border-hi: rgba(255,255,255,0.15);
+  --glass-hover:   rgba(255,255,255,0.06);
 
-  --green:         #00e87a;
-  --green-dim:     rgba(0,232,122,0.10);
-  --green-glow:    0 0 24px rgba(0,232,122,0.25);
+  /* Semantic Financial Colors per Guidelines */
+  --profit-color:  #22C55E; /* Trust Green */
+  --loss-color:    #EF4444; /* Alert Red */
+  --neutral-color: #6B7280;
+  
+  --accent-blue:   #3B82F6;
+  --accent-glow:   0 0 30px rgba(59, 130, 246, 0.25);
 
-  --blue:          #4f8ef7;
-  --blue-dim:      rgba(79,142,247,0.10);
-
-  --red:           #ff4d6d;
-  --red-dim:       rgba(255,77,109,0.10);
-
-  --gold:          #f5a623;
-  --gold-dim:      rgba(245,166,35,0.10);
-
-  --text-1: #eeeef8;
-  --text-2: #8888aa;
-  --text-3: #505070;
+  --text-1: #ffffff;
+  --text-2: #94a3b8;
+  --text-3: #64748b;
 
   --radius:    12px;
-  --radius-lg: 18px;
-  --radius-xl: 24px;
+  --radius-lg: 20px;
+  --radius-xl: 28px;
 
-  --transition: all 0.2s cubic-bezier(0.4,0,0.2,1);
+  --transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1);
 }
 
 /* ── Reset ───────────────────────────────────────────────────────────────────── */
@@ -44,32 +40,44 @@ body {
   line-height: 1.6;
   -webkit-font-smoothing: antialiased;
   min-height: 100vh;
+  /* Deep cinematic radial gradient background */
+  background-image: radial-gradient(circle at 50% 0%, rgba(59, 130, 246, 0.08) 0%, transparent 60%);
+  background-repeat: no-repeat;
+  background-attachment: fixed;
 }
 a { color: inherit; text-decoration: none; }
 button { font-family: inherit; }
 
-/* ── Typography ──────────────────────────────────────────────────────────────── */
-h1 { font-size: clamp(2rem,5vw,3.6rem); font-weight: 800; line-height: 1.1; letter-spacing: -0.03em; }
-h2 { font-size: clamp(1.4rem,3vw,2.1rem); font-weight: 700; letter-spacing: -0.02em; }
-h3 { font-size: 1.2rem; font-weight: 600; letter-spacing: -0.01em; }
-h4 { font-size: 0.95rem; font-weight: 600; }
+/* ── Typography (Display vs. Body) ───────────────────────────────────────────── */
+h1, h2, h3, h4, .display-font { font-family: 'Outfit', sans-serif; }
+h1 { font-size: clamp(2.5rem,6vw,4.5rem); font-weight: 800; line-height: 1.05; letter-spacing: -0.04em; }
+h2 { font-size: clamp(1.8rem,4vw,2.8rem); font-weight: 700; letter-spacing: -0.03em; }
+h3 { font-size: 1.3rem; font-weight: 600; letter-spacing: -0.02em; }
+h4 { font-size: 1rem; font-weight: 600; }
 p  { color: var(--text-2); line-height: 1.7; }
 
 /* ── Layout ──────────────────────────────────────────────────────────────────── */
-.container { max-width: 1280px; margin: 0 auto; padding: 0 24px; }
-.page      { min-height: calc(100vh - 68px); padding: 48px 0 80px; }
+.container { max-width: 1200px; margin: 0 auto; padding: 0 28px; }
+.page      { min-height: calc(100vh - 68px); padding: 56px 0 100px; }
 
-/* ── Glass Card ──────────────────────────────────────────────────────────────── */
+/* ── UI Pro Max Glass Card (Rim Lighting & Shadow layers) ────────────────────── */
 .glass {
-  background: var(--glass-bg);
+  background: linear-gradient(145deg, rgba(255,255,255,0.05) 0%, rgba(255,255,255,0.01) 100%);
   border: 1px solid var(--glass-border);
   border-radius: var(--radius-lg);
-  backdrop-filter: blur(16px);
+  backdrop-filter: blur(24px);
+  box-shadow: 
+    0 4px 24px -1px rgba(0,0,0,0.4),
+    inset 0 1px 0 0 rgba(255,255,255,0.1); /* Top rim light */
   transition: var(--transition);
 }
 .glass:hover {
-  background: var(--glass-hover);
-  border-color: rgba(255,255,255,0.12);
+  background: linear-gradient(145deg, rgba(255,255,255,0.07) 0%, rgba(255,255,255,0.02) 100%);
+  border-color: var(--glass-border-hi);
+  transform: translateY(-2px);
+  box-shadow: 
+    0 12px 32px -4px rgba(0,0,0,0.5),
+    inset 0 1px 0 0 rgba(255,255,255,0.15);
 }
 .glass-flat {
   background: var(--bg-elevated);
@@ -79,155 +87,168 @@ p  { color: var(--text-2); line-height: 1.7; }
 
 /* ── Buttons ─────────────────────────────────────────────────────────────────── */
 .btn {
-  display: inline-flex; align-items: center; gap: 8px;
-  padding: 12px 26px;
+  display: inline-flex; align-items: center; gap: 8px; justify-content: center;
+  padding: 14px 28px;
   border-radius: var(--radius);
-  font-size: 0.92rem; font-weight: 600;
+  font-family: 'Outfit', sans-serif;
+  font-size: 1.05rem; font-weight: 600;
   cursor: pointer; border: none;
   transition: var(--transition);
   white-space: nowrap; text-decoration: none;
   letter-spacing: -0.01em;
 }
-.btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.btn:disabled { opacity: 0.5; cursor: not-allowed; }
 .btn-primary {
-  background: var(--green); color: #000;
-  box-shadow: var(--green-glow);
+  background: var(--text-1); color: #000;
+  box-shadow: 0 4px 14px 0 rgba(255,255,255,0.3);
 }
 .btn-primary:hover:not(:disabled) {
-  background: #0ff894;
-  box-shadow: 0 0 36px rgba(0,232,122,0.45);
-  transform: translateY(-1px);
+  background: #f0f0f0;
+  box-shadow: 0 6px 20px rgba(255,255,255,0.4);
+  transform: translateY(-2px) scale(1.02);
+}
+.btn-secondary {
+  background: linear-gradient(135deg, var(--accent-blue), #2563eb);
+  color: #fff;
+  box-shadow: var(--accent-glow);
+}
+.btn-secondary:hover:not(:disabled) {
+  box-shadow: 0 0 40px rgba(59, 130, 246, 0.4);
+  transform: translateY(-2px);
 }
 .btn-ghost {
   background: var(--glass-bg); color: var(--text-1);
   border: 1px solid var(--glass-border);
 }
-.btn-ghost:hover { background: var(--glass-hover); }
-.btn-lg { padding: 15px 34px; font-size: 1rem; border-radius: var(--radius-lg); }
+.btn-ghost:hover:not(:disabled) { 
+  background: var(--glass-hover); 
+  border-color: var(--glass-border-hi);
+}
+.btn-lg { padding: 18px 40px; font-size: 1.15rem; border-radius: var(--radius-lg); }
 
 /* ── Form Inputs ─────────────────────────────────────────────────────────────── */
-.input-group { display: flex; flex-direction: column; gap: 6px; }
+.input-group { display: flex; flex-direction: column; gap: 8px; }
 .field-label {
-  font-size: 0.73rem; font-weight: 600;
+  font-family: 'Outfit', sans-serif;
+  font-size: 0.8rem; font-weight: 600;
   color: var(--text-2);
-  text-transform: uppercase; letter-spacing: 0.07em;
+  text-transform: uppercase; letter-spacing: 0.08em;
 }
 .input, select.input {
-  background: var(--bg-elevated);
+  background: #0a0a14;
   border: 1px solid var(--glass-border);
   border-radius: var(--radius);
   color: var(--text-1);
-  font-size: 0.9rem; font-family: inherit;
-  padding: 10px 14px;
+  font-size: 1rem; font-family: inherit;
+  padding: 12px 16px;
   outline: none;
   transition: var(--transition);
   width: 100%;
 }
 .input:focus, select.input:focus {
-  border-color: var(--green);
-  box-shadow: 0 0 0 3px rgba(0,232,122,0.12);
+  border-color: var(--accent-blue);
+  box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.15);
 }
 select.input option { background: var(--bg-elevated); }
-textarea.input { resize: vertical; min-height: 80px; }
+textarea.input { resize: vertical; min-height: 100px; }
 
-/* Range slider */
+/* Range slider tracking */
 input[type="range"] {
   -webkit-appearance: none; appearance: none;
-  width: 100%; height: 4px; border-radius: 2px;
+  width: 100%; height: 6px; border-radius: 3px;
   background: var(--bg-elevated-2); outline: none;
-  margin: 4px 0;
+  margin: 6px 0;
 }
 input[type="range"]::-webkit-slider-thumb {
   -webkit-appearance: none;
-  width: 18px; height: 18px; border-radius: 50%;
-  background: var(--green); cursor: pointer;
-  box-shadow: 0 0 10px rgba(0,232,122,0.5);
+  width: 20px; height: 20px; border-radius: 50%;
+  background: var(--text-1); cursor: pointer;
+  box-shadow: 0 0 12px rgba(255,255,255,0.5);
+  transition: transform 0.1s;
 }
-.range-row { display: flex; justify-content: space-between; font-size: 0.78rem; color: var(--text-3); }
-.range-val { font-size: 0.95rem; font-weight: 700; color: var(--green); }
+input[type="range"]::-webkit-slider-thumb:hover { transform: scale(1.15); }
+.range-row { display: flex; justify-content: space-between; font-size: 0.8rem; color: var(--text-3); font-weight: 500;}
+.range-val { font-size: 1.05rem; font-weight: 700; color: var(--text-1); font-family: 'Outfit', sans-serif;}
 
-/* ── Metrics ─────────────────────────────────────────────────────────────────── */
-.metric   { display: flex; flex-direction: column; gap: 3px; }
+/* ── Financial Metrics ───────────────────────────────────────────────────────── */
+.metric   { display: flex; flex-direction: column; gap: 4px; }
 .metric-label {
-  font-size: 0.7rem; font-weight: 600;
-  color: var(--text-2);
-  text-transform: uppercase; letter-spacing: 0.07em;
+  font-size: 0.75rem; font-weight: 600;
+  color: var(--text-2); font-family: 'Outfit', sans-serif;
+  text-transform: uppercase; letter-spacing: 0.05em;
 }
-.metric-value { font-size: 1.8rem; font-weight: 800; letter-spacing: -0.03em; line-height: 1; }
-.metric-note  { font-size: 0.75rem; color: var(--text-3); }
+.metric-value { font-size: 2.2rem; font-weight: 800; letter-spacing: -0.04em; line-height: 1; font-family: 'Outfit', sans-serif; }
+.metric-note  { font-size: 0.8rem; color: var(--text-3); }
+.value-up     { color: var(--profit-color); }
+.value-down   { color: var(--loss-color); }
 
 /* ── Badges ──────────────────────────────────────────────────────────────────── */
 .badge {
-  display: inline-flex; align-items: center;
-  padding: 3px 10px; border-radius: 100px;
-  font-size: 0.72rem; font-weight: 700; letter-spacing: 0.03em;
+  display: inline-flex; align-items: center; gap: 6px;
+  padding: 6px 14px; border-radius: 100px;
+  font-size: 0.78rem; font-weight: 700; letter-spacing: 0.04em;
+  font-family: 'Outfit', sans-serif; text-transform: uppercase;
 }
-.badge-green { background: var(--green-dim); color: var(--green); }
-.badge-blue  { background: var(--blue-dim);  color: var(--blue);  }
-.badge-red   { background: var(--red-dim);   color: var(--red);   }
-.badge-gold  { background: var(--gold-dim);  color: var(--gold);  }
-
-/* ── Alerts ──────────────────────────────────────────────────────────────────── */
-.alert {
-  padding: 14px 18px; border-radius: var(--radius);
-  font-size: 0.88rem; font-weight: 500;
-  border-left: 3px solid;
-}
-.alert-success { background: var(--green-dim); border-color: var(--green); color: var(--green); }
-.alert-danger  { background: var(--red-dim);   border-color: var(--red);   color: var(--red);   }
-.alert-info    { background: var(--blue-dim);  border-color: var(--blue);  color: var(--blue);  }
-
-/* ── Divider ─────────────────────────────────────────────────────────────────── */
-.divider { height: 1px; background: var(--glass-border); margin: 24px 0; }
-
-/* ── Animations ──────────────────────────────────────────────────────────────── */
-@keyframes fadeInUp {
-  from { opacity: 0; transform: translateY(20px); }
-  to   { opacity: 1; transform: translateY(0);    }
-}
-@keyframes pulse-ring {
-  0%,100% { box-shadow: 0 0 0 0   rgba(0,232,122,0.35); }
-  50%     { box-shadow: 0 0 0 10px rgba(0,232,122,0);    }
-}
-@keyframes spin {
-  to { transform: rotate(360deg); }
-}
-.animate-in { animation: fadeInUp 0.45s ease forwards; }
+.badge-blue  { background: rgba(59,130,246,0.15); color: #60a5fa; border: 1px solid rgba(59,130,246,0.3); }
+.badge-green { background: rgba(34,197,94,0.15);  color: #4ade80; border: 1px solid rgba(34,197,94,0.3); }
+.badge-red   { background: rgba(239,68,68,0.15);  color: #f87171; border: 1px solid rgba(239,68,68,0.3); }
+.badge-warning { background: rgba(245,158,11,0.15); color: #fbbf24; border: 1px solid rgba(245,158,11,0.3); }
 
 /* ── Grid Helpers ────────────────────────────────────────────────────────────── */
-.grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }
-.grid-3 { display: grid; grid-template-columns: repeat(3,1fr); gap: 16px; }
-.grid-4 { display: grid; grid-template-columns: repeat(4,1fr); gap: 16px; }
+.grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; }
+.grid-3 { display: grid; grid-template-columns: repeat(3,1fr); gap: 24px; }
+.grid-4 { display: grid; grid-template-columns: repeat(4,1fr); gap: 24px; }
 @media (max-width: 900px) { .grid-2 { grid-template-columns: 1fr; } }
 @media (max-width: 768px) { .grid-3, .grid-4 { grid-template-columns: 1fr 1fr; } }
 @media (max-width: 500px) { .grid-3, .grid-4 { grid-template-columns: 1fr; } }
 
-/* ── Spinner ���────────────────────────────────────────────────────────────────── */
-.spinner {
-  display: inline-block;
-  width: 18px; height: 18px;
-  border: 2px solid rgba(255,255,255,0.15);
-  border-top-color: var(--green);
-  border-radius: 50%;
-  animation: spin 0.7s linear infinite;
-  vertical-align: middle;
-}
-
-/* ── Scrollbar ───────────────────────────────────────────────────────────────── */
-::-webkit-scrollbar { width: 5px; }
-::-webkit-scrollbar-track { background: var(--bg-base); }
-::-webkit-scrollbar-thumb { background: var(--bg-elevated-2); border-radius: 3px; }
-
-/* ── Gradient Text ───────────────────────────────────────────────────────────── */
+/* ── Cinematic Gradient Text ─────────────────────────────────────────────────── */
 .gradient-text {
-  background: linear-gradient(135deg, var(--green) 0%, var(--blue) 100%);
+  background: linear-gradient(135deg, #fff 0%, #a1a1aa 100%);
+  -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+.gradient-accent {
+  background: linear-gradient(135deg, #60a5fa 0%, #3b82f6 100%);
   -webkit-background-clip: text; -webkit-text-fill-color: transparent;
   background-clip: text;
 }
 
-/* ── Sentiment Bar ───────────────────────────────────────────────────────────── */
+/* ── Modal Portal / Background Blur Tracker ──────────────────────────────────── */
+.modal-overlay {
+  position: fixed; inset: 0; z-index: 999;
+  background: rgba(0,0,0,0.6);
+  backdrop-filter: blur(12px);
+  display: flex; align-items: center; justify-content: center;
+  padding: 24px;
+}
+.modal-content {
+  width: 100%; max-width: 480px;
+  background: #04040a;
+  border-radius: var(--radius-xl);
+  border: 1px solid var(--glass-border-hi);
+  padding: 40px;
+  box-shadow: 0 24px 64px rgba(0,0,0,0.8), inset 0 1px 0 rgba(255,255,255,0.1);
+  position: relative;
+  overflow: hidden;
+}
+.modal-content::before {
+  content: ''; position: absolute; top: 0; left: 0; right: 0; height: 3px;
+  background: linear-gradient(90deg, var(--accent-blue), #22d3ee);
+}
+
+/* Tooltip Customization for High Contrast */
+.recharts-tooltip-wrapper { z-index: 10 !important; }
+.recharts-default-tooltip {
+  background-color: var(--bg-elevated) !important;
+  border: 1px solid var(--glass-border-hi) !important;
+  border-radius: 8px !important;
+  color: var(--text-1) !important;
+  box-shadow: 0 12px 24px rgba(0,0,0,0.5) !important;
+}
+
 .sentiment-bar-track {
-  height: 7px; border-radius: 4px;
+  height: 8px; border-radius: 4px;
   background: var(--bg-elevated-2);
   overflow: hidden;
 }
@@ -235,3 +256,48 @@ input[type="range"]::-webkit-slider-thumb {
   height: 100%; border-radius: 4px;
   transition: width 0.6s cubic-bezier(0.4,0,0.2,1);
 }
+
+/* ── Print Styles for PDF Generation ─────────────────────────────────────────── */
+@media print {
+  /* Hide all normal UI elements */
+  body > #root > .page > .container {
+    display: none !important;
+  }
+  .modal-overlay, .access-modal, .no-print, nav {
+    display: none !important;
+  }
+  
+  @page {
+    size: A4;
+    margin: 15mm;
+  }
+
+  /* Reset background and heights for clean printing */
+  body, html, #root, .page {
+    background: #ffffff !important;
+    background-image: none !important;
+    color: #0f172a !important;
+    margin: 0 !important;
+    padding: 0 !important;
+    height: auto !important;
+    min-height: 0 !important;
+  }
+
+  /* Make report visible and properly sized */
+  .printable-report {
+    display: block !important;
+    position: static !important;
+    width: auto !important;
+    background: white !important;
+    box-shadow: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+    min-height: 0 !important;
+  }
+
+  /* Force background colors to print (Chrome/Safari) */
+  * {
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+}

fairvalue-webapp/src/pages/AboutDeveloper.tsx

@@ -0,0 +1,244 @@
+import { motion } from 'framer-motion'
+import { Mail, Phone, ExternalLink, Briefcase, GraduationCap, Code, Database, BrainCircuit, LineChart } from 'lucide-react'
+
+const PROJECTS = [
+  {
+    title: 'FairValue Player Estimator',
+    tags: ['XGBoost', 'SHAP', 'React'],
+    desc: 'Advanced sport analytics platform deploying Hedonic Pricing models and NLP transfer intelligence to compute PSR compliance and mitigate winner\'s curse.',
+    link: '#', 
+  },
+  {
+    title: 'WHO ESPEN Nigeria Portal',
+    tags: ['Vercel Edge', 'Leaflet', 'Node.js'],
+    desc: 'A premium analytics platform deployed for international public health monitoring. Engineered real-time supply chain latency algorithms bridging SQL logic with JavaScript, enveloped in a stunning glassmorphism geospatial UX.',
+    link: 'https://who-espen-nigeria-ntd.vercel.app/',
+  },
+  {
+    title: 'LinkyGen Intelligence',
+    tags: ['LangGraph', 'Agentic AI'],
+    desc: 'Advanced AI application utilizing a multi-agentic LangGraph architecture to streamline high-quality dynamic content pipelines.',
+    link: 'https://linkygen.streamlit.app/',
+  },
+  {
+    title: 'SESA AI Optimization',
+    tags: ['Multi-Agent', 'Python'],
+    desc: 'Stochastic optimization engine built on Agentic AI orchestration to minimize smart building electricity via BESS arbitrage.',
+    link: 'https://sesa-energy.streamlit.app/',
+  },
+  {
+    title: 'Stratos Content Empire',
+    tags: ['LangGraph', 'Streamlit'],
+    desc: 'Strategic AI marketing tool powered by LangGraph multi-agent orchestration mapping pinpoint audience intent.',
+    link: 'https://stratos-content.streamlit.app/',
+  },
+  {
+    title: 'XGen Studio',
+    tags: ['CrewAI', 'LangChain'],
+    desc: 'Viral writing assistant leveraging a multi-agent LLM workflow to scale brand growth via highly-humanized narratives.',
+    link: 'https://xgenstudio.streamlit.app/',
+  },
+  {
+    title: 'Finstratz Analytics',
+    tags: ['TensorFlow', 'Python'],
+    desc: 'Python-based financial suite utilizing deep learning (TensorFlow) to forecast stock trends and price variations.',
+    link: 'https://finstratz.streamlit.app/',
+  },
+  {
+    title: 'Stanbic IBTC Simulator',
+    tags: ['Financial Modeling', 'Data Science'],
+    desc: 'App generating robust performance forecasts across complex Money Market portfolios.',
+    link: 'https://stanbic-ibtc-portfolio-simulation.streamlit.app/',
+  },
+]
+
+export default function AboutDeveloper() {
+  return (
+    <div className="page" style={{ overflow: 'hidden' }}>
+      
+      {/* ── Cinematic Hero ────────────────────────────────────────────────── */}
+      <section className="container" style={{ padding: '40px 24px 60px', borderBottom: '1px solid var(--glass-border)' }}>
+        <motion.div 
+          initial={{ opacity: 0, y: 30 }}
+          animate={{ opacity: 1, y: 0 }}
+          transition={{ duration: 0.6, ease: "easeOut" }}
+          style={{ display: 'grid', gridTemplateColumns: 'minmax(300px, 1fr) auto', gap: '48px', alignItems: 'center' }}
+        >
+          <div>
+            <div style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', marginBottom: '24px', padding: '6px 16px', background: 'rgba(34,197,94,0.1)', border: '1px solid rgba(34,197,94,0.2)', borderRadius: '100px' }}>
+              <span style={{ width: 8, height: 8, borderRadius: '50%', background: '#22C55E', animation: 'pulse-ring 2s infinite' }} />
+              <span style={{ fontSize: '0.8rem', fontWeight: 600, color: '#4ade80', letterSpacing: '0.05em', textTransform: 'uppercase' }}>
+                Open to Mid/Senior Roles Globally
+              </span>
+            </div>
+
+            <h1 className="display-font" style={{ marginBottom: '16px', fontSize: ' clamp(2.5rem, 5vw, 4rem)' }}>Lawrence Oladeji</h1>
+            <h2 style={{ fontSize: '1.4rem', color: 'var(--accent-blue)', marginBottom: '24px', fontWeight: 600 }}>
+              AI-Native Data Scientist & Sports Pricing Strategist
+            </h2>
+
+            <p style={{ maxWidth: '720px', fontSize: '1.1rem', lineHeight: 1.8, color: 'var(--text-2)', marginBottom: '32px' }}>
+              I am an AI-Native Data Associate with 3+ years of experience transforming complex datasets into strategic insights for executive decision-making. 
+              My expertise encompasses sports analytics, hedonic pricing models, AI-driven transfer logic, and traditional Business Intelligence heavily augmented 
+              by deep expertise in Generative AI and LLM orchestration (LangGraph, CrewAI). I am profoundly passionate about architecting scalable, data-driven solutions at the intersection of quantitative sport economics and Agentic AI.
+            </p>
+
+            <div style={{ display: 'flex', gap: '16px', flexWrap: 'wrap' }}>
+              <a href="mailto:oladeji.lawrence@gmail.com" className="btn btn-secondary">
+                <Mail size={18} /> oladeji.lawrence@gmail.com
+              </a>
+              <a href="https://github.com/Lawrencium-103" target="_blank" rel="noreferrer" className="btn btn-ghost">
+                <Code size={18} /> GitHub: Lawrencium-103
+              </a>
+              <span className="btn btn-ghost" style={{ cursor: 'default' }}>
+                <Phone size={18} /> +234 903 881 9790
+              </span>
+            </div>
+          </div>
+        </motion.div>
+      </section>
+
+      {/* ── Expertise Grid ────────────────────────────────────────────────── */}
+      <section className="container" style={{ padding: '80px 24px' }}>
+        <h2 className="display-font" style={{ marginBottom: '40px', textAlign: 'center' }}>Core Competencies</h2>
+        <div className="grid-3">
+          <motion.div whileHover={{ y: -5 }} className="glass" style={{ padding: '32px' }}>
+            <LineChart size={32} color="#f5a623" style={{ marginBottom: '20px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Sports Pricing & BI</h3>
+            <p style={{ fontSize: '0.9rem', color: 'var(--text-2)', marginBottom: '16px' }}>
+              Transforming raw datasets into executive C-Suite narratives. Expert in translating complex valuations (Transfer Estimators) and multi-million-dollar portfolios into interactive command centers.
+            </p>
+            <div style={{ display: 'flex', gap: '8px', flexWrap: 'wrap' }}>
+              <span className="badge badge-gold">Power BI / DAX</span>
+              <span className="badge badge-gold">Tableau</span>
+              <span className="badge badge-gold">XGBoost / SHAP</span>
+            </div>
+          </motion.div>
+
+          <motion.div whileHover={{ y: -5 }} className="glass" style={{ padding: '32px' }}>
+            <Database size={32} color="#22c55e" style={{ marginBottom: '20px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Data Engineering</h3>
+            <p style={{ fontSize: '0.9rem', color: 'var(--text-2)', marginBottom: '16px' }}>
+              Architecting scalable pipelines and robust data models. Proven track record dropping query latency by 15% across global health databanks using optimized SQL architectures.
+            </p>
+            <div style={{ display: 'flex', gap: '8px', flexWrap: 'wrap' }}>
+              <span className="badge badge-green">PostgreSQL</span>
+              <span className="badge badge-green">BigQuery</span>
+              <span className="badge badge-green">Airflow ETL</span>
+            </div>
+          </motion.div>
+
+          <motion.div whileHover={{ y: -5 }} className="glass" style={{ padding: '32px' }}>
+            <BrainCircuit size={32} color="#3b82f6" style={{ marginBottom: '20px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Agentic AI & LLMs</h3>
+            <p style={{ fontSize: '0.9rem', color: 'var(--text-2)', marginBottom: '16px' }}>
+              Designing autonomous workflows orchestrating complex data routing via LLMs. Pioneering the integration of multi-agentic reasoning frameworks into traditional data domains.
+            </p>
+            <div style={{ display: 'flex', gap: '8px', flexWrap: 'wrap' }}>
+              <span className="badge badge-blue">LangGraph</span>
+              <span className="badge badge-blue">CrewAI</span>
+              <span className="badge badge-blue">Python</span>
+            </div>
+          </motion.div>
+        </div>
+      </section>
+
+      {/* ── Professional Blueprint ────────────────────────────────────────── */}
+      <section style={{ background: 'rgba(255,255,255,0.01)', borderTop: '1px solid var(--glass-border)', borderBottom: '1px solid var(--glass-border)' }}>
+        <div className="container" style={{ padding: '80px 24px' }}>
+          <h2 className="display-font" style={{ marginBottom: '48px', color: 'var(--text-1)' }}>Professional Blueprint & Background</h2>
+          
+          <div className="grid-2">
+            <div style={{ display: 'flex', flexDirection: 'column', gap: '32px' }}>
+              
+              <div className="glass-flat" style={{ padding: '32px', position: 'relative' }}>
+                <div style={{ position: 'absolute', left: 0, top: 0, bottom: 0, width: '4px', background: 'var(--accent-blue)', borderTopLeftRadius: 'var(--radius-lg)', borderBottomLeftRadius: 'var(--radius-lg)' }} />
+                <div style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '8px' }}>
+                  <Briefcase size={20} color="var(--accent-blue)" />
+                  <h3 style={{ margin: 0 }}>Data Associate</h3>
+                </div>
+                <div style={{ fontSize: '0.85rem', color: 'var(--text-3)', marginBottom: '20px', fontWeight: 600 }}>May 2024 – Present</div>
+                <ul style={{ paddingLeft: '20px', color: 'var(--text-2)', fontSize: '0.95rem', display: 'flex', flexDirection: 'column', gap: '8px' }}>
+                  <li>Designed and deployed executive-level Power BI dashboards for C-Suite stakeholders, optimizing multi-million-dollar portfolios.</li>
+                  <li>Engineered complex SQL data models on BigQuery & PostgreSQL, cutting query latency by 15% across 50+ key indicators.</li>
+                  <li>Centralized 56,000+ data points across 1,450+ indicators from world-class sources (World Bank, WHO) to ensure 100% regulatory reporting accuracy.</li>
+                  <li>Constructed AI content frameworks utilizing multi-agent reasoning to automate reporting, saving significant overhead blocks.</li>
+                </ul>
+              </div>
+
+              <div className="glass-flat" style={{ padding: '32px', position: 'relative' }}>
+                <div style={{ position: 'absolute', left: 0, top: 0, bottom: 0, width: '4px', background: 'var(--text-3)', borderTopLeftRadius: 'var(--radius-lg)', borderBottomLeftRadius: 'var(--radius-lg)' }} />
+                <div style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '8px' }}>
+                  <Briefcase size={20} color="var(--text-3)" />
+                  <h3 style={{ margin: 0 }}>Junior BI / Data Operations Analyst</h3>
+                </div>
+                <div style={{ fontSize: '0.85rem', color: 'var(--text-3)', marginBottom: '20px', fontWeight: 600 }}>2019 – April 2024</div>
+                <ul style={{ paddingLeft: '20px', color: 'var(--text-2)', fontSize: '0.95rem', display: 'flex', flexDirection: 'column', gap: '8px' }}>
+                  <li>Synthesized business requirements into actionable data models for E-mobility.</li>
+                  <li>Executed statistical modeling predicting demand, cutting lifecycles by 20%.</li>
+                  <li>Identified high ROI cost-savings via exploratory spatial geospatial analysis.</li>
+                </ul>
+              </div>
+            </div>
+
+            <div style={{ display: 'flex', flexDirection: 'column', gap: '32px' }}>
+              <h3 style={{ display: 'flex', alignItems: 'center', gap: '8px', paddingBottom: '12px', borderBottom: '1px solid var(--glass-border)' }}>
+                <GraduationCap size={22} color="var(--green)" /> Academic Background
+              </h3>
+              
+              <div>
+                <h4 style={{ fontSize: '1.1rem', marginBottom: '4px' }}>MSc in Mechanical Engineering</h4>
+                <div style={{ color: 'var(--text-2)', fontSize: '0.9rem' }}>University of Ibadan · 2023 - 2024</div>
+              </div>
+
+              <div>
+                <h4 style={{ fontSize: '1.1rem', marginBottom: '4px' }}>BSc in Mechanical Engineering (2:1 Honors)</h4>
+                <div style={{ color: 'var(--text-2)', fontSize: '0.9rem' }}>Federal Univ. of Agriculture, Abeokuta · CGPA: 3.99/5.0</div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* ── Portfolio Grid ────────────────────────────────────────────────── */}
+      <section className="container" style={{ padding: '80px 24px' }}>
+        <div style={{ textAlign: 'center', marginBottom: '56px' }}>
+          <h2 className="display-font" style={{ marginBottom: '16px' }}>Agentic & Analytics Portfolio</h2>
+          <p style={{ maxWidth: '600px', margin: '0 auto' }}>A selection of high-impact production dashboards and multi-agent AI ecosystems built across multiple domains.</p>
+        </div>
+
+        <div className="grid-2">
+          {PROJECTS.map((proj, i) => (
+            <motion.a 
+              href={proj.link}
+              target="_blank"
+              rel="noreferrer"
+              key={i}
+              whileHover={{ y: -4, borderColor: 'rgba(255,255,255,0.2)' }}
+              className="glass" 
+              style={{ padding: '32px', display: 'flex', flexDirection: 'column', cursor: proj.link === '#' ? 'default' : 'pointer', textDecoration: 'none' }}
+            >
+              <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', marginBottom: '16px' }}>
+                <h3 className="display-font" style={{ color: 'var(--text-1)', fontSize: '1.4rem' }}>{proj.title}</h3>
+                {proj.link !== '#' && <ExternalLink size={20} color="var(--text-3)" />}
+              </div>
+              
+              <p style={{ fontSize: '0.95rem', color: 'var(--text-2)', lineHeight: 1.6, flexGrow: 1, marginBottom: '24px' }}>
+                {proj.desc}
+              </p>
+              
+              <div style={{ display: 'flex', gap: '8px', flexWrap: 'wrap' }}>
+                {proj.tags.map(tag => (
+                  <span key={tag} style={{ padding: '4px 10px', fontSize: '0.75rem', background: 'var(--bg-elevated)', border: '1px solid var(--glass-border)', borderRadius: '6px', color: 'var(--text-1)' }}>
+                    {tag}
+                  </span>
+                ))}
+              </div>
+            </motion.a>
+          ))}
+        </div>
+      </section>
+
+    </div>
+  )
+}

fairvalue-webapp/src/pages/Estimator.tsx

@@ -1,8 +1,14 @@
-import { useState } from 'react'
+import { useState, useRef } from 'react'
 import {
-  BarChart, Bar, Cell, XAxis, YAxis, Tooltip,
+  BarChart, Bar, Cell, XAxis, YAxis, Tooltip, LabelList,
   ResponsiveContainer, ReferenceLine,
 } from 'recharts'
+import { motion } from 'framer-motion'
+import { Download } from 'lucide-react'
+import { useUsageLimiter } from '../hooks/useUsageLimiter'
+import AccessModal from '../components/AccessModal'
+import { ReportTemplate } from '../components/ReportTemplate'
+import DefinitionOfTerms from '../components/DefinitionOfTerms'
 
 const API_URL = import.meta.env.VITE_API_URL || 'http://localhost:8000'
 
@@ -50,29 +56,29 @@ function Gauge({ asking, hardCap }: { asking: number; hardCap: number }) {
       {/* Track */}
       <path d={arc(-180,0)} fill="none" stroke="rgba(255,255,255,0.06)" strokeWidth={18} strokeLinecap="round"/>
       {/* Green zone: 0 → cap */}
-      <path d={arc(-180, capDeg)} fill="none" stroke="var(--green)" strokeWidth={18} strokeLinecap="round" opacity={0.85}/>
+      <path d={arc(-180, capDeg)} fill="none" stroke="var(--profit-color)" strokeWidth={18} strokeLinecap="round" opacity={0.85}/>
       {/* Red zone: cap → asking (only if over) */}
       {isOver && (
-        <path d={arc(capDeg, Math.min(askDeg, 0))} fill="none" stroke="var(--red)" strokeWidth={18} strokeLinecap="round" opacity={0.85}/>
+        <path d={arc(capDeg, Math.min(askDeg, 0))} fill="none" stroke="var(--loss-color)" strokeWidth={18} strokeLinecap="round" opacity={0.85}/>
       )}
       {/* Needle */}
       <line x1={cx} y1={cy} x2={pt(askDeg).x} y2={pt(askDeg).y} stroke="white" strokeWidth={2.5} strokeLinecap="round"/>
       <circle cx={cx} cy={cy} r={5} fill="white"/>
-      {/* Cap label */}
+      {/* Fair Value label */}
       <text x={pt(capDeg).x + (capDeg < -90 ? -6 : 6)} y={pt(capDeg).y - 6}
         textAnchor={capDeg < -90 ? 'end' : 'start'}
-        fill="var(--green)" fontSize={9} fontWeight={600}>
-        Hard Cap £{hardCap.toFixed(0)}m
+        fill="var(--profit-color)" fontSize={9} fontWeight={600}>
+        Fair Value £{hardCap.toFixed(0)}m
       </text>
       {/* Center: asking */}
       <text x={cx} y={cy + 22} textAnchor="middle" fill="white" fontSize={22} fontWeight={800}>
         £{asking.toFixed(0)}m
       </text>
       <text x={cx} y={cy + 40} textAnchor="middle"
-        fill={isOver ? 'var(--red)' : 'var(--green)'} fontSize={12} fontWeight={600}>
+        fill={isOver ? 'var(--loss-color)' : 'var(--profit-color)'} fontSize={12} fontWeight={600}>
         {isOver
-          ? `▲ £${(asking - hardCap).toFixed(1)}m OVER CAP`
-          : `✓ Within Hard Cap`}
+          ? `▲ £${(asking - hardCap).toFixed(1)}m OVER FAIR VALUE`
+          : `✓ Within Fair Value`}
       </text>
       {/* Scale ticks */}
       {[0, 0.25, 0.5, 0.75, 1].map(f => {
@@ -94,13 +100,23 @@ function ShapChart({ data }: { data: { feature: string; impact: number }[] }) {
         <YAxis type="category" dataKey="feature" tick={{ fill:'var(--text-2)', fontSize:11 }} width={140} axisLine={false} tickLine={false}/>
         <Tooltip
           cursor={{ fill:'rgba(255,255,255,0.04)' }}
-          contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border)', borderRadius:8, fontSize:12 }}
-          formatter={(v: number) => [v > 0 ? `+${v.toFixed(3)}` : v.toFixed(3), 'SHAP Impact']}
+          contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border-hi)', borderRadius:8, fontSize:12, color:'var(--text-1)' }}
+          itemStyle={{ color: 'var(--text-1)' }}
+          labelStyle={{ color: 'var(--text-2)', marginBottom: 4 }}
+          formatter={(v: number) => [v > 0 ? `+${v.toFixed(3)}` : v.toFixed(3), 'Market Impact']}
         />
         <ReferenceLine x={0} stroke="rgba(255,255,255,0.12)" strokeWidth={1}/>
         <Bar dataKey="impact" radius={3}>
+          <LabelList 
+            dataKey="impact" 
+            position="right" 
+            fill="var(--text-1)" 
+            fontSize={11} 
+            fontWeight={600} 
+            formatter={(v: number) => v > 0 ? `+${v.toFixed(2)}` : v.toFixed(2)}
+          />
           {data.map((entry, i) => (
-            <Cell key={i} fill={entry.impact >= 0 ? 'var(--green)' : 'var(--red)'} fillOpacity={0.85}/>
+            <Cell key={i} fill={entry.impact >= 0 ? 'var(--profit-color)' : 'var(--loss-color)'} fillOpacity={0.85}/>
           ))}
         </Bar>
       </BarChart>
@@ -111,7 +127,7 @@ function ShapChart({ data }: { data: { feature: string; impact: number }[] }) {
 // ── NLP Sentiment Score ───────────────────────────────────────────────────────
 function SentimentScore({ label, value, icon }: { label: string; value: number; icon: string }) {
   const pct = Math.round(((value + 1) / 2) * 100)
-  const color = value > 0.1 ? 'var(--green)' : value < -0.1 ? 'var(--red)' : 'var(--blue)'
+  const color = value > 0.1 ? 'var(--profit-color)' : value < -0.1 ? 'var(--loss-color)' : 'var(--accent-blue)'
   return (
     <div>
       <div style={{ display:'flex', justifyContent:'space-between', marginBottom:6 }}>
@@ -127,8 +143,62 @@ function SentimentScore({ label, value, icon }: { label: string; value: number;
   )
 }
 
+// ── Custom Loaders ────────────────────────────────────────────────────────────
+function AILoader() {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 20, margin: '40px 0' }}>
+      <motion.div
+        animate={{ 
+          rotate: 360,
+          scale: [1, 1.2, 1],
+          y: [0, -40, 0]
+        }}
+        transition={{ 
+          rotate: { duration: 1.5, repeat: Infinity, ease: "linear" },
+          y: { duration: 0.5, repeat: Infinity, ease: "easeOut", repeatType: "mirror" },
+          scale: { duration: 0.5, repeat: Infinity, ease: "easeInOut" }
+        }}
+        style={{ fontSize: '64px', lineHeight: 1, filter: 'drop-shadow(0 20px 15px rgba(0,0,0,0.6))' }}
+      >
+        ⚽
+      </motion.div>
+      <div style={{ textAlign: 'center' }}>
+        <motion.div 
+          animate={{ opacity: [0.4, 1, 0.4] }}
+          transition={{ duration: 1.5, repeat: Infinity, ease: "easeInOut" }}
+          style={{ fontSize: '0.9rem', color: '#60a5fa', fontWeight: 800, letterSpacing: '0.2em' }}
+        >
+          SCOUTING DATA CHANNELS...
+        </motion.div>
+        <div style={{ fontSize: '0.7rem', color: 'var(--text-3)', marginTop: 4 }}>
+          Accessing Premier League Performance Archives
+        </div>
+      </div>
+    </div>
+  )
+}
+
+function ButtonPulse() {
+  return (
+    <motion.div
+      animate={{ rotate: 360 }}
+      transition={{ duration: 1, repeat: Infinity, ease: "linear" }}
+      style={{
+        fontSize: '14px',
+        lineHeight: 1,
+        marginRight: 6,
+        display: 'inline-block'
+      }}
+    >
+      ⚽
+    </motion.div>
+  )
+}
+
 // ── Main Estimator Page ───────────────────────────────────────────────────────
 export default function Estimator() {
+  const { isLocked, incrementUsage } = useUsageLimiter()
+  const reportRef = useRef<HTMLDivElement>(null)
   const [form, setForm] = useState({
     selected_name: '',
     current_club: '',
@@ -146,8 +216,26 @@ export default function Estimator() {
 
   const set = (k: string, v: string | number) => setForm(f => ({ ...f, [k]: v }))
 
-  const handleSubmit = async () => {
-    if (!form.selected_name.trim()) { setError('Player name is required.'); return }
+  const handleSubmit = async (e?: React.FormEvent) => {
+    if (e) e.preventDefault()
+    
+    // Auto-Format the Player Name so the PDF always looks professional
+    let cleanName = form.selected_name.trim()
+    const exactMatch = suggestions.find(s => s.toLowerCase() === cleanName.toLowerCase())
+    if (exactMatch) {
+      cleanName = exactMatch // Snap to exact database spelling
+    } else {
+      // Apply Title Case for new/unrecognized players (e.g. "john doe" -> "John Doe")
+      cleanName = cleanName.replace(/\b\w/g, c => c.toUpperCase())
+    }
+    
+    if (cleanName !== form.selected_name) {
+      setForm(prev => ({ ...prev, selected_name: cleanName }))
+    }
+
+    if (!cleanName) { setError('Player name is required.'); return }
+    if (!incrementUsage()) return;
+    
     setLoading(true); setError(null); setResult(null)
     try {
       const res = await fetch(`${API_URL}/api/evaluate`, {
@@ -167,13 +255,20 @@ export default function Estimator() {
     }
   }
 
+  const handleDownloadPdf = async () => {
+    // Rely on native browser print for high-fidelity vectorized PDFs
+    window.print()
+  }
+
   const L = result?.ledger
 
   return (
     <div className="page">
-      <div className="container">
+      <div className="no-print">
+        {isLocked && <AccessModal />}
+        <div className="container">
 
-        {/* Header */}
+          {/* Header */}
         <div style={{ marginBottom:36 }}>
           <span className="badge badge-green" style={{ marginBottom:10, display:'inline-flex' }}>AI Valuation Engine</span>
           <h1 style={{ marginBottom:8 }}>Strategic Transfer Estimator</h1>
@@ -273,7 +368,7 @@ export default function Estimator() {
             <button className="btn btn-primary" style={{ width:'100%', justifyContent:'center', padding:14 }}
               onClick={handleSubmit} disabled={loading}>
               {loading
-                ? <><span className="spinner"/> Fetching live intel… (15–30s)</>
+                ? <><ButtonPulse /> Fetching live intel… (15–30s)</>
                 : '⚡ Calculate Hard Cap'}
             </button>
 
@@ -291,8 +386,8 @@ export default function Estimator() {
 
             {loading && (
               <div className="glass" style={{ padding:48, textAlign:'center' }}>
-                <div className="spinner" style={{ width:40, height:40, margin:'0 auto 20px' }}/>
-                <p>Running ML inference + scraping live market signals…</p>
+                <AILoader />
+                <p style={{ color: 'var(--text-1)', fontWeight: 500 }}>Running ML inference + scraping live market signals…</p>
                 <p style={{ fontSize:'0.8rem', color:'var(--text-3)', marginTop:8 }}>
                   Live DDGS intel can take 15–30 seconds first time.
                 </p>
@@ -300,13 +395,25 @@ export default function Estimator() {
             )}
 
             {result && L && (
-              <div className="animate-in" style={{ display:'flex', flexDirection:'column', gap:18 }}>
+              <motion.div 
+                initial={{ opacity: 0, y: 20 }}
+                animate={{ opacity: 1, y: 0 }}
+                transition={{ duration: 0.5 }}
+                className="animate-in" 
+                style={{ display:'flex', flexDirection:'column', gap:18 }}
+              >
 
                 {/* Verdict alert */}
-                <div className={`alert ${form.asking_price > L.hard_cap ? 'alert-danger' : 'alert-success'}`}>
-                  {form.asking_price > L.hard_cap
-                    ? `⚠️ OVERPAY RISK — Asking price £${form.asking_price}m exceeds our hard cap of £${L.hard_cap.toFixed(1)}m by £${(form.asking_price - L.hard_cap).toFixed(1)}m.`
-                    : `✅ FAIR DEAL — Asking price £${form.asking_price}m is within the £${L.hard_cap.toFixed(1)}m hard cap. Proceed with confidence.`}
+                <div style={{ display: 'flex', gap: '12px', alignItems: 'stretch' }}>
+                  <div className={`alert ${form.asking_price > L.hard_cap ? 'alert-danger' : 'alert-success'}`} style={{ flex: 1, margin: 0 }}>
+                    {form.asking_price > L.hard_cap
+                      ? `⚠️ OVERPAY RISK — Asking price £${form.asking_price}m exceeds our Fair Value ceiling of £${L.hard_cap.toFixed(1)}m by £${(form.asking_price - L.hard_cap).toFixed(1)}m.`
+                      : `✅ FAIR DEAL — Asking price £${form.asking_price}m is within the £${L.hard_cap.toFixed(1)}m Fair Value. Proceed with confidence.`}
+                  </div>
+                  <button onClick={handleDownloadPdf} className="btn btn-secondary" style={{ padding: '0 24px' }} title="Download Professional PDF Report">
+                    <Download size={20} />
+                    Download Report
+                  </button>
                 </div>
 
                 {/* Gauge + Ledger */}
@@ -320,16 +427,16 @@ export default function Estimator() {
                     <div style={{ display:'flex', flexDirection:'column', gap:16 }}>
                       <div>
                         <div className="metric-label">Intrinsic Performance Value</div>
-                        <div className="metric-value" style={{ color:'var(--green)' }}>£{L.intrinsic_performance_value.toFixed(1)}m</div>
+                        <div className="metric-value" style={{ color:'var(--profit-color)' }}>£{L.intrinsic_performance_value.toFixed(1)}m</div>
                         <span className="badge badge-green" style={{ marginTop:4 }}>{L.category}</span>
                       </div>
                       <div className="divider" style={{ margin:'8px 0' }}/>
                       <div>
-                        <div className="metric-label">Age & Contract Depreciation</div>
-                        <div className="metric-value" style={{ color: L.depreciation < 0 ? 'var(--red)' : 'var(--blue)' }}>
+                        <div className="metric-label">Age & Contract Impact — {L.depreciation < 0 ? 'Penalty' : 'Premium'}</div>
+                        <div className="metric-value" style={{ color: L.depreciation < 0 ? 'var(--loss-color)' : 'var(--profit-color)' }}>
                           {L.depreciation >= 0 ? '+' : ''}£{L.depreciation.toFixed(1)}m
                         </div>
-                        <span className="badge badge-blue" style={{ marginTop:4 }}>SHAP Calculated Penalty</span>
+                        <span className="badge badge-blue" style={{ marginTop:4 }}>SHAP Calculated</span>
                       </div>
                       <div className="divider" style={{ margin:'8px 0' }}/>
                       <div>
@@ -338,13 +445,13 @@ export default function Estimator() {
                       </div>
                       <div>
                         <div className="metric-label">NLP Multiplier</div>
-                        <div className="metric-value" style={{ color: L.external_multiplier > 1 ? 'var(--green)' : 'var(--red)' }}>
+                        <div className="metric-value" style={{ color: L.external_multiplier > 1 ? 'var(--profit-color)' : 'var(--loss-color)' }}>
                           ×{L.external_multiplier.toFixed(3)}
                         </div>
                       </div>
-                      <div style={{ padding:'12px 14px', background:'var(--green-dim)', borderRadius:10, border:'1px solid rgba(0,232,122,0.2)' }}>
-                        <div className="metric-label">🎯 Hard Cap</div>
-                        <div style={{ fontSize:'2.2rem', fontWeight:900, color:'var(--green)', letterSpacing:'-0.03em' }}>
+                      <div style={{ padding:'12px 14px', background:'rgba(34,197,94,0.15)', borderRadius:10, border:'1px solid rgba(0,232,122,0.2)' }}>
+                        <div className="metric-label">🎯 Fair Value Ceiling</div>
+                        <div style={{ fontSize:'2.2rem', fontWeight:900, color:'var(--profit-color)', letterSpacing:'-0.03em' }}>
                           £{L.hard_cap.toFixed(1)}m
                         </div>
                       </div>
@@ -388,11 +495,18 @@ export default function Estimator() {
                     )}
                   </div>
                 </div>
-              </div>
+              </motion.div>
             )}
           </div>
         </div>
+
+        {/* Definition of Terms Section */}
+        <DefinitionOfTerms />
       </div>
+      </div>
+
+      {/* Hidden Report Template for PDF Generation */}
+      {result && <ReportTemplate ref={reportRef} form={form} result={result} />}
     </div>
   )
 }

fairvalue-webapp/src/pages/FFPAdvisor.tsx

@@ -2,7 +2,11 @@ import { useState } from 'react'
 import {
   PieChart, Pie, Cell, Legend, Tooltip,
   BarChart, Bar, XAxis, YAxis, ResponsiveContainer,
+  LineChart, Line
 } from 'recharts'
+import { motion } from 'framer-motion'
+import { useUsageLimiter } from '../hooks/useUsageLimiter'
+import AccessModal from '../components/AccessModal'
 
 // ── PSR Maths (all pure frontend — no API call) ────────────────────────────────
 function calcPSR(feeMm: number, contractYrs: number, weeklyWageK: number, agentFeeMm: number) {
@@ -17,6 +21,7 @@ function calcPSR(feeMm: number, contractYrs: number, weeklyWageK: number, agentF
 const DONUT_COLORS = ['#505070', '#4f8ef7', '#00e87a']
 
 export default function FFPAdvisor() {
+  const { isLocked } = useUsageLimiter()
   const [feeMm,       setFeeMm]       = useState(50)
   const [contractYrs, setContractYrs] = useState(5)
   const [weeklyWageK, setWeeklyWageK] = useState(120)
@@ -46,9 +51,20 @@ export default function FFPAdvisor() {
     'Agent Fees': +annualAgent.toFixed(2),
   }))
 
+  const bookValueData = years.map((y, i) => ({
+    name: y,
+    'Remaining Asset Value': +(feeMm - annualAmort * (i + 1)).toFixed(2)
+  }))
+
   return (
-    <div className="page">
-      <div className="container">
+    <div className="page" style={{ position: 'relative' }}>
+      {isLocked && <AccessModal />}
+      <motion.div 
+        className="container"
+        initial={{ opacity: 0, y: 15 }}
+        animate={{ opacity: 1, y: 0 }}
+        transition={{ duration: 0.5 }}
+      >
 
         {/* Header */}
         <div style={{ marginBottom:36 }}>
@@ -154,34 +170,50 @@ export default function FFPAdvisor() {
             </div>
 
             {/* Charts row */}
-            <div style={{ display:'grid', gridTemplateColumns:'1fr 1fr', gap:18 }}>
+            <div style={{ display:'flex', flexDirection:'column', gap:18 }}>
+              <div style={{ display:'grid', gridTemplateColumns:'1fr 1fr', gap:18 }}>
+                <div className="glass" style={{ padding:24 }}>
+                  <h3 style={{ marginBottom:12 }}>PSR Budget Overview</h3>
+                  <PieChart width={280} height={230}>
+                    <Pie data={donutData} cx="50%" cy="50%" innerRadius={55} outerRadius={80} dataKey="value" paddingAngle={2}>
+                      {donutData.map((_, i) => <Cell key={i} fill={DONUT_COLORS[i]}/>)}
+                    </Pie>
+                    <Tooltip
+                      contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border)', borderRadius:8, fontSize:12 }}
+                      formatter={(v: number) => [`£${v.toFixed(1)}m`]}/>
+                    <Legend wrapperStyle={{ fontSize:'0.75rem', color:'var(--text-2)' }}/>
+                  </PieChart>
+                </div>
 
-              <div className="glass" style={{ padding:24 }}>
-                <h3 style={{ marginBottom:12 }}>PSR Budget Overview</h3>
-                <PieChart width={280} height={230}>
-                  <Pie data={donutData} cx="50%" cy="50%" innerRadius={55} outerRadius={80} dataKey="value" paddingAngle={2}>
-                    {donutData.map((_, i) => <Cell key={i} fill={DONUT_COLORS[i]}/>)}
-                  </Pie>
-                  <Tooltip
-                    contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border)', borderRadius:8, fontSize:12 }}
-                    formatter={(v: number) => [`£${v.toFixed(1)}m`]}/>
-                  <Legend wrapperStyle={{ fontSize:'0.75rem', color:'var(--text-2)' }}/>
-                </PieChart>
+                <div className="glass" style={{ padding:24 }}>
+                  <h3 style={{ marginBottom:12 }}>Annual P&L Schedule</h3>
+                  <ResponsiveContainer width="100%" height={200}>
+                    <BarChart data={barData} margin={{ top:4, right:8, left:-16, bottom:4 }}>
+                      <XAxis dataKey="name" tick={{ fill:'var(--text-2)', fontSize:10 }} axisLine={false} tickLine={false}/>
+                      <YAxis tick={{ fill:'var(--text-2)', fontSize:10 }} axisLine={false} tickLine={false}/>
+                      <Tooltip
+                        contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border)', borderRadius:8, fontSize:11 }}
+                        formatter={(v: number) => [`£${v.toFixed(1)}m`]}/>
+                      <Bar dataKey="Amortisation" stackId="a" fill="#4f8ef7" radius={[0,0,2,2]}/>
+                      <Bar dataKey="Wages"        stackId="a" fill="#00e87a"/>
+                      <Bar dataKey="Agent Fees"   stackId="a" fill="#f5a623" radius={[2,2,0,0]}/>
+                    </BarChart>
+                  </ResponsiveContainer>
+                </div>
               </div>
 
+              {/* New Declining Book Value Chart */}
               <div className="glass" style={{ padding:24 }}>
-                <h3 style={{ marginBottom:12 }}>Annual Accounting Schedule</h3>
-                <ResponsiveContainer width="100%" height={200}>
-                  <BarChart data={barData} margin={{ top:4, right:8, left:-16, bottom:4 }}>
+                <h3 style={{ marginBottom:12 }}>Remaining Balance Sheet Book Value (Post-Amortisation)</h3>
+                <ResponsiveContainer width="100%" height={160}>
+                  <LineChart data={bookValueData} margin={{ top:4, right:8, left:-16, bottom:4 }}>
                     <XAxis dataKey="name" tick={{ fill:'var(--text-2)', fontSize:10 }} axisLine={false} tickLine={false}/>
                     <YAxis tick={{ fill:'var(--text-2)', fontSize:10 }} axisLine={false} tickLine={false}/>
                     <Tooltip
                       contentStyle={{ background:'var(--bg-elevated)', border:'1px solid var(--glass-border)', borderRadius:8, fontSize:11 }}
                       formatter={(v: number) => [`£${v.toFixed(1)}m`]}/>
-                    <Bar dataKey="Amortisation" stackId="a" fill="#4f8ef7" radius={[0,0,2,2]}/>
-                    <Bar dataKey="Wages"        stackId="a" fill="#00e87a"/>
-                    <Bar dataKey="Agent Fees"   stackId="a" fill="#f5a623" radius={[2,2,0,0]}/>
-                  </BarChart>
+                    <Line type="monotone" dataKey="Remaining Asset Value" stroke="#4f8ef7" strokeWidth={3} dot={{ fill: '#00e87a', strokeWidth: 2, r: 4 }} activeDot={{ r: 6 }}/>
+                  </LineChart>
                 </ResponsiveContainer>
               </div>
             </div>
@@ -193,7 +225,8 @@ export default function FFPAdvisor() {
             </p>
           </div>
         </div>
-      </div>
+      </motion.div>
     </div>
   )
 }
+

fairvalue-webapp/src/pages/Intel.tsx

@@ -1,4 +1,7 @@
 import { useState } from 'react'
+import { motion } from 'framer-motion'
+import { useUsageLimiter } from '../hooks/useUsageLimiter'
+import AccessModal from '../components/AccessModal'
 
 const API_URL = import.meta.env.VITE_API_URL || 'http://localhost:8000'
 
@@ -16,7 +19,7 @@ function ScoreCard({
 }: { label: string; value: number; icon: string; desc: string }) {
   const norm  = (value + 1) / 2             // –1..+1 → 0..1
   const pct   = Math.round(norm * 100)
-  const color = value > 0.1 ? 'var(--green)' : value < -0.1 ? 'var(--red)' : 'var(--blue)'
+  const color = value > 0.1 ? 'var(--profit-color)' : value < -0.1 ? 'var(--loss-color)' : 'var(--accent-blue)'
   const label2 = value > 0.15 ? 'Positive' : value < -0.15 ? 'Negative' : 'Neutral'
   const badge  = value > 0.15 ? 'badge-green' : value < -0.15 ? 'badge-red' : 'badge-blue'
 
@@ -68,7 +71,7 @@ function HypeFactorDisplay({ durability, recency, agent }: { durability: number;
   return (
     <div className="glass" style={{
       padding:24,
-      background: isPos ? 'var(--green-dim)' : 'var(--red-dim)',
+      background: isPos ? 'rgba(34,197,94,0.15)' : 'rgba(239,68,68,0.15)',
       borderColor: isPos ? 'rgba(0,232,122,0.2)' : 'rgba(255,77,109,0.2)',
     }}>
       <div style={{ display:'flex', justifyContent:'space-between', alignItems:'center' }}>
@@ -80,10 +83,10 @@ function HypeFactorDisplay({ durability, recency, agent }: { durability: number;
           </p>
         </div>
         <div style={{ textAlign:'right' }}>
-          <div style={{ fontSize:'2.8rem', fontWeight:900, color: isPos ? 'var(--green)' : 'var(--red)', letterSpacing:'-0.04em' }}>
+          <div style={{ fontSize:'2.8rem', fontWeight:900, color: isPos ? 'var(--profit-color)' : 'var(--loss-color)', letterSpacing:'-0.04em' }}>
             ×{mult.toFixed(3)}
           </div>
-          <div style={{ fontSize:'0.82rem', color: isPos ? 'var(--green)' : 'var(--red)', fontWeight:600 }}>
+          <div style={{ fontSize:'0.82rem', color: isPos ? 'var(--profit-color)' : 'var(--loss-color)', fontWeight:600 }}>
             {isPos ? `+${pct}% sentiment premium` : `${pct}% sentiment discount`}
           </div>
         </div>
@@ -93,6 +96,7 @@ function HypeFactorDisplay({ durability, recency, agent }: { durability: number;
 }
 
 export default function Intel() {
+  const { isLocked, incrementUsage } = useUsageLimiter()
   const [player,        setPlayer]        = useState('')
   const [club,          setClub]          = useState('')
   const [result,        setResult]        = useState<ScoutResult | null>(null)
@@ -101,6 +105,7 @@ export default function Intel() {
   const [showLog,       setShowLog]       = useState(false)
 
   const handleFetch = async () => {
+    if (!incrementUsage()) return;
     if (!player.trim()) { setError('Enter a player name first.'); return }
     setLoading(true); setError(null); setResult(null)
     try {
@@ -119,8 +124,14 @@ export default function Intel() {
   }
 
   return (
-    <div className="page">
-      <div className="container">
+    <div className="page" style={{ position: 'relative' }}>
+      {isLocked && <AccessModal />}
+      <motion.div 
+        className="container"
+        initial={{ opacity: 0, y: 15 }}
+        animate={{ opacity: 1, y: 0 }}
+        transition={{ duration: 0.5 }}
+      >
 
         {/* Header */}
         <div style={{ marginBottom:36 }}>
@@ -238,7 +249,7 @@ export default function Intel() {
             <p>Enter a player name above and click Fetch Intel.</p>
           </div>
         )}
-      </div>
+      </motion.div>
     </div>
   )
 }

fairvalue-webapp/src/pages/Landing.tsx

@@ -1,138 +1,207 @@
 import { Link } from 'react-router-dom'
+import { motion } from 'framer-motion'
+import { useState, useEffect } from 'react'
+import { ShieldCheck, ArrowRight, TrendingUp, Target, Crosshair, Users, Landmark, Briefcase, UserCheck, PieChart } from 'lucide-react'
 
-const STATS = [
-  { value: '12,541', label: 'Transfers Analysed' },
-  { value: '£638k',  label: 'Model MAE'          },
-  { value: '17',     label: 'Features Learned'   },
-  { value: '3-Axis', label: 'Live Intelligence'  },
-]
-
-const FEATURES = [
-  {
-    icon: '🧠',
-    title: 'XGBoost + SHAP',
-    desc: 'Decomposes every valuation into raw talent vs. age & contract depreciation — in pounds, not abstract scores.',
-  },
-  {
-    icon: '📰',
-    title: 'Live Market Intelligence',
-    desc: 'Real-time NLP sentiment across injury news, form data, and agent noise adjusts the hard cap before you bid.',
-  },
-  {
-    icon: '⚖️',
-    title: 'PSR Compliance',
-    desc: 'Instantly models the full amortisation schedule and flags breaches against the £105m 3-year Premier League limit.',
-  },
-]
+const PitchBackground = () => (
+  <div style={{ position: 'absolute', inset: 0, zIndex: 0, pointerEvents: 'none' }}>
+    <div style={{ 
+      position: 'absolute', inset: 0, 
+      background: 'radial-gradient(circle at 30% 30%, rgba(34, 197, 94, 0.08) 0%, transparent 50%), radial-gradient(circle at 70% 70%, rgba(59, 130, 246, 0.08) 0%, transparent 50%)',
+    }} />
+    <svg width="100%" height="100%" style={{ opacity: 0.1 }} preserveAspectRatio="xMidYMid slice" viewBox="0 0 1000 600">
+      <rect width="1000" height="600" fill="none" stroke="rgba(255,255,255,0.2)" strokeWidth="1" />
+      <line x1="500" y1="0" x2="500" y2="600" stroke="rgba(255,255,255,0.2)" strokeWidth="1" />
+      <circle cx="500" cy="300" r="90" fill="none" stroke="rgba(255,255,255,0.2)" strokeWidth="1" />
+    </svg>
+  </div>
+)
 
-const STEPS = [
-  { n: '01', title: 'Profile the Target',   desc: 'Enter age, contract status, injury history, and market value estimate.' },
-  { n: '02', title: 'AI Runs the Numbers',  desc: 'XGBoost + SHAP deconstructs talent from depreciation. Live news sentiment adjusts the hard cap.' },
-  { n: '03', title: 'Receive a Hard Cap',   desc: 'A defensible, board-ready maximum bid with full mathematical transparency.' },
+const AUDIENCES = [
+  { icon: <Briefcase size={24} />, title: "Directors of Football", desc: "Validate transfer ceilings and protect club liquidity." },
+  { icon: <Target size={24} />, title: "Head Scouts", desc: "Back the 'eye test' with unshakeable performance data." },
+  { icon: <Landmark size={24} />, title: "Financial Officers", desc: "Model 5-year FFP impact before signing the contract." },
+  { icon: <Users size={24} />, title: "Elite Agents", desc: "Benchmark client value against live market benchmarks." },
+  { icon: <PieChart size={24} />, title: "Investment Groups", desc: "De-risk acquisitions with high-fidelity ROI projections." },
 ]
 
 export default function Landing() {
+  const [evalCount, setEvalCount] = useState(84);
+
+  useEffect(() => {
+    const stored = localStorage.getItem('fv_usage_count');
+    const localUses = stored ? parseInt(stored, 10) : 0;
+    setEvalCount(84 + localUses);
+  }, []);
+
+  const STATS = [
+    { value: evalCount.toString(), label: 'Transfers Evaluated' },
+    { value: '£14.2m',  label: 'Avg. Overpay Avoided' },
+    { value: 'PL-Sync', label: 'Market Intelligence'  },
+    { value: '100%',   label: 'PSR Compliance' },
+  ]
+
   return (
-    <div className="page">
-
-      {/* ── Hero ──────────────────────────────────────────────────────────── */}
-      <section className="container" style={{ textAlign:'center', padding:'60px 24px 48px' }}>
-        <div className="animate-in">
-          <span className="badge badge-green" style={{ marginBottom:20, display:'inline-flex' }}>
-            Powered by XGBoost + SHAP Explainability
-          </span>
-          <h1 style={{ marginBottom:20 }}>
-            The AI That Protects Clubs From<br/>
-            <span className="gradient-text">Winner's Curse</span>
-          </h1>
-          <p style={{ maxWidth:580, margin:'0 auto 36px', fontSize:'1.05rem', lineHeight:1.75 }}>
-            A rigorous, data-driven transfer ceiling calculator grounded in ML and
-            Hedonic Pricing Theory — built for Directors of Football who can't afford
-            to overpay.
-          </p>
-          <div style={{ display:'flex', gap:12, justifyContent:'center', flexWrap:'wrap' }}>
-            <Link to="/estimate" className="btn btn-primary btn-lg">
-              Evaluate a Transfer ↗
-            </Link>
-            <Link to="/ffp" className="btn btn-ghost btn-lg">
-              Check PSR Compliance
-            </Link>
-          </div>
+    <div className="page" style={{ position: 'relative', overflow: 'hidden' }}>
+      <PitchBackground />
+      
+      {/* ── Cinematic Hero ���───────────────────────────────────────────────── */}
+      <section className="container" style={{ position: 'relative', zIndex: 1, padding: '40px 24px 60px' }}>
+        <div style={{ display: 'grid', gridTemplateColumns: '1.2fr 1fr', gap: '48px', alignItems: 'center' }}>
+          
+          <motion.div 
+            initial={{ opacity: 0, x: -40 }}
+            animate={{ opacity: 1, x: 0 }}
+            transition={{ duration: 0.8, ease: "easeOut" }}
+          >
+            <div style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', marginBottom: '24px', padding: '6px 16px', background: 'rgba(59,130,246,0.1)', border: '1px solid rgba(59,130,246,0.2)', borderRadius: '100px' }}>
+              <span style={{ fontSize: '1.2rem' }}>🏆</span>
+              <span style={{ fontSize: '0.8rem', fontWeight: 600, color: '#60a5fa', letterSpacing: '0.05em', textTransform: 'uppercase' }}>
+                The Gold Standard in Transfer Intelligence
+              </span>
+            </div>
+
+            <h1 style={{ marginBottom: '24px', fontSize: 'clamp(2.5rem, 6vw, 4.8rem)', lineHeight: 1.05, fontWeight: 900, letterSpacing: '-0.02em' }}>
+              Own the Negotiation. <br/>
+              <span className="gradient-accent">Master the Market.</span>
+            </h1>
+
+            <p style={{ maxWidth: '600px', marginBottom: '40px', fontSize: '1.25rem', lineHeight: 1.6, color: 'var(--text-2)', fontWeight: 400 }}>
+              Stop guessing. Start quantifying. The definitive platform for quantifying the true intrinsic value of world-class talent and eliminating overpayment risk.
+            </p>
+
+            <div style={{ display: 'flex', gap: '16px', flexWrap: 'wrap' }}>
+              <Link to="/estimate" className="btn btn-secondary btn-lg" style={{ padding: '18px 36px' }}>
+                Launch Intelligence Engine <ArrowRight size={20} />
+              </Link>
+            </div>
+          </motion.div>
+
+          <motion.div 
+            initial={{ opacity: 0, scale: 0.9, rotate: 2 }}
+            animate={{ opacity: 1, scale: 1, rotate: 0 }}
+            transition={{ duration: 1, delay: 0.2 }}
+            style={{ position: 'relative' }}
+          >
+            <div style={{ 
+              position: 'absolute', inset: -20, 
+              background: 'radial-gradient(circle, rgba(59,130,246,0.2) 0%, transparent 70%)',
+              filter: 'blur(40px)', zIndex: -1
+            }} />
+            <img 
+              src="/pl_lion_valuation_hero_1777652300981.png" 
+              alt="Premier League Intelligence" 
+              style={{ 
+                width: '100%', borderRadius: '24px', 
+                border: '1px solid var(--glass-border-hi)',
+                boxShadow: '0 40px 100px rgba(0,0,0,0.6)',
+                transform: 'perspective(1000px) rotateY(-5deg)'
+              }} 
+            />
+          </motion.div>
         </div>
       </section>
 
-      {/* ── Stats Bar ─────────────────────────────────────────────────────── */}
-      <section style={{ borderTop:'1px solid var(--glass-border)', borderBottom:'1px solid var(--glass-border)', padding:'28px 0', marginBottom:64 }}>
+      {/* ── Financial Stats ───────────────────────────────────────────────── */}
+      <section style={{ position: 'relative', zIndex: 1, borderTop: '1px solid var(--glass-border)', borderBottom: '1px solid var(--glass-border)', padding: '40px 0', background: 'rgba(255,255,255,0.02)' }}>
         <div className="container">
-          <div style={{ display:'grid', gridTemplateColumns:'repeat(4,1fr)', gap:16, textAlign:'center' }}>
-            {STATS.map(({ value, label }) => (
-              <div key={label}>
-                <div style={{ fontSize:'2rem', fontWeight:800, letterSpacing:'-0.03em', color:'var(--green)' }}>{value}</div>
-                <div style={{ fontSize:'0.78rem', color:'var(--text-2)', textTransform:'uppercase', letterSpacing:'0.07em', fontWeight:600 }}>{label}</div>
-              </div>
+          <div style={{ display: 'grid', gridTemplateColumns: 'repeat(4,1fr)', gap: '24px', textAlign: 'center' }}>
+            {STATS.map(({ value, label }, i) => (
+              <motion.div 
+                key={label}
+                initial={{ opacity: 0, y: 20 }}
+                whileInView={{ opacity: 1, y: 0 }}
+                transition={{ delay: 0.1 * i }}
+                viewport={{ once: true }}
+              >
+                <div style={{ fontSize: '2.8rem', fontWeight: 900, color: 'var(--text-1)', fontFamily: 'Outfit' }}>{value}</div>
+                <div style={{ fontSize: '0.8rem', color: 'var(--text-3)', textTransform: 'uppercase', letterSpacing: '0.1em', fontWeight: 700 }}>{label}</div>
+              </motion.div>
             ))}
           </div>
         </div>
       </section>
 
-      {/* ── Features ──────────────────────────────────────────────────────── */}
-      <section className="container" style={{ marginBottom:72 }}>
-        <h2 style={{ textAlign:'center', marginBottom:12 }}>Built for the Transfer Room</h2>
-        <p style={{ textAlign:'center', marginBottom:40, maxWidth:520, margin:'0 auto 40px' }}>
-          Every output is explainable, auditable, and defensible to a board.
-        </p>
-        <div className="grid-3">
-          {FEATURES.map(({ icon, title, desc }) => (
-            <div key={title} className="glass" style={{ padding:28 }}>
-              <div style={{ fontSize:'2.2rem', marginBottom:14 }}>{icon}</div>
-              <h3 style={{ marginBottom:10 }}>{title}</h3>
-              <p style={{ fontSize:'0.88rem', lineHeight:1.7 }}>{desc}</p>
-            </div>
+      {/* ── Target Audience ───────────────────────────────────────────────── */}
+      <section className="container" style={{ position: 'relative', zIndex: 1, padding: '100px 24px' }}>
+        <div style={{ textAlign: 'center', marginBottom: '64px' }}>
+          <h2 style={{ marginBottom: '16px', fontSize: '2.5rem' }}>Built for the Decision Makers</h2>
+          <p style={{ maxWidth: '600px', margin: '0 auto', fontSize: '1.1rem', color: 'var(--text-2)' }}>
+            Empowering the most critical roles in the multi-billion pound football industry.
+          </p>
+        </div>
+
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(5, 1fr)', gap: '20px' }}>
+          {AUDIENCES.map((item, i) => (
+            <motion.div 
+              key={item.title}
+              whileHover={{ y: -10, background: 'rgba(255,255,255,0.06)' }}
+              initial={{ opacity: 0, y: 30 }}
+              whileInView={{ opacity: 1, y: 0 }}
+              transition={{ delay: 0.1 * i }}
+              viewport={{ once: true }}
+              className="glass" 
+              style={{ padding: '28px', textAlign: 'center', border: '1px solid var(--glass-border)' }}
+            >
+              <div style={{ 
+                width: 50, height: 50, borderRadius: '12px', 
+                background: 'rgba(59,130,246,0.1)', display: 'flex', 
+                alignItems: 'center', justifyContent: 'center', margin: '0 auto 20px',
+                color: '#60a5fa'
+              }}>
+                {item.icon}
+              </div>
+              <h4 style={{ marginBottom: '12px', fontSize: '1.05rem', color: 'var(--text-1)' }}>{item.title}</h4>
+              <p style={{ fontSize: '0.82rem', color: 'var(--text-3)', lineHeight: 1.5 }}>{item.desc}</p>
+            </motion.div>
           ))}
         </div>
       </section>
 
-      {/* ── How It Works ──────────────────────────────────────────────────── */}
-      <section className="container" style={{ marginBottom:80 }}>
-        <h2 style={{ textAlign:'center', marginBottom:48 }}>How It Works</h2>
-        <div style={{ display:'grid', gridTemplateColumns:'repeat(3,1fr)', gap:24, position:'relative' }}>
-          {/* Connector line */}
-          <div style={{
-            position:'absolute', top:28, left:'17%', width:'66%', height:1,
-            background:'linear-gradient(90deg,var(--green),var(--blue))',
-            opacity:0.3,
-          }} />
-          {STEPS.map(({ n, title, desc }) => (
-            <div key={n} style={{ textAlign:'center' }}>
-              <div style={{
-                width:54, height:54, borderRadius:'50%',
-                background:'linear-gradient(135deg,var(--green-dim),var(--blue-dim))',
-                border:'1px solid var(--glass-border)',
-                display:'flex', alignItems:'center', justifyContent:'center',
-                margin:'0 auto 18px',
-                fontWeight:800, fontSize:'1rem', color:'var(--green)',
-              }}>{n}</div>
-              <h3 style={{ marginBottom:8 }}>{title}</h3>
-              <p style={{ fontSize:'0.85rem' }}>{desc}</p>
-            </div>
-          ))}
+      {/* ── Value Proposition Cards ───────────────────────────────────────── */}
+      <section className="container" style={{ position: 'relative', zIndex: 1, marginBottom: '100px' }}>
+        <div className="grid-3" style={{ gap: '24px' }}>
+          <motion.div whileHover={{ scale: 1.02 }} className="glass" style={{ padding: '32px' }}>
+            <Target size={32} color="#3b82f6" style={{ marginBottom: '24px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Intrinsic Valuation</h3>
+            <p style={{ fontSize: '0.95rem' }}>Isolate pure performance metrics from market noise to identify the true ceiling price of any asset.</p>
+          </motion.div>
+
+          <motion.div whileHover={{ scale: 1.02 }} className="glass" style={{ padding: '32px' }}>
+            <Crosshair size={32} color="#f5a623" style={{ marginBottom: '24px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Live Market Pulse</h3>
+            <p style={{ fontSize: '0.95rem' }}>Real-time newsroom scraping for durability, form, and agent leverage to adjust valuations on the fly.</p>
+          </motion.div>
+
+          <motion.div whileHover={{ scale: 1.02 }} className="glass" style={{ padding: '32px' }}>
+            <ShieldCheck size={32} color="#22c55e" style={{ marginBottom: '24px' }} />
+            <h3 style={{ marginBottom: '12px' }}>Board-Ready Compliance</h3>
+            <p style={{ fontSize: '0.95rem' }}>Instantly calculate amortisation hits and ensure every bid stays within PSR & FFP safety zones.</p>
+          </motion.div>
         </div>
       </section>
 
-      {/* ── CTA ───────────────────────────────────────────────────────────── */}
-      <section className="container">
-        <div className="glass" style={{
-          padding:'48px 40px', textAlign:'center',
-          background:'linear-gradient(135deg, rgba(0,232,122,0.05), rgba(79,142,247,0.05))',
-          borderColor:'rgba(0,232,122,0.15)',
-        }}>
-          <h2 style={{ marginBottom:12 }}>Ready to protect the budget?</h2>
-          <p style={{ marginBottom:28 }}>Run your first player evaluation in under 60 seconds.</p>
-          <Link to="/estimate" className="btn btn-primary btn-lg" style={{ animation:'pulse-ring 2s infinite' }}>
-            Start Evaluating →
+      {/* ── Enterprise CTA ────────────────────────────────────────────────── */}
+      <section className="container" style={{ position: 'relative', zIndex: 1, marginBottom: '80px' }}>
+        <motion.div 
+          whileInView={{ opacity: 1, y: 0 }}
+          initial={{ opacity: 0, y: 40 }}
+          viewport={{ once: true }}
+          className="glass" 
+          style={{
+            padding: '60px 48px', textAlign: 'center',
+            background: 'linear-gradient(135deg, rgba(34,197,94,0.08), rgba(59,130,246,0.1))',
+            borderColor: 'var(--glass-border-hi)',
+          }}
+        >
+          <h2 style={{ marginBottom: '16px', fontSize: '2.5rem' }}>Maximize your net spend.</h2>
+          <p style={{ marginBottom: '40px', color: 'var(--text-2)', fontSize: '1.1rem' }}>Join the elite recruitment departments using data to win the transfer window.</p>
+          <Link to="/estimate" className="btn btn-secondary btn-lg">
+            Start Free Evaluation <TrendingUp size={22} style={{ marginLeft: 10 }} />
           </Link>
-        </div>
+        </motion.div>
       </section>
+
     </div>
   )
 }

recruitment_leads.txt

@@ -0,0 +1,76 @@
+FAIRVALUE: HIGH-PRIORITY RECRUITMENT LEAD LIST
+==========================================
+
+TARGET PERSONAS:
+1. Directors of Football (DOFs)
+2. Sporting Directors
+3. Heads of Recruitment / Chief Scouts
+4. CFOs / PSR Compliance Managers
+
+THE "BIG 6" HIT LIST (2025/26 Season):
+--------------------------------------
+CLUB: Arsenal
+NAME: Richard Garlick
+ROLE: Director of Football Operations
+EMAIL PATTERN: richard.garlick@arsenal.com
+
+CLUB: Manchester City
+NAME: Txiki Begiristain
+ROLE: Director of Football
+EMAIL PATTERN: txikibegiristain@mancity.com
+
+CLUB: Manchester United
+NAME: Dan Ashworth
+ROLE: Sporting Director
+EMAIL PATTERN: dan.ashworth@mufc.co.uk
+
+CLUB: Liverpool
+NAME: Richard Hughes
+ROLE: Sporting Director
+EMAIL PATTERN: richard.hughes@liverpoolfc.com
+
+CLUB: Chelsea
+NAME: Paul Winstanley / Laurence Stewart
+ROLE: Co-Sporting Directors
+EMAIL PATTERN: paul.winstanley@chelseafc.com
+
+CLUB: Aston Villa
+NAME: Monchi (Ramón Rodríguez Verdejo)
+ROLE: President of Football Operations
+EMAIL PATTERN: monchi@avfc.co.uk
+
+CLUB: Tottenham Hotspur
+NAME: Johan Lange
+ROLE: Technical Director
+EMAIL PATTERN: johan.lange@tottenhamhotspur.com
+
+
+VALIDATED CLUB EMAIL PATTERNS:
+------------------------------
+- [first].[last]@arsenal.com
+- [first].[last]@chelseafc.com
+- [first].[last]@liverpoolfc.com
+- [first][last]@mancity.com
+- [first].[last]@mufc.co.uk
+- [first].[last]@tottenhamhotspur.com
+- [first].[last]@avfc.co.uk
+- [first].[last]@nufc.co.uk (Newcastle)
+
+
+THE "SNIPER" OUTREACH METHOD:
+-----------------------------
+1. CROSS-DEPARTMENT ATTACK: 
+   - Send the 'PSR Advisor' email to the CFO/Finance Dept.
+   - Send the 'Negotiation Leverage' email to the Sporting Director.
+   - Purpose: Force a conversation between Finance and Recruitment where YOUR tool is the solution.
+
+2. LINKEDIN VALIDATION:
+   - Search: "[Club Name] Head of Recruitment"
+   - Use Hunter.io or RocketReach to verify the email against the patterns above.
+
+3. DEADLINE DAY PRESSURE:
+   - Send the 'Rapid Valuation' email 48 hours before the window closes.
+   - This is when the "Hype Gap" is most dangerous and decision-makers are most desperate.
+
+4. ONE-OFF BAIT:
+   - Always offer to run a "Free Intrinsic Audit" on one specific high-stakes player they are currently linked with in the press.

requirements.txt

@@ -1,5 +1,5 @@
 streamlit==1.32.0
-xgboost==2.0.3
+xgboost>=3.0.0
 shap==0.44.0
 pandas==2.2.0
 numpy==1.26.4

scratch/eval_top_5.py

@@ -0,0 +1,40 @@
+import requests
+import json
+import time
+
+players = [
+    {"selected_name": "Erling Haaland", "current_club": "Manchester City", "contract_years": 3, "age": 23, "injuries_24m": 20, "asking_price": 180, "market_value_estimation": 180},
+    {"selected_name": "Bukayo Saka", "current_club": "Arsenal", "contract_years": 3, "age": 22, "injuries_24m": 10, "asking_price": 130, "market_value_estimation": 130},
+    {"selected_name": "William Saliba", "current_club": "Arsenal", "contract_years": 4, "age": 23, "injuries_24m": 5, "asking_price": 80, "market_value_estimation": 80},
+    {"selected_name": "Ollie Watkins", "current_club": "Aston Villa", "contract_years": 4, "age": 28, "injuries_24m": 15, "asking_price": 65, "market_value_estimation": 65},
+    {"selected_name": "Martin Odegaard", "current_club": "Arsenal", "contract_years": 4, "age": 25, "injuries_24m": 25, "asking_price": 95, "market_value_estimation": 95}
+]
+
+url = "https://britzzy-fairvalue-api.hf.space/api/evaluate"
+
+print("Evaluating 5 Premiership Players...\n")
+
+for p in players:
+    try:
+        print(f"Requesting evaluation for {p['selected_name']}...")
+        response = requests.post(url, json=p, timeout=30)
+        
+        if response.status_code == 200:
+            res = response.json()
+            L = res["ledger"]
+            nlp = res["nlp_results"]
+            
+            print(f"--- {p['selected_name']} ({p['current_club']}) ---")
+            print(f"Age: {p['age']} | Contract: {p['contract_years']}yr | Market Value: £{p['market_value_estimation']}m")
+            print(f"ML Baseline Value: £{L['baseline_value']:.1f}m")
+            print(f"Intrinsic Talent: £{L['intrinsic_performance_value']:.1f}m")
+            print(f"Depreciation Penalty: £{L['depreciation']:.1f}m")
+            print(f"Hard Cap limit: £{L['hard_cap']:.1f}m")
+            print(f"NLP Sentiments - Durability: {nlp['durability']:.2f}, Form: {nlp['recency']:.2f}, Agent: {nlp['agent']:.2f}")
+            print("-------------------------------------------------\n")
+        else:
+            print(f"Failed for {p['selected_name']}: HTTP {response.status_code} - {response.text}")
+    except Exception as e:
+        print(f"Error fetching {p['selected_name']}: {str(e)}")
+    
+    time.sleep(2)

scratch/ui-ux-pro-max-skill

@@ -0,0 +1 @@
+Subproject commit b7e3af80f6e331f6fb456667b82b12cade7c9d35

test2.py

@@ -0,0 +1,22 @@
+import pandas as pd
+import xgboost as xgb
+
+df = pd.read_csv("data/processed/app_features.csv")
+model = xgb.XGBRegressor()
+model.load_model("fairvalue_xgboost.json")
+expected_cols = model.feature_names_in_
+
+print("Expected cols:")
+print(expected_cols[:5])
+
+# Find name column
+name_col = next((c for c in ['name', 'name_x', 'Player_Name', 'Name'] if c in df.columns), None)
+print("Name col:", name_col)
+if name_col:
+    print("Bruno matches:", df[df[name_col].astype(str).str.contains("bruno fern", case=False, na=False)][name_col].tolist())
+
+med = df.median(numeric_only=True).to_frame().T
+missing = [c for c in expected_cols if c not in med.columns]
+print(f"Missing from median: {len(missing)} out of {len(expected_cols)}")
+if len(missing) > 0:
+    print("First 5 missing:", missing[:5])

test3.py

@@ -0,0 +1,32 @@
+import pandas as pd
+import xgboost as xgb
+import numpy as np
+
+# Load data and model
+df = pd.read_csv("data/processed/app_features.csv")
+
+mv_rename_map = {col: 'market_value_in_eur' for col in df.columns if 'market' in col.lower() and 'value' in col.lower()}
+if mv_rename_map:
+    df.rename(columns=mv_rename_map, inplace=True)
+df = df.loc[:, ~df.columns.duplicated()].copy()
+
+model = xgb.XGBRegressor()
+model.load_model("fairvalue_xgboost.json")
+expected_cols = model.feature_names_in_
+
+player_data = df.median(numeric_only=True).to_frame().T
+
+# Simulate what api/main.py does
+player_data['Contract_Years_Left'] = 2.5
+player_data['Age'] = 28
+player_data['market_value_in_eur'] = (120 * 1_000_000) / 0.85
+
+X_infer = player_data.reindex(columns=expected_cols, fill_value=0)
+
+preds = model.predict(X_infer)
+log_pv = preds[0]
+baseline_pv = np.expm1(log_pv)
+
+print(f"Log PV: {log_pv}")
+print(f"Baseline PV (Euros): {baseline_pv}")
+print(f"Baseline PV_m (Millions): {baseline_pv / 1_000_000}")

test4.py

@@ -0,0 +1,27 @@
+import pandas as pd
+import xgboost as xgb
+import numpy as np
+
+df = pd.read_csv("data/processed/app_features.csv")
+mv_rename_map = {col: 'market_value_in_eur' for col in df.columns if 'market' in col.lower() and 'value' in col.lower()}
+if mv_rename_map:
+    df.rename(columns=mv_rename_map, inplace=True)
+df = df.loc[:, ~df.columns.duplicated()].copy()
+
+model = xgb.XGBRegressor()
+model.load_model("fairvalue_xgboost.json")
+expected_cols = model.feature_names_in_
+
+player_data = df.median(numeric_only=True).to_frame().T
+player_data['Contract_Years_Left'] = 2.5
+player_data['Age'] = 28
+player_data['market_value_in_eur'] = (120 * 1_000_000) / 0.85
+
+X_infer = player_data.reindex(columns=expected_cols, fill_value=0)
+
+dmatrix = xgb.DMatrix(X_infer)
+shap_contribs = model.get_booster().predict(dmatrix, pred_contribs=True)[0]
+
+print("Base value:", shap_contribs[-1])
+for f, s in zip(expected_cols, shap_contribs[:-1]):
+    print(f"{f}: {s}")

test_inference.py

@@ -0,0 +1,44 @@
+import pandas as pd
+import xgboost as xgb
+import numpy as np
+
+# Load data and model
+df = pd.read_csv("data/processed/app_features.csv")
+
+mv_rename_map = {col: 'market_value_in_eur' for col in df.columns if 'market' in col.lower() and 'value' in col.lower()}
+if mv_rename_map:
+    df.rename(columns=mv_rename_map, inplace=True)
+df = df.loc[:, ~df.columns.duplicated()].copy()
+
+model = xgb.XGBRegressor()
+model.load_model("fairvalue_xgboost.json")
+expected_cols = model.feature_names_in_
+
+name_col = next((c for c in ['name', 'name_x', 'Player_Name', 'Name'] if c in df.columns), None)
+
+print("Name Col:", name_col)
+print("Is Bruno in df?", "Bruno Fernandes" in df[name_col].astype(str).tolist())
+
+player_data = df[df[name_col].astype(str) == "Bruno Fernandes"].iloc[0:1].copy() if name_col else df.median().to_frame().T
+
+print("Pre-update market_value_in_eur:", player_data.get('market_value_in_eur', pd.Series([None])).iloc[0])
+
+player_data['Contract_Years_Left'] = 2.5
+player_data['Age'] = 28
+player_data['market_value_in_eur'] = (120 * 1_000_000) / 0.85
+
+print("Post-update market_value_in_eur:", player_data['market_value_in_eur'].iloc[0])
+
+X_infer = player_data.reindex(columns=expected_cols, fill_value=0)
+
+print("X_infer expected length:", len(expected_cols))
+print("Any missing cols?", [c for c in expected_cols if c not in player_data.columns])
+
+preds = model.predict(X_infer)
+print("Raw pred:", preds[0])
+print("Exp PV:", np.expm1(preds[0]))
+
+dmatrix = xgb.DMatrix(X_infer)
+shap_vals = model.get_booster().predict(dmatrix, pred_contribs=True)[0]
+print("SHAP max / min:", shap_vals.max(), shap_vals.min())
+