# ScanAlbion

ScanAlbion is a real-time analytics suite, Black Market profit scanner, and crafting calculation tool for Albion Online players.

## Core Features
- **Black Market Scanner**: Scans prices in Royal cities and compares them in real-time to Caerleon Black Market buy orders. Handles cross-quality profit matching, live stock indicators, and auto-profit logging.
- **Loot Splitter**: Party and guild gank loot distribution manager. Calculates estimated market values, deducts guild taxes, tracks time-weighted member voice activity, and integrates with Discord Bot.
- **Siphoned Tracker**: Aggregates and logs player siphoned deposits/withdrawals from text-based logs, tracks timeline histories, generates charts, and exports Discord-formatted ledgers.
- **WTS Catalog**: Visual drag-and-drop Want-To-Sell item catalog designer supporting customizable 3x3 to 6x6 grids, client-side image compression, profile templates, and PNG image exports.
- **Price Checker**: Spot multi-city arbitrage opportunities across royal zones with time-ago scan age indicators and REST API fallback fetchers.
- **Trader Leaderboard**: Displays top-performing users ranked by total arbitrage profits, top individual margin trades, and real-time anonymized platform trade logs.
- **Cargo Optimizer**: Solves the Bounded Knapsack problem to fill carry weights (Ox, Stag, Mammoth) within silver budgets.
- **Crafting Math**: Dynamic ROI and focus efficiency calculators for gear crafting, refining, food, and potions.
- **Reroll Solver**: Markov chain solver computing expected silver costs to upgrade item qualities.

## Navigation & Entry Points
- `/index.html`: SEO Landing Page and public feature center.
- `/login.html`: Entry point for user registration and sign-in, with in-card morphing transitions.
- `/app.html`: Gated, interactive scanner application dashboard (requires JWT session cookie).
- `/tools/:toolSlug`: Pre-rendered SEO entry points for individual tools (e.g. `/tools/black-market-scanner`, `/tools/loot-splitter`, `/tools/cargo-optimizer`).
- `/llms-full.txt`: Comprehensive reference containing exact formulas, item values, and quality codes.

## Guides & Blog
- `/blog/` (or `/blog/index.html`): Public guides hub grouped by category (Beginner Guides, Advanced Trading, Master Mathematics, Platform Guides) and profit strategy articles.
- `/blog/post.html?slug=caerleon-black-market-guide`: Full guide on Caerleon Black Market flipping, cross-quality matching, and tax calculations.
- `/blog/post.html?slug=mammoth-transport-optimization`: How to optimize transport cargo runs using profit density and the bounded knapsack algorithm.
- `/blog/post.html?slug=crafting-refining-roi-calculator`: Guide to calculating Resource Return Rates (RER), focus efficiency, and city bonuses.
- `/blog/post.html?slug=reroll-masterpiece-solver`: Markov chain quality reroll analysis and expected silver cost solving.
- `/blog/post.html?slug=gear-upgrading-enchantment-flip`: How to flip gear using Runes, Souls, Relics, and energy upgrades.
- `/blog/post.html?slug=multi-city-arbitrage-live-price`: Multi-city market arbitrage routes and live price checking.