feat: enhance fee management with API integration and audit trail support

README.md

@@ -49,6 +49,36 @@ Key features include:
 - Backtesting parameter configuration
 - Fee configuration by pairing and market type
 
+## Templates
+
+Full page templates (`src/arbitrade/web/templates/`):
+
+| Template           | Route                    | Purpose                                                 |
+| ------------------ | ------------------------ | ------------------------------------------------------- |
+| `base.html`        | — (root layout)          | Dark theme, `.shell` container, HTMX, CSS variables     |
+| `dashboard.html`   | `/`, `/dashboard`        | Main dashboard: metrics, overview, controls, charts     |
+| `config.html`      | `/dashboard/config`      | Full configuration: fees, runtime, alerts, Kraken, risk |
+| `audit.html`       | `/dashboard/audit`       | Audit trail with auto-refresh via HTMX                  |
+| `backtesting.html` | `/dashboard/backtesting` | Backtesting panel with replay/sweep forms               |
+| `health.html`      | `/health`                | System health check                                     |
+
+Dashboard partials (`src/arbitrade/web/templates/partials/`):
+
+| Partial                  | In page          | Content                                                                                             |
+| ------------------------ | ---------------- | --------------------------------------------------------------------------------------------------- |
+| `metrics.html`           | Dashboard        | 6 KPI cards: P&L, win rate, avg duration, trade count, success %, profit factor                     |
+| `overview.html`          | Dashboard        | Status, balances, fee tier, open trades list, opportunity feed                                      |
+| `controls.html`          | Dashboard        | Runtime status, kill switch, config snapshot, alerting status, execution controls (Start/Stop/Kill) |
+| `charts.html`            | Dashboard        | Opportunity trend chart (Chart.js, Alpine toggle)                                                   |
+| `config.html`            | Config page      | Config form: Runtime, Alerts, Kraken, Risk, Strategy sections                                       |
+| `config_fees.html`       | Config page      | Pair fee table + add/edit form                                                                      |
+| `backtesting_panel.html` | Backtesting page | Run status, replay/sweep forms, recent runs                                                         |
+| `audit.html`             | Audit page       | Audit trail table: time, actor, event, decision, payload                                            |
+
+Legacy templates (`src/arbitrade/web/templates/dashboard/`):
+
+- `config_settings.html`, `config_pairs.html`, `config_fees.html` — superseded by config page; retained for reference
+
 ## Prerequisites
 
 - Python 3.12+