Add seller depth and action polish

README.md

@@ -18,18 +18,21 @@ VoiceLedger is a voice-first bookkeeping app for informal sellers, street vendor
 The submission version is feature-frozen around the complete demo loop:
 
 - Record a transaction with your microphone and transcribe it with faster-whisper.
+- Configure seller context: business name, currency label, low-stock threshold, and language style.
 - Type or paste a transaction note.
 - Bulk import multiple pasted notes for review and editing.
 - Parse it with Modal-hosted NVIDIA Nemotron when configured, with local rules as a deterministic fallback.
+- Parse common English, Hinglish, Hindi-lite, and Gujarati-lite seller phrases with deterministic fallback rules.
 - Review a human-friendly transaction card with warning badges before saving.
 - Save the structured transaction to SQLite.
 - See a “Saved just now” receipt with bookkeeping side effects.
 - View the ledger, customer credit book, and inventory in a Gradio interface.
-- Monitor business insights and a daily sales/expense timeline in a dashboard.
+- Monitor business insights, a Command Center, a seller-day activity timeline, and a daily sales/expense chart.
 - Use a mobile-first, business-style Gradio interface with custom styling.
 - Run a Daily Closeout that prepares PDF, WhatsApp summary, and CSV exports together.
 - Download a Daily Summary PDF report.
 - Generate a WhatsApp-ready daily business summary.
+- Generate customer follow-up reminders and an inventory reorder list.
 - Offload speech transcription and LLM parsing to optional Modal endpoints.
 - Edit or delete saved transactions while keeping customer credit and inventory balances consistent.
 - Export the ledger as CSV for spreadsheet sharing.
@@ -58,6 +61,8 @@ Sold 12 mangoes, 20 each
 Paid 500 for supplies
 Amit owes 100
 Bought 50 mangoes
+Amit ne 100 dene hai
+50 mango kharida
 ```
 
 The same examples are available in `sample_data/demo_transactions.txt`.
@@ -73,24 +78,29 @@ The same examples are available in `sample_data/demo_transactions.txt`.
 | `Bought 50 mangoes` | Inventory purchase, quantity `50`, item `mangoes` |
 | `Amit owes 100` | Customer credit, customer `Amit`, amount `100` |
 | `Amit paid 50` | Customer payment, customer `Amit`, amount `50` |
+| `Amit ne 100 dene hai` | Customer credit, customer `Amit`, amount `100` |
+| `Amit ne 50 diya` | Customer payment, customer `Amit`, amount `50` |
+| `50 mango kharida` | Inventory purchase, quantity `50`, item `mango` |
+| `50 mango lidha` | Inventory purchase, quantity `50`, item `mango` |
 
 ## Demo Script
 
-1. Use the `Hackathon Demo Launchpad` on the first screen to seed demo transactions.
-2. Open `Record Text & Voice`, speak or type `Sold 12 mangoes, 20 each`, parse it, and review the human-readable transaction card.
-3. Show the parse status and warning badges: Modal/NVIDIA Nemotron when available, local fallback when needed.
-4. Save the transaction and show the receipt with stock, customer, or amount side effects.
-5. Open `Dashboard`, `Customer Credit`, and `Inventory` to show timeline charts, customer detail, inventory detail, and automatic bookkeeping updates.
-6. Open `Ledger`, load a transaction by id, update or delete it, then show refreshed balances.
-7. Run Daily Closeout from `Reports & PDF`, then download CSV/PDF and generate the WhatsApp summary.
-8. Click `Check Demo Health` from the launchpad, or open `Demo Health`, to show Modal health, deployed backend version, Nemotron status, database, PDF, and endpoint checks.
+1. Use `Seller Setup` to show business name, currency, low-stock threshold, and language style.
+2. Use the `Hackathon Demo Launchpad` on the first screen to seed demo transactions.
+3. Open `Record Text & Voice`, speak or type `Sold 12 mangoes, 20 each`, parse it, and review the human-readable transaction card.
+4. Show the parse status and warning badges: Modal/NVIDIA Nemotron when available, local fallback when needed.
+5. Save the transaction and show the Command Center plus the receipt with stock, customer, or amount side effects.
+6. Open `Dashboard`, `Customer Credit`, and `Inventory` to show timeline charts, customer detail, follow-up message, inventory detail, reorder list, and automatic bookkeeping updates.
+7. Open `Ledger`, load a transaction by id, update or delete it, then show refreshed balances.
+8. Run Daily Closeout from `Reports & PDF`, then download CSV/PDF and generate the WhatsApp summary.
+9. Click `Check Demo Health` from the launchpad, or open `Demo Health`, to show Modal health, deployed backend version, Nemotron status, database, PDF, and endpoint checks.
 
 ## Screenshot and GIF Moments
 
 Capture these three moments for the Space README, demo video, or social post:
 
 - `Record Text & Voice`: Today’s Work quick actions, review card, warning badges, and save receipt.
-- `Dashboard`: metrics, sales/expense timeline, top-selling item, low-stock table, and outstanding credit.
+- `Dashboard`: Command Center, metrics, seller-day activity timeline, sales/expense timeline, top-selling item, low-stock table, and outstanding credit.
 - `Reports & PDF` plus `Ledger`: Daily Closeout, PDF/WhatsApp export, CSV download, and ledger correction.
 - `Submission Story`: AI pipeline strip and “Why small models fit” card for the Modal/Nemotron story.
 
@@ -163,6 +173,9 @@ curl -X POST https://sagarpat3199--voiceledger-api.modal.run/parse \
 - The dashboard shows daily sales, expenses, profit, outstanding credit, top sellers, and low-stock alerts from saved data.
 - Customer and inventory detail views show transaction history for one customer or item.
 - Smart review warnings flag low confidence, missing fields, duplicate risk, and negative stock before save.
+- Seller setup persists business name, currency label, low-stock threshold, and language style in SQLite.
+- Local fallback rules include common English, Hinglish, Hindi-lite, and Gujarati-lite seller notes.
+- Customer follow-up and inventory reorder helpers generate WhatsApp-ready action messages.
 - WhatsApp summaries provide a short copyable daily recap for sharing.
 - Bulk import splits pasted notes by line, parses each line, supports review edits, and saves all reviewed transactions.
 - Modal integration lives in `backend/`; if endpoint URLs are not configured, local fallback stays active.

docs/demo-video-script.md

@@ -16,6 +16,8 @@ On the first screen, show the `Judge Demo Flow` panel:
 
 Click `Seed Demo Transactions`.
 
+Show `Seller Setup` and mention that business name, currency, low-stock threshold, and language style are saved in SQLite.
+
 Open `Submission Story` and show the AI pipeline strip plus the “Why small models fit” card.
 
 Click `Check Demo Health` from the launchpad, or open `Demo Health`, and show:
@@ -45,6 +47,7 @@ Click parse. Show:
 - Human-friendly transaction review card
 - Warning badges for low confidence, missing fields, duplicate risk, or negative stock when present
 - Parse source/status
+- Command Center update
 - “Saved just now” receipt with stock, customer, or amount side effects
 
 ## 0:45-1:05 — Bookkeeping Updates
@@ -52,8 +55,8 @@ Click parse. Show:
 Use the `Sections` navigation to open:
 
 - `Dashboard` to show sales/profit/credit and the sales/expense timeline
-- `Customer Credit` to show dues and a selected customer detail view
-- `Inventory` to show stock and a selected item detail view
+- `Customer Credit` to show dues, a selected customer detail view, and a follow-up message
+- `Inventory` to show stock, a selected item detail view, and the reorder list
 - `Ledger` to show saved transactions
 
 Say: “The model handles messy input, but the app owns the accounting state.”
@@ -69,6 +72,7 @@ Open `Reports & PDF`, run `Daily Closeout`, then generate the PDF, WhatsApp summ
 Suggested screenshot/GIF moments:
 
 - Record flow: Today’s Work actions, review card, parse source, warning badges, save receipt.
+- Seller setup: currency/threshold/language style and Command Center.
 - Submission Story: AI pipeline and small-model fit card.
 - Dashboard: sales, expenses, profit, credit, timeline, top item, low-stock inventory.
 - Reports/Ledger: Daily Closeout, PDF download, WhatsApp summary, CSV export.

docs/field-notes.md

@@ -47,8 +47,10 @@ The hackathon version is intentionally frozen around the complete bookkeeping lo
 
 - Voice and text capture.
 - Modal/Nemotron parsing with local rule fallback.
+- Seller setup for business name, currency, low-stock threshold, and language style.
+- Hinglish/Hindi-lite/Gujarati-lite fallback examples for common seller notes.
 - Human-friendly review cards, warning badges, receipts, and save feedback.
-- Dashboard timeline, customer detail, inventory detail, ledger correction, Daily Closeout, PDF, CSV, and WhatsApp exports.
+- Command Center, dashboard timeline, seller-day timeline, customer follow-up, inventory reorder list, ledger correction, Daily Closeout, PDF, CSV, and WhatsApp exports.
 - Demo Health for backend observability.
 - Submission Story for the AI pipeline and small-model fit rationale.
 

docs/social-post.md

@@ -18,11 +18,14 @@ VoiceLedger turns those notes into a working ledger with:
 - local rule fallback for reliability
 - human-friendly review cards and smart warning badges
 - save receipts that explain stock, credit, and amount side effects
+- seller setup for currency, stock threshold, and language style
+- English/Hinglish/Hindi-lite/Gujarati-lite local fallback examples
 - SQLite ledger
 - customer credit tracking
 - inventory tracking
 - dashboard insights with a daily timeline
 - customer and inventory detail drilldowns
+- customer follow-up and inventory reorder messages
 - PDF, CSV, and WhatsApp summaries
 - one-click Daily Closeout
 - a visible AI pipeline and small-model fit explanation for judges

docs/submission-checklist.md

@@ -16,17 +16,23 @@
 - `Submission Story` shows the “Why small models fit” card.
 - `Demo Health` shows Modal reachable and backend version.
 - `Demo Health` shows NVIDIA Nemotron parser status.
+- Seller Setup saves business name, currency label, low-stock threshold, and language style.
 - Text parse works with `Sold 12 mangoes, 20 each`.
+- Local fallback parses `Amit ne 100 dene hai`, `Amit ne 50 diya`, and `50 mango kharida`.
 - Voice parse works and transcript appears.
 - Review card shows type, item, quantity, price, amount, customer, source, and confidence.
 - Smart warnings appear for low confidence, missing fields, duplicate risk, and negative stock.
 - Save shows a receipt with transaction type, amount, and side effects.
+- Command Center updates after save and seed.
 - Save updates Dashboard and Ledger.
 - Dashboard timeline loads from saved transactions.
+- Seller-day timeline shows recent saved transactions.
 - Customer Credit section reflects `Amit owes 100` and `Amit paid 40`.
 - Customer detail lookup shows customer transaction history and status.
+- Customer follow-up generates a WhatsApp reminder.
 - Inventory reflects purchases and sales.
 - Inventory detail lookup shows bought, sold, current stock, and low-stock status.
+- Inventory reorder list uses the configured threshold.
 - Ledger edit/delete works and derived balances rebuild.
 - CSV export downloads from Ledger.
 - Daily Closeout generates PDF, CSV, WhatsApp summary, and a status line.

tests/test_parser.py

@@ -22,6 +22,16 @@ def test_parse_shorthand_sale() -> None:
     assert transaction.amount == 240
 
 
+def test_parse_quantity_first_sale() -> None:
+    transaction = parse_transaction("12 mango 20 each")
+
+    assert transaction.transaction_type == "sale"
+    assert transaction.item == "mango"
+    assert transaction.quantity == 12
+    assert transaction.unit_price == 20
+    assert transaction.amount == 240
+
+
 def test_parse_expense() -> None:
     transaction = parse_transaction("Paid 500 for supplies")
 
@@ -39,6 +49,14 @@ def test_parse_shorthand_expense() -> None:
     assert transaction.amount == 300
 
 
+def test_parse_hinglish_expense() -> None:
+    transaction = parse_transaction("rent 300 diya")
+
+    assert transaction.transaction_type == "expense"
+    assert transaction.item == "rent"
+    assert transaction.amount == 300
+
+
 def test_parse_inventory_purchase() -> None:
     transaction = parse_transaction("Bought 50 mangoes")
 
@@ -48,6 +66,22 @@ def test_parse_inventory_purchase() -> None:
     assert transaction.payment_status == "paid"
 
 
+def test_parse_quantity_first_inventory_purchase() -> None:
+    transaction = parse_transaction("50 mango kharida")
+
+    assert transaction.transaction_type == "inventory_purchase"
+    assert transaction.quantity == 50
+    assert transaction.item == "mango"
+
+
+def test_parse_gujarati_lite_inventory_purchase() -> None:
+    transaction = parse_transaction("50 mango lidha")
+
+    assert transaction.transaction_type == "inventory_purchase"
+    assert transaction.quantity == 50
+    assert transaction.item == "mango"
+
+
 def test_parse_sale_without_unit_price_for_inventory() -> None:
     transaction = parse_transaction("Sold 12 mangoes")
 
@@ -66,6 +100,14 @@ def test_parse_customer_credit() -> None:
     assert transaction.payment_status == "credit"
 
 
+def test_parse_hinglish_customer_credit() -> None:
+    transaction = parse_transaction("Amit ne 100 dene hai")
+
+    assert transaction.transaction_type == "customer_credit"
+    assert transaction.customer == "Amit"
+    assert transaction.amount == 100
+
+
 def test_parse_customer_payment() -> None:
     transaction = parse_transaction("Amit paid 50")
 
@@ -75,6 +117,14 @@ def test_parse_customer_payment() -> None:
     assert transaction.payment_status == "paid"
 
 
+def test_parse_hinglish_customer_payment() -> None:
+    transaction = parse_transaction("Amit ne 50 diya")
+
+    assert transaction.transaction_type == "customer_payment"
+    assert transaction.customer == "Amit"
+    assert transaction.amount == 50
+
+
 def test_unknown_note_is_preserved() -> None:
     transaction = parse_transaction("Need to check yesterday")
 

tests/test_settings.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from voiceledger.ledger.settings import get_business_settings, get_low_stock_threshold, update_business_settings
+
+
+def test_business_settings_defaults_load_when_empty(tmp_path: Path) -> None:
+    db_path = tmp_path / "voiceledger.sqlite3"
+
+    settings = get_business_settings(db_path)
+
+    assert settings["business_name"] == "VoiceLedger Seller"
+    assert settings["currency_symbol"] == "₹"
+    assert get_low_stock_threshold(db_path) == 5
+
+
+def test_business_settings_update_values(tmp_path: Path) -> None:
+    db_path = tmp_path / "voiceledger.sqlite3"
+
+    settings = update_business_settings(
+        business_name="Mango Cart",
+        currency_symbol="Rs ",
+        low_stock_threshold=8,
+        language_style="English + Hinglish",
+        db_path=db_path,
+    )
+
+    assert settings["business_name"] == "Mango Cart"
+    assert settings["currency_symbol"] == "Rs"
+    assert settings["low_stock_threshold"] == "8.0"
+    assert get_low_stock_threshold(db_path) == 8

tests/test_ui_audio_flow.py

@@ -70,7 +70,7 @@ def test_parse_note_surfaces_modal_source(monkeypatch) -> None:
     assert structured["transaction_type"] == "expense"
     assert state == structured
     assert "NVIDIA Nemotron" in status
-    assert "Ready to save" in review_card
+    assert "Safe to save" in review_card
 
 
 def test_high_contrast_demo_panels_are_rendered() -> None:
@@ -133,6 +133,16 @@ def test_review_warnings_flag_missing_and_low_confidence() -> None:
     assert "Low confidence" in warnings
 
 
+def test_review_card_surfaces_needs_review_for_missing_fields() -> None:
+    transaction = gradio_app.Transaction(transaction_type="customer_credit", confidence=0.8)
+
+    review_card = gradio_app._review_card(transaction, "Parsed locally.", gradio_app._review_warnings(transaction, None))
+
+    assert "Needs review" in review_card
+    assert "Missing amount" in review_card
+    assert "Missing customer" in review_card
+
+
 def test_receipt_card_summarizes_saved_sale(tmp_path) -> None:
     transaction = gradio_app.local_parse_transaction("Sold 12 mangoes, 20 each")
 
@@ -152,5 +162,37 @@ def test_daily_closeout_returns_exports(tmp_path) -> None:
     assert "Daily Closeout Ready" in summary
     assert pdf_path is not None
     assert csv_path is not None
-    assert "VoiceLedger Daily Summary" in whatsapp
+    assert "VoiceLedger Seller Daily Summary" in whatsapp
     assert "Daily closeout complete" in status
+
+
+def test_command_center_and_seller_setup_use_settings(tmp_path) -> None:
+    db_path = tmp_path / "voiceledger.sqlite3"
+    gradio_app.update_business_settings(
+        business_name="Mango Cart",
+        currency_symbol="Rs ",
+        low_stock_threshold=3,
+        language_style="English + Hinglish",
+        db_path=db_path,
+    )
+    gradio_app.add_transaction(gradio_app.local_parse_transaction("Sold 12 mangoes, 20 each"), db_path)
+
+    command_center = gradio_app._command_center(db_path)
+
+    assert "Mango Cart Command Center" in command_center
+    assert "Rs240" in command_center
+
+
+def test_customer_followup_and_reorder_helpers(tmp_path) -> None:
+    db_path = tmp_path / "voiceledger.sqlite3"
+    gradio_app.add_transaction(gradio_app.local_parse_transaction("Amit owes 100"), db_path)
+    gradio_app.add_transaction(gradio_app.local_parse_transaction("Amit paid 40"), db_path)
+    gradio_app.add_transaction(gradio_app.local_parse_transaction("Bought 3 onions"), db_path)
+
+    followup = gradio_app.generate_customer_followup("Amit", db_path)
+    reorder, message = gradio_app.generate_reorder_list(db_path)
+
+    assert "Amit" in followup
+    assert "₹60" in followup
+    assert "onions" in set(reorder["item"])
+    assert "Onions" in message

voiceledger/ledger/__init__.py

@@ -11,6 +11,7 @@ from voiceledger.ledger.analytics import (
 from voiceledger.ledger.customers import add_credit, get_customer_balances, record_payment
 from voiceledger.ledger.database import add_transaction, get_transactions, initialize_database
 from voiceledger.ledger.inventory import add_stock, get_inventory, remove_stock
+from voiceledger.ledger.settings import get_business_settings, get_low_stock_threshold, update_business_settings
 
 __all__ = [
     "initialize_database",
@@ -22,6 +23,9 @@ __all__ = [
     "add_stock",
     "remove_stock",
     "get_inventory",
+    "get_business_settings",
+    "update_business_settings",
+    "get_low_stock_threshold",
     "calculate_daily_sales",
     "calculate_daily_expenses",
     "calculate_net_profit",

voiceledger/ledger/database.py

@@ -13,6 +13,7 @@ import pandas as pd
 from voiceledger.config import get_database_path
 from voiceledger.ledger.customers import add_credit, initialize_customers_table, record_payment
 from voiceledger.ledger.inventory import add_stock, initialize_inventory_table, remove_stock
+from voiceledger.ledger.settings import initialize_business_settings_table
 from voiceledger.parser.schema import Transaction
 
 
@@ -58,6 +59,7 @@ def initialize_database(db_path: str | Path | None = None) -> Path:
 
     initialize_customers_table(path)
     initialize_inventory_table(path)
+    initialize_business_settings_table(path)
     return path
 
 

voiceledger/ledger/settings.py

@@ -0,0 +1,123 @@
+"""Business settings persistence for VoiceLedger."""
+
+from __future__ import annotations
+
+import sqlite3
+from pathlib import Path
+
+from voiceledger.config import get_database_path
+
+
+SETTINGS_SCHEMA_SQL = """
+CREATE TABLE IF NOT EXISTS business_settings (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+);
+"""
+
+DEFAULT_BUSINESS_SETTINGS = {
+    "business_name": "VoiceLedger Seller",
+    "currency_symbol": "₹",
+    "low_stock_threshold": "5",
+    "language_style": "English + Hinglish",
+    "field_test_who": "A local informal seller who tracks sales, stock, customer dues, and profit from short notes.",
+    "field_test_tried": "Voice notes, typed notes, customer credit, inventory updates, dashboard review, and exports.",
+    "field_test_changed": "Added review warnings, save receipts, edit/delete, CSV export, and clearer demo health.",
+}
+
+
+def initialize_business_settings_table(db_path: str | Path | None = None) -> Path:
+    """Create the business settings table and seed default values."""
+    path = _resolve_db_path(db_path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    with sqlite3.connect(path) as connection:
+        connection.execute(SETTINGS_SCHEMA_SQL)
+        connection.executemany(
+            """
+            INSERT OR IGNORE INTO business_settings (key, value)
+            VALUES (?, ?)
+            """,
+            DEFAULT_BUSINESS_SETTINGS.items(),
+        )
+        connection.commit()
+
+    return path
+
+
+def get_business_settings(db_path: str | Path | None = None) -> dict[str, str]:
+    """Return business settings merged with defaults."""
+    path = initialize_business_settings_table(db_path)
+    with sqlite3.connect(path) as connection:
+        rows = connection.execute("SELECT key, value FROM business_settings").fetchall()
+
+    settings = dict(DEFAULT_BUSINESS_SETTINGS)
+    settings.update({str(key): str(value) for key, value in rows})
+    return settings
+
+
+def update_business_settings(
+    business_name: str | None = None,
+    currency_symbol: str | None = None,
+    low_stock_threshold: float | int | str | None = None,
+    language_style: str | None = None,
+    db_path: str | Path | None = None,
+    **extra_settings: str | None,
+) -> dict[str, str]:
+    """Update business settings and return the merged settings."""
+    path = initialize_business_settings_table(db_path)
+    updates: dict[str, str] = {}
+    if business_name is not None:
+        updates["business_name"] = _clean_text(business_name, DEFAULT_BUSINESS_SETTINGS["business_name"])
+    if currency_symbol is not None:
+        updates["currency_symbol"] = _clean_text(currency_symbol, DEFAULT_BUSINESS_SETTINGS["currency_symbol"])
+    if low_stock_threshold is not None:
+        updates["low_stock_threshold"] = str(_coerce_threshold(low_stock_threshold))
+    if language_style is not None:
+        updates["language_style"] = _clean_text(language_style, DEFAULT_BUSINESS_SETTINGS["language_style"])
+
+    for key, value in extra_settings.items():
+        if key in DEFAULT_BUSINESS_SETTINGS and value is not None:
+            updates[key] = _clean_text(value, DEFAULT_BUSINESS_SETTINGS[key])
+
+    if updates:
+        with sqlite3.connect(path) as connection:
+            connection.executemany(
+                """
+                INSERT INTO business_settings (key, value)
+                VALUES (?, ?)
+                ON CONFLICT(key) DO UPDATE SET value = excluded.value
+                """,
+                updates.items(),
+            )
+            connection.commit()
+
+    return get_business_settings(path)
+
+
+def get_low_stock_threshold(db_path: str | Path | None = None) -> float:
+    """Return the configured low-stock threshold as a float."""
+    settings = get_business_settings(db_path)
+    return _coerce_threshold(settings.get("low_stock_threshold", DEFAULT_BUSINESS_SETTINGS["low_stock_threshold"]))
+
+
+def _coerce_threshold(value: float | int | str) -> float:
+    """Return a non-negative low-stock threshold."""
+    try:
+        threshold = float(value)
+    except (TypeError, ValueError):
+        threshold = float(DEFAULT_BUSINESS_SETTINGS["low_stock_threshold"])
+    return max(threshold, 0.0)
+
+
+def _clean_text(value: str, default: str) -> str:
+    """Normalize a setting string."""
+    cleaned = " ".join(str(value or "").split()).strip()
+    return cleaned or default
+
+
+def _resolve_db_path(db_path: str | Path | None) -> Path:
+    """Resolve an explicit or configured database path."""
+    if db_path is None:
+        return get_database_path()
+    return Path(db_path).expanduser()

voiceledger/parser/rules.py

@@ -32,11 +32,23 @@ SHORTHAND_SALE_PATTERN = re.compile(
     rf"(?P<unit_price>\d+(?:\.\d+)?)\s*$",
     re.IGNORECASE,
 )
+QUANTITY_FIRST_SALE_PATTERN = re.compile(
+    rf"^\s*(?P<quantity>\d+(?:\.\d+)?)\s+"
+    rf"(?P<item>[a-zA-Z][a-zA-Z\s-]*?)\s+"
+    rf"(?P<unit_price>\d+(?:\.\d+)?)\s*(?:each|per\s+\w+)?\s*$",
+    re.IGNORECASE,
+)
 SHORTHAND_EXPENSE_PATTERN = re.compile(
     rf"^\s*(?P<item>[a-zA-Z][a-zA-Z\s-]*?)\s+"
     rf"(?P<amount>\d+(?:\.\d+)?)\s*$",
     re.IGNORECASE,
 )
+HINGLISH_EXPENSE_PATTERN = re.compile(
+    rf"^\s*(?P<item>[a-zA-Z][a-zA-Z\s-]*?)\s+"
+    rf"(?P<amount>\d+(?:\.\d+)?)\s+"
+    rf"(?:diya|dia|paid|pay|chukaya)\s*$",
+    re.IGNORECASE,
+)
 INVENTORY_PURCHASE_PATTERN = re.compile(
     rf"\b(?:bought|purchased|buy|stocked|restocked)\s+"
     rf"(?P<quantity>\d+(?:\.\d+)?)\s+"
@@ -44,18 +56,36 @@ INVENTORY_PURCHASE_PATTERN = re.compile(
     rf"(?:\s+(?:for|at)\s+(?P<amount>\d+(?:\.\d+)?))?\b",
     re.IGNORECASE,
 )
+QUANTITY_FIRST_INVENTORY_PATTERN = re.compile(
+    rf"^\s*(?P<quantity>\d+(?:\.\d+)?)\s+"
+    rf"(?P<item>[a-zA-Z][a-zA-Z\s-]*?)\s+"
+    rf"(?:kharida|kharidi|khareeda|lidha|liya|li|bought|purchased)\s*$",
+    re.IGNORECASE,
+)
 CREDIT_PATTERN = re.compile(
     rf"^\s*(?P<customer>[a-zA-Z][a-zA-Z\s-]*?)\s+"
     rf"(?:owes|owe|will\s+pay|to\s+pay)\s+"
     rf"(?P<amount>\d+(?:\.\d+)?)\b",
     re.IGNORECASE,
 )
+HINGLISH_CREDIT_PATTERN = re.compile(
+    rf"^\s*(?P<customer>[a-zA-Z][a-zA-Z\s-]*?)\s+"
+    rf"(?:ne\s+)?(?P<amount>\d+(?:\.\d+)?)\s+"
+    rf"(?:dene\s+hai|dena\s+hai|aapva\s+che|apvana\s+che|owes)\b",
+    re.IGNORECASE,
+)
 CUSTOMER_PAYMENT_PATTERN = re.compile(
     rf"^\s*(?P<customer>[a-zA-Z][a-zA-Z\s-]*?)\s+"
     rf"(?:paid|pays|settled|repaid)\s+"
     rf"(?P<amount>\d+(?:\.\d+)?)\b",
     re.IGNORECASE,
 )
+HINGLISH_PAYMENT_PATTERN = re.compile(
+    rf"^\s*(?P<customer>[a-zA-Z][a-zA-Z\s-]*?)\s+"
+    rf"ne\s+(?P<amount>\d+(?:\.\d+)?)\s+"
+    rf"(?:diya|dia|aapya|apya|paid|chukaya)\b",
+    re.IGNORECASE,
+)
 
 
 class RuleParser(Parser):
@@ -96,10 +126,18 @@ def parse_transaction(note: str) -> Transaction:
     if shorthand_sale:
         return shorthand_sale
 
+    quantity_first_sale = _parse_quantity_first_sale(cleaned_note)
+    if quantity_first_sale:
+        return quantity_first_sale
+
     expense = _parse_expense(cleaned_note)
     if expense:
         return expense
 
+    hinglish_expense = _parse_hinglish_expense(cleaned_note)
+    if hinglish_expense:
+        return hinglish_expense
+
     shorthand_expense = _parse_shorthand_expense(cleaned_note)
     if shorthand_expense:
         return shorthand_expense
@@ -171,6 +209,26 @@ def _parse_shorthand_sale(note: str) -> Transaction | None:
     )
 
 
+def _parse_quantity_first_sale(note: str) -> Transaction | None:
+    """Parse notes like '12 mango 20 each'."""
+    match = QUANTITY_FIRST_SALE_PATTERN.search(note)
+    if not match:
+        return None
+
+    quantity = _to_float(match.group("quantity"))
+    unit_price = _to_float(match.group("unit_price"))
+    return Transaction(
+        transaction_type="sale",
+        item=_clean_item(match.group("item")),
+        quantity=quantity,
+        unit_price=unit_price,
+        amount=round(quantity * unit_price, 2) if quantity is not None and unit_price is not None else None,
+        payment_status="paid",
+        notes=note,
+        confidence=0.8,
+    )
+
+
 def _parse_shorthand_expense(note: str) -> Transaction | None:
     """Parse notes like 'rent 300'."""
     match = SHORTHAND_EXPENSE_PATTERN.search(note)
@@ -187,9 +245,25 @@ def _parse_shorthand_expense(note: str) -> Transaction | None:
     )
 
 
+def _parse_hinglish_expense(note: str) -> Transaction | None:
+    """Parse notes like 'rent 300 diya'."""
+    match = HINGLISH_EXPENSE_PATTERN.search(note)
+    if not match:
+        return None
+
+    return Transaction(
+        transaction_type="expense",
+        item=_clean_item(match.group("item")),
+        amount=_to_float(match.group("amount")),
+        payment_status="paid",
+        notes=note,
+        confidence=0.76,
+    )
+
+
 def _parse_inventory_purchase(note: str) -> Transaction | None:
     """Parse notes like 'Bought 50 mangoes'."""
-    match = INVENTORY_PURCHASE_PATTERN.search(note)
+    match = INVENTORY_PURCHASE_PATTERN.search(note) or QUANTITY_FIRST_INVENTORY_PATTERN.search(note)
     if not match:
         return None
 
@@ -197,7 +271,7 @@ def _parse_inventory_purchase(note: str) -> Transaction | None:
         transaction_type="inventory_purchase",
         item=_clean_item(match.group("item")),
         quantity=_to_float(match.group("quantity")),
-        amount=_to_float(match.group("amount")),
+        amount=_to_float(match.groupdict().get("amount")),
         payment_status="paid",
         notes=note,
         confidence=0.86,
@@ -206,7 +280,7 @@ def _parse_inventory_purchase(note: str) -> Transaction | None:
 
 def _parse_customer_credit(note: str) -> Transaction | None:
     """Parse notes like 'Amit owes 100'."""
-    match = CREDIT_PATTERN.search(note)
+    match = CREDIT_PATTERN.search(note) or HINGLISH_CREDIT_PATTERN.search(note)
     if not match:
         return None
 
@@ -222,7 +296,7 @@ def _parse_customer_credit(note: str) -> Transaction | None:
 
 def _parse_customer_payment(note: str) -> Transaction | None:
     """Parse notes like 'Amit paid 50'."""
-    match = CUSTOMER_PAYMENT_PATTERN.search(note)
+    match = CUSTOMER_PAYMENT_PATTERN.search(note) or HINGLISH_PAYMENT_PATTERN.search(note)
     if not match:
         return None
 

voiceledger/reports/__init__.py

@@ -1,5 +1,6 @@
 """Reporting helpers for VoiceLedger."""
 
+from voiceledger.reports.actions import generate_customer_followup, generate_reorder_list
 from voiceledger.reports.pdf_report import build_daily_summary, generate_daily_summary_pdf
 from voiceledger.reports.summary import summarize_transactions
 from voiceledger.reports.whatsapp_summary import generate_whatsapp_summary
@@ -9,4 +10,6 @@ __all__ = [
     "build_daily_summary",
     "generate_daily_summary_pdf",
     "generate_whatsapp_summary",
+    "generate_customer_followup",
+    "generate_reorder_list",
 ]

voiceledger/reports/actions.py

@@ -0,0 +1,83 @@
+"""Action-oriented seller messages for follow-up and restocking."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pandas as pd
+
+from voiceledger.ledger.customers import get_customer_balances
+from voiceledger.ledger.inventory import get_inventory
+from voiceledger.ledger.settings import get_business_settings, get_low_stock_threshold
+
+
+REORDER_COLUMNS = ["item", "current_stock", "suggested_action"]
+
+
+def generate_customer_followup(customer_name: str, db_path: str | Path | None = None) -> str:
+    """Generate a short WhatsApp reminder for one customer's outstanding balance."""
+    name = " ".join((customer_name or "").split()).strip()
+    if not name:
+        return "Select a customer to generate a follow-up message."
+
+    settings = get_business_settings(db_path)
+    currency = settings["currency_symbol"]
+    balances = get_customer_balances(db_path)
+    if balances.empty:
+        return f"No outstanding balance found for {name}."
+
+    matches = balances[balances["customer"].astype(str).str.lower() == name.lower()]
+    if matches.empty:
+        return f"No outstanding balance found for {name}."
+
+    balance = float(matches.iloc[0]["outstanding_balance"])
+    if balance <= 0:
+        return f"Hi {matches.iloc[0]['customer']}, your balance is clear. Thank you."
+
+    return f"Hi {matches.iloc[0]['customer']}, your balance is {_format_money(balance, currency)}. Please pay when possible."
+
+
+def generate_reorder_list(db_path: str | Path | None = None) -> tuple[pd.DataFrame, str]:
+    """Return low-stock rows and a WhatsApp-ready restock message."""
+    settings = get_business_settings(db_path)
+    threshold = get_low_stock_threshold(db_path)
+    inventory = get_inventory(db_path)
+    if inventory.empty:
+        return pd.DataFrame(columns=REORDER_COLUMNS), "No inventory recorded yet."
+
+    stock = inventory.copy()
+    stock["current_stock"] = pd.to_numeric(stock["current_stock"], errors="coerce").fillna(0)
+    low_stock = stock[stock["current_stock"] < threshold].sort_values(["current_stock", "item"]).copy()
+    if low_stock.empty:
+        return pd.DataFrame(columns=REORDER_COLUMNS), f"All stock is above the low-stock threshold of {_format_quantity(threshold)}."
+
+    low_stock["suggested_action"] = low_stock.apply(
+        lambda row: f"Restock {row['item']} soon; current stock is {_format_quantity(row['current_stock'])}.",
+        axis=1,
+    )
+    message_lines = [
+        f"{settings['business_name']} Reorder List",
+        f"Low-stock threshold: {_format_quantity(threshold)}",
+        "",
+    ]
+    message_lines.extend(
+        f"- {row['item'].title()}: {_format_quantity(row['current_stock'])} left"
+        for _, row in low_stock.head(8).iterrows()
+    )
+    return low_stock[REORDER_COLUMNS].reset_index(drop=True), "\n".join(message_lines)
+
+
+def _format_quantity(value: object) -> str:
+    """Format quantity without unnecessary decimals."""
+    quantity = float(value)
+    if quantity.is_integer():
+        return str(int(quantity))
+    return f"{quantity:.2f}"
+
+
+def _format_money(value: float, currency_symbol: str) -> str:
+    """Format money with the configured currency symbol."""
+    amount = float(value)
+    if amount.is_integer():
+        return f"{currency_symbol}{int(amount)}"
+    return f"{currency_symbol}{amount:,.2f}"

voiceledger/reports/pdf_report.py

@@ -51,6 +51,8 @@ def generate_daily_summary_pdf(
     db_path: str | Path | None = None,
     output_dir: str | Path | None = None,
     report_date: date | None = None,
+    business_name: str = "VoiceLedger",
+    currency_symbol: str = "",
 ) -> Path:
     """Generate a Daily Summary PDF and return its filesystem path."""
     try:
@@ -65,8 +67,8 @@ def generate_daily_summary_pdf(
     pdf.set_auto_page_break(auto=True, margin=15)
     pdf.add_page()
 
-    _add_title(pdf, summary.report_date)
-    _add_totals(pdf, summary)
+    _add_title(pdf, summary.report_date, business_name)
+    _add_totals(pdf, summary, currency_symbol)
     _add_inventory_summary(pdf, summary.inventory)
 
     pdf.output(str(output_path))
@@ -106,31 +108,31 @@ def _build_output_path(output_dir: str | Path | None, report_date: date) -> Path
     return directory / f"voiceledger-daily-summary-{report_date.isoformat()}-{timestamp}.pdf"
 
 
-def _add_title(pdf: object, report_date: date) -> None:
+def _add_title(pdf: object, report_date: date, business_name: str) -> None:
     """Add report title and date."""
     pdf.set_font("Helvetica", "B", 18)
-    pdf.cell(0, 12, "VoiceLedger Daily Summary", new_x="LMARGIN", new_y="NEXT")
+    pdf.cell(0, 12, f"{_pdf_safe_text(business_name)} Daily Summary", new_x="LMARGIN", new_y="NEXT")
     pdf.set_font("Helvetica", "", 11)
     pdf.cell(0, 8, f"Date: {report_date.isoformat()}", new_x="LMARGIN", new_y="NEXT")
     pdf.ln(4)
 
 
-def _add_totals(pdf: object, summary: DailySummary) -> None:
+def _add_totals(pdf: object, summary: DailySummary, currency_symbol: str) -> None:
     """Add the financial summary section."""
     pdf.set_font("Helvetica", "B", 13)
     pdf.cell(0, 9, "Financial Summary", new_x="LMARGIN", new_y="NEXT")
     pdf.set_font("Helvetica", "", 11)
-    _add_metric_row(pdf, "Total Sales", summary.total_sales)
-    _add_metric_row(pdf, "Total Expenses", summary.total_expenses)
-    _add_metric_row(pdf, "Net Profit", summary.net_profit)
-    _add_metric_row(pdf, "Customer Credit Outstanding", summary.customer_credit_outstanding)
+    _add_metric_row(pdf, "Total Sales", summary.total_sales, currency_symbol)
+    _add_metric_row(pdf, "Total Expenses", summary.total_expenses, currency_symbol)
+    _add_metric_row(pdf, "Net Profit", summary.net_profit, currency_symbol)
+    _add_metric_row(pdf, "Customer Credit Outstanding", summary.customer_credit_outstanding, currency_symbol)
     pdf.ln(5)
 
 
-def _add_metric_row(pdf: object, label: str, value: float) -> None:
+def _add_metric_row(pdf: object, label: str, value: float, currency_symbol: str) -> None:
     """Add one label/value row to the PDF."""
     pdf.cell(85, 8, label)
-    pdf.cell(0, 8, _format_money(value), new_x="LMARGIN", new_y="NEXT")
+    pdf.cell(0, 8, _format_money(value, currency_symbol), new_x="LMARGIN", new_y="NEXT")
 
 
 def _add_inventory_summary(pdf: object, inventory: pd.DataFrame) -> None:
@@ -151,9 +153,10 @@ def _add_inventory_summary(pdf: object, inventory: pd.DataFrame) -> None:
         pdf.cell(40, 8, _format_quantity(row["current_stock"]), border=1, new_x="LMARGIN", new_y="NEXT")
 
 
-def _format_money(value: float) -> str:
+def _format_money(value: float, currency_symbol: str) -> str:
     """Format a monetary amount for PDF output."""
-    return f"{value:,.2f}"
+    symbol = _pdf_safe_text(currency_symbol)
+    return f"{symbol}{value:,.2f}" if symbol else f"{value:,.2f}"
 
 
 def _format_quantity(value: object) -> str:
@@ -162,3 +165,8 @@ def _format_quantity(value: object) -> str:
     if quantity.is_integer():
         return str(int(quantity))
     return f"{quantity:,.2f}"
+
+
+def _pdf_safe_text(value: str) -> str:
+    """Return text safe for the default fpdf Helvetica font."""
+    return str(value or "").replace("₹", "Rs").encode("latin-1", "ignore").decode("latin-1")

voiceledger/reports/whatsapp_summary.py

@@ -21,6 +21,8 @@ def generate_whatsapp_summary(
     db_path: str | Path | None = None,
     report_date: date | None = None,
     low_stock_threshold: float = 5,
+    business_name: str = "VoiceLedger",
+    currency_symbol: str = "₹",
 ) -> str:
     """Generate a concise daily summary suitable for WhatsApp sharing."""
     sales = calculate_daily_sales(db_path=db_path, report_date=report_date)
@@ -32,13 +34,13 @@ def generate_whatsapp_summary(
 
     return "\n".join(
         [
-            "VoiceLedger Daily Summary",
+            f"{business_name} Daily Summary",
             "",
-            f"Sales: {_format_money(sales)}",
-            f"Expenses: {_format_money(expenses)}",
-            f"Profit: {_format_money(profit)}",
+            f"Sales: {_format_money(sales, currency_symbol)}",
+            f"Expenses: {_format_money(expenses, currency_symbol)}",
+            f"Profit: {_format_money(profit, currency_symbol)}",
             "",
-            f"Outstanding Credit: {_format_money(credit)}",
+            f"Outstanding Credit: {_format_money(credit, currency_symbol)}",
             "",
             f"Top Product: {top_product}",
             f"Low Stock: {low_stock}",
@@ -60,9 +62,9 @@ def _low_stock_names(low_stock: pd.DataFrame) -> str:
     return ", ".join(str(item).title() for item in low_stock["item"].head(3))
 
 
-def _format_money(value: float) -> str:
+def _format_money(value: float, currency_symbol: str) -> str:
     """Format an amount using a rupee symbol and no decimals for whole values."""
     amount = float(value)
     if amount.is_integer():
-        return f"₹{int(amount)}"
-    return f"₹{amount:,.2f}"
+        return f"{currency_symbol}{int(amount)}"
+    return f"{currency_symbol}{amount:,.2f}"

voiceledger/ui/gradio_app.py

@@ -38,9 +38,11 @@ from voiceledger.ledger.database import (
     update_transaction,
 )
 from voiceledger.ledger.inventory import get_inventory
+from voiceledger.ledger.settings import get_business_settings, get_low_stock_threshold, update_business_settings
 from voiceledger.parser.bulk import REVIEW_COLUMNS, parse_bulk_notes, review_table_to_transactions
 from voiceledger.parser.rules import parse_transaction as local_parse_transaction
 from voiceledger.parser.schema import Transaction
+from voiceledger.reports.actions import generate_customer_followup, generate_reorder_list
 from voiceledger.reports.pdf_report import generate_daily_summary_pdf
 from voiceledger.reports.whatsapp_summary import generate_whatsapp_summary
 from voiceledger.speech.transcribe import TranscriptionError, transcribe_audio as local_transcribe_audio
@@ -83,6 +85,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
         )
 
         parsed_state = gr.State(value=None)
+        initial_settings = get_business_settings(db_path)
 
         with gr.Group(elem_classes="vl-app-nav"):
             gr.HTML("<strong>Sections</strong>")
@@ -105,6 +108,35 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                         "Use the Sections buttons above to open each workflow page. VoiceLedger is locked for the hackathon demo: core bookkeeping is frozen, with Modal/Nemotron active and local fallback ready.",
                     )
                 )
+                command_center_output = gr.HTML(_command_center(db_path))
+                gr.HTML(_section_heading("Seller Setup"))
+                with gr.Row():
+                    business_name_input = gr.Textbox(
+                        label="Business name",
+                        value=initial_settings["business_name"],
+                        elem_classes="vl-panel",
+                    )
+                    currency_symbol_input = gr.Textbox(
+                        label="Currency label",
+                        value=initial_settings["currency_symbol"],
+                        elem_classes="vl-panel",
+                    )
+                with gr.Row():
+                    low_stock_threshold_input = gr.Number(
+                        label="Low-stock threshold",
+                        value=float(initial_settings["low_stock_threshold"]),
+                        elem_classes="vl-panel",
+                    )
+                    language_style_input = gr.Dropdown(
+                        choices=["English", "English + Hinglish", "English + Gujarati-lite"],
+                        label="Primary language style",
+                        value=initial_settings["language_style"],
+                    )
+                save_settings_button = gr.Button("Save Seller Setup")
+                settings_status_output = gr.Markdown(
+                    value=_seller_setup_status(initial_settings),
+                    elem_classes="vl-status",
+                )
                 gr.HTML(_judge_demo_panel())
                 gr.HTML(_today_work_panel())
                 with gr.Row():
@@ -234,6 +266,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                         wrap=True,
                         elem_classes="vl-panel",
                     )
+                seller_day_output = gr.HTML(_seller_day_timeline(db_path))
                 refresh_dashboard_button.click(
                     fn=lambda: _get_dashboard_data(db_path),
                     inputs=None,
@@ -246,6 +279,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                         timeline_output,
                         top_items_output,
                         low_stock_output,
+                        seller_day_output,
                     ],
                 )
                 demo.load(
@@ -260,6 +294,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                         timeline_output,
                         top_items_output,
                         low_stock_output,
+                        seller_day_output,
                     ],
                 )
 
@@ -300,6 +335,28 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 gr.HTML(_submission_story_panel())
                 gr.HTML(_ai_pipeline_strip())
                 gr.HTML(_small_model_fit_card())
+                gr.HTML(_section_heading("Field Test Notes"))
+                with gr.Row():
+                    field_who_input = gr.Textbox(
+                        label="Who this is for",
+                        value=initial_settings["field_test_who"],
+                        lines=3,
+                        elem_classes="vl-panel",
+                    )
+                    field_tried_input = gr.Textbox(
+                        label="What they tried",
+                        value=initial_settings["field_test_tried"],
+                        lines=3,
+                        elem_classes="vl-panel",
+                    )
+                    field_changed_input = gr.Textbox(
+                        label="What changed after feedback",
+                        value=initial_settings["field_test_changed"],
+                        lines=3,
+                        elem_classes="vl-panel",
+                    )
+                save_field_notes_button = gr.Button("Save Field Test Notes")
+                field_notes_status_output = gr.Markdown(elem_classes="vl-status")
                 seed_demo_button = gr.Button("Seed Demo Transactions", variant="primary")
                 seed_demo_status = gr.Markdown(elem_classes="vl-status")
 
@@ -382,6 +439,20 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                     inputs=customer_detail_name,
                     outputs=[customer_detail_summary, customer_detail_output],
                 )
+                gr.HTML(_section_heading("Customer Follow-up"))
+                followup_customer_name = gr.Textbox(label="Customer for WhatsApp reminder", placeholder="Amit")
+                followup_button = gr.Button("Generate Follow-up Message")
+                followup_output = gr.Textbox(
+                    label="WhatsApp follow-up",
+                    lines=4,
+                    interactive=False,
+                    elem_classes="vl-panel",
+                )
+                followup_button.click(
+                    fn=lambda customer_name: generate_customer_followup(customer_name, db_path),
+                    inputs=followup_customer_name,
+                    outputs=followup_output,
+                )
 
         with gr.Column(visible=False, elem_classes="vl-page-section") as inventory_page:
                 gr.HTML('<div id="vl-page-inventory" class="vl-page-anchor"></div>')
@@ -426,6 +497,26 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                     inputs=inventory_detail_item,
                     outputs=[inventory_detail_summary, inventory_detail_output],
                 )
+                gr.HTML(_section_heading("Inventory Reorder List"))
+                reorder_button = gr.Button("Generate Reorder List")
+                reorder_output = gr.Dataframe(
+                    headers=["item", "current_stock", "suggested_action"],
+                    label="Low-stock reorder list",
+                    interactive=False,
+                    wrap=True,
+                    elem_classes="vl-panel",
+                )
+                reorder_message_output = gr.Textbox(
+                    label="WhatsApp restock message",
+                    lines=8,
+                    interactive=False,
+                    elem_classes="vl-panel",
+                )
+                reorder_button.click(
+                    fn=lambda: generate_reorder_list(db_path),
+                    inputs=None,
+                    outputs=[reorder_output, reorder_message_output],
+                )
 
         with gr.Column(visible=False, elem_classes="vl-page-section") as reports_page:
                 gr.HTML('<div id="vl-page-reports" class="vl-page-anchor"></div>')
@@ -480,10 +571,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                     """
                 )
                 generate_whatsapp_button.click(
-                    fn=lambda: generate_whatsapp_summary(
-                        db_path=db_path,
-                        low_stock_threshold=LOW_STOCK_THRESHOLD,
-                    ),
+                    fn=lambda: _generate_whatsapp_summary(db_path),
                     inputs=None,
                     outputs=whatsapp_summary_output,
                 )
@@ -586,6 +674,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
             outputs=[
                 status_output,
                 receipt_output,
+                command_center_output,
                 total_sales_output,
                 total_expenses_output,
                 net_profit_output,
@@ -594,6 +683,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 timeline_output,
                 top_items_output,
                 low_stock_output,
+                seller_day_output,
                 ledger_output,
                 customer_balances_output,
                 inventory_output,
@@ -627,6 +717,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
             ],
             outputs=[
                 edit_status_output,
+                command_center_output,
                 total_sales_output,
                 total_expenses_output,
                 net_profit_output,
@@ -635,6 +726,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 timeline_output,
                 top_items_output,
                 low_stock_output,
+                seller_day_output,
                 ledger_output,
                 customer_balances_output,
                 inventory_output,
@@ -645,6 +737,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
             inputs=edit_transaction_id,
             outputs=[
                 edit_status_output,
+                command_center_output,
                 total_sales_output,
                 total_expenses_output,
                 net_profit_output,
@@ -653,6 +746,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 timeline_output,
                 top_items_output,
                 low_stock_output,
+                seller_day_output,
                 ledger_output,
                 customer_balances_output,
                 inventory_output,
@@ -663,6 +757,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
             inputs=None,
             outputs=[
                 seed_demo_status,
+                command_center_output,
                 total_sales_output,
                 total_expenses_output,
                 net_profit_output,
@@ -671,6 +766,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 timeline_output,
                 top_items_output,
                 low_stock_output,
+                seller_day_output,
                 ledger_output,
                 customer_balances_output,
                 inventory_output,
@@ -681,6 +777,7 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
             inputs=None,
             outputs=[
                 record_demo_status,
+                command_center_output,
                 total_sales_output,
                 total_expenses_output,
                 net_profit_output,
@@ -689,11 +786,41 @@ def create_app(db_path: str | Path | None = None) -> gr.Blocks:
                 timeline_output,
                 top_items_output,
                 low_stock_output,
+                seller_day_output,
                 ledger_output,
                 customer_balances_output,
                 inventory_output,
             ],
         )
+        save_settings_button.click(
+            fn=lambda business_name, currency_symbol, low_stock_threshold, language_style: _save_seller_setup_and_refresh(
+                business_name,
+                currency_symbol,
+                low_stock_threshold,
+                language_style,
+                db_path,
+            ),
+            inputs=[business_name_input, currency_symbol_input, low_stock_threshold_input, language_style_input],
+            outputs=[
+                settings_status_output,
+                command_center_output,
+                total_sales_output,
+                total_expenses_output,
+                net_profit_output,
+                outstanding_credit_output,
+                top_selling_item_output,
+                timeline_output,
+                top_items_output,
+                low_stock_output,
+                seller_day_output,
+                inventory_output,
+            ],
+        )
+        save_field_notes_button.click(
+            fn=lambda who, tried, changed: _save_field_notes(who, tried, changed, db_path),
+            inputs=[field_who_input, field_tried_input, field_changed_input],
+            outputs=field_notes_status_output,
+        )
         record_health_button.click(
             fn=lambda: _get_system_check(db_path),
             inputs=None,
@@ -940,16 +1067,16 @@ def _save_transaction(transaction_payload: dict[str, Any] | None, db_path: str |
 def _save_transaction_and_refresh(
     transaction_payload: dict[str, Any] | None,
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
+) -> tuple[str, str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
     """Save a transaction and refresh the demo-critical data views."""
     if not transaction_payload:
-        return ("Parse a transaction before saving.", _empty_receipt_card(), *_refresh_core_views(db_path))
+        return ("Parse a transaction before saving.", _empty_receipt_card(), _command_center(db_path), *_refresh_core_views(db_path))
 
     transaction = Transaction(**transaction_payload)
     transaction_id = add_transaction(transaction, db_path)
     status = f"Saved transaction #{transaction_id}: {_transaction_summary(transaction)}."
     receipt = _receipt_card(transaction, transaction_id, db_path)
-    return (status, receipt, *_refresh_core_views(db_path))
+    return (status, receipt, _command_center(db_path), *_refresh_core_views(db_path))
 
 
 def _load_transaction_for_edit(
@@ -1013,11 +1140,11 @@ def _update_transaction_and_refresh(
     notes: str | None,
     confidence: float | None,
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
+) -> tuple[str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
     """Update a transaction and refresh all dependent views."""
     parsed_id = _coerce_transaction_id(transaction_id)
     if parsed_id is None:
-        return ("Enter a transaction id before updating.", *_refresh_core_views(db_path))
+        return ("Enter a transaction id before updating.", _command_center(db_path), *_refresh_core_views(db_path))
 
     try:
         transaction = _transaction_from_edit_fields(
@@ -1032,27 +1159,27 @@ def _update_transaction_and_refresh(
             confidence=confidence,
         )
     except Exception as exc:
-        return (f"Could not update transaction: {exc}", *_refresh_core_views(db_path))
+        return (f"Could not update transaction: {exc}", _command_center(db_path), *_refresh_core_views(db_path))
 
     updated = update_transaction(parsed_id, transaction, db_path)
     if not updated:
-        return (f"Transaction #{parsed_id} was not found.", *_refresh_core_views(db_path))
-    return (f"Updated transaction #{parsed_id}: {_transaction_summary(transaction)}.", *_refresh_core_views(db_path))
+        return (f"Transaction #{parsed_id} was not found.", _command_center(db_path), *_refresh_core_views(db_path))
+    return (f"Updated transaction #{parsed_id}: {_transaction_summary(transaction)}.", _command_center(db_path), *_refresh_core_views(db_path))
 
 
 def _delete_transaction_and_refresh(
     transaction_id: float | int | None,
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
+) -> tuple[str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
     """Delete a transaction and refresh all dependent views."""
     parsed_id = _coerce_transaction_id(transaction_id)
     if parsed_id is None:
-        return ("Enter a transaction id before deleting.", *_refresh_core_views(db_path))
+        return ("Enter a transaction id before deleting.", _command_center(db_path), *_refresh_core_views(db_path))
 
     deleted = delete_transaction(parsed_id, db_path)
     if not deleted:
-        return (f"Transaction #{parsed_id} was not found.", *_refresh_core_views(db_path))
-    return (f"Deleted transaction #{parsed_id} and refreshed balances.", *_refresh_core_views(db_path))
+        return (f"Transaction #{parsed_id} was not found.", _command_center(db_path), *_refresh_core_views(db_path))
+    return (f"Deleted transaction #{parsed_id} and refreshed balances.", _command_center(db_path), *_refresh_core_views(db_path))
 
 
 def _export_ledger_csv(db_path: str | Path | None) -> tuple[str, str]:
@@ -1063,18 +1190,19 @@ def _export_ledger_csv(db_path: str | Path | None) -> tuple[str, str]:
 
 def _seed_demo_transactions_and_refresh(
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
+) -> tuple[str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
     """Seed realistic demo transactions and refresh all dependent views."""
     saved_ids = [add_transaction(local_parse_transaction(note), db_path) for note in DEMO_NOTES]
     return (
         f"Seeded {len(saved_ids)} demo transactions. Last transaction id: #{saved_ids[-1]}.",
+        _command_center(db_path),
         *_refresh_core_views(db_path),
     )
 
 
 def _refresh_core_views(
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
+) -> tuple[str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.DataFrame, pd.DataFrame, pd.io.formats.style.Styler]:
     """Return dashboard, ledger, customer, and inventory refresh values."""
     return (
         *_get_dashboard_data(db_path),
@@ -1109,34 +1237,158 @@ def _save_bulk_transactions(review_table: Any, db_path: str | Path | None) -> st
     return f"Saved {len(saved_ids)} transactions. Last transaction id: #{saved_ids[-1]}."
 
 
+def _save_seller_setup_and_refresh(
+    business_name: str,
+    currency_symbol: str,
+    low_stock_threshold: float | None,
+    language_style: str,
+    db_path: str | Path | None,
+) -> tuple[str, str, str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str, pd.io.formats.style.Styler]:
+    """Save seller setup and refresh context-sensitive dashboard views."""
+    settings = update_business_settings(
+        business_name=business_name,
+        currency_symbol=currency_symbol,
+        low_stock_threshold=low_stock_threshold,
+        language_style=language_style,
+        db_path=db_path,
+    )
+    return (
+        _seller_setup_status(settings),
+        _command_center(db_path),
+        *_get_dashboard_data(db_path),
+        _get_inventory_display(db_path),
+    )
+
+
+def _save_field_notes(who: str, tried: str, changed: str, db_path: str | Path | None) -> str:
+    """Persist anonymized field-test notes."""
+    update_business_settings(
+        db_path=db_path,
+        field_test_who=who,
+        field_test_tried=tried,
+        field_test_changed=changed,
+    )
+    return "Saved anonymized field-test notes."
+
+
 def _get_dashboard_data(
     db_path: str | Path | None,
-) -> tuple[str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame]:
+) -> tuple[str, str, str, str, str, pd.DataFrame, pd.DataFrame, pd.DataFrame, str]:
     """Return business insight values for the Dashboard section."""
+    settings = get_business_settings(db_path)
+    currency_symbol = settings["currency_symbol"]
+    threshold = get_low_stock_threshold(db_path)
     sales = calculate_daily_sales(db_path)
     expenses = calculate_daily_expenses(db_path)
     profit = calculate_net_profit(db_path)
     credit = outstanding_credit(db_path)
     top_items = top_selling_items(db_path)
-    low_stock = low_stock_items(db_path, threshold=LOW_STOCK_THRESHOLD)
+    low_stock = low_stock_items(db_path, threshold=threshold)
     timeline = _daily_timeline(db_path)
+    seller_day = _seller_day_timeline(db_path)
     top_item = "No sales recorded today"
     if not top_items.empty:
         first_item = top_items.iloc[0]
         top_item = f"{first_item['item']} ({_format_quantity(first_item['quantity_sold'])} sold)"
 
     return (
-        _metric_card("Total Sales Today", _format_money(sales), "Recorded sales"),
-        _metric_card("Total Expenses Today", _format_money(expenses), "Purchases and costs"),
-        _metric_card("Net Profit", _format_money(profit), "Sales minus expenses", profit=profit),
-        _metric_card("Outstanding Credit", _format_money(credit), "Customer dues"),
+        _metric_card("Total Sales Today", _format_money(sales, currency_symbol), "Recorded sales"),
+        _metric_card("Total Expenses Today", _format_money(expenses, currency_symbol), "Purchases and costs"),
+        _metric_card("Net Profit", _format_money(profit, currency_symbol), "Sales minus expenses", profit=profit),
+        _metric_card("Outstanding Credit", _format_money(credit, currency_symbol), "Customer dues"),
         top_item,
         timeline,
         top_items,
         low_stock,
+        seller_day,
     )
 
 
+def _command_center(db_path: str | Path | None) -> str:
+    """Return the top-of-record-page seller command center."""
+    settings = get_business_settings(db_path)
+    currency = settings["currency_symbol"]
+    threshold = get_low_stock_threshold(db_path)
+    sales = calculate_daily_sales(db_path)
+    credit = outstanding_credit(db_path)
+    low_stock_count = len(low_stock_items(db_path, threshold=threshold))
+    last_transaction = _last_transaction_label(db_path)
+    return f"""
+    <section class="vl-command-center">
+      <h2>{escape(settings['business_name'])} Command Center</h2>
+      <div>
+        <span><strong>Sales today</strong>{escape(_format_money(sales, currency))}</span>
+        <span><strong>Outstanding credit</strong>{escape(_format_money(credit, currency))}</span>
+        <span><strong>Low-stock items</strong>{low_stock_count}</span>
+        <span><strong>Last saved</strong>{escape(last_transaction)}</span>
+      </div>
+    </section>
+    """
+
+
+def _seller_setup_status(settings: dict[str, str]) -> str:
+    """Return a concise seller setup status line."""
+    return (
+        f"Seller setup: {settings['business_name']} · currency {settings['currency_symbol']} · "
+        f"low stock below {settings['low_stock_threshold']} · {settings['language_style']}."
+    )
+
+
+def _last_transaction_label(db_path: str | Path | None) -> str:
+    """Return a concise label for the newest transaction."""
+    ledger = get_transactions(db_path)
+    if ledger.empty:
+        return "None yet"
+    row = ledger.iloc[0]
+    amount = row.get("amount")
+    item_or_customer = row.get("item") or row.get("customer") or "transaction"
+    if pd.notna(amount):
+        return f"{row['transaction_type']} · {item_or_customer} · {_format_money(float(amount), get_business_settings(db_path)['currency_symbol'])}"
+    return f"{row['transaction_type']} · {item_or_customer}"
+
+
+def _seller_day_timeline(db_path: str | Path | None) -> str:
+    """Return a visual timeline of recent seller activity."""
+    ledger = get_transactions(db_path)
+    if ledger.empty:
+        return _empty_detail_card("Seller day timeline", "No saved transactions yet.")
+
+    rows = []
+    currency = get_business_settings(db_path)["currency_symbol"]
+    for _, row in ledger.head(8).iterrows():
+        label = _transaction_type_label(str(row["transaction_type"]))
+        subject = row.get("item") or row.get("customer") or "ledger entry"
+        amount = row.get("amount")
+        amount_text = ""
+        if pd.notna(amount):
+            amount_text = f" · {_format_money(float(amount), currency)}"
+        rows.append(
+            f"""
+            <li>
+              <strong>{escape(label)}</strong>
+              <span>{escape(str(subject))}{escape(amount_text)}</span>
+            </li>
+            """
+        )
+    return f"""
+    <section class="vl-seller-timeline">
+      <h2>Seller day timeline</h2>
+      <ol>{''.join(rows)}</ol>
+    </section>
+    """
+
+
+def _transaction_type_label(transaction_type: str) -> str:
+    """Return a compact human label for a transaction type."""
+    return {
+        "sale": "Sale",
+        "expense": "Expense",
+        "inventory_purchase": "Stock purchase",
+        "customer_credit": "Customer owes",
+        "customer_payment": "Customer paid",
+    }.get(transaction_type, "Needs review")
+
+
 def _daily_timeline(db_path: str | Path | None) -> pd.DataFrame:
     """Return chart-ready daily sales and expense rows."""
     transactions = get_transactions(db_path)
@@ -1165,7 +1417,8 @@ def _daily_timeline(db_path: str | Path | None) -> pd.DataFrame:
 def _get_inventory_display(db_path: str | Path | None) -> pd.io.formats.style.Styler:
     """Return inventory with low-stock rows highlighted for Gradio display."""
     inventory = get_inventory(db_path)
-    return inventory.style.apply(_highlight_low_stock, axis=1)
+    threshold = get_low_stock_threshold(db_path)
+    return inventory.style.apply(lambda row: _highlight_low_stock(row, threshold), axis=1)
 
 
 def _get_customer_detail(customer_name: str | None, db_path: str | Path | None) -> tuple[str, pd.DataFrame]:
@@ -1191,10 +1444,11 @@ def _get_customer_detail(customer_name: str | None, db_path: str | Path | None)
         status = "owes"
     elif balance < 0:
         status = "overpaid"
+    currency = get_business_settings(db_path)["currency_symbol"]
     summary = f"""
     <section class="vl-detail-card">
       <h2>{escape(name)} · {status}</h2>
-      <p>Outstanding balance: <strong>{_format_money(balance)}</strong>. Credit: {_format_money(float(credit))}. Payments: {_format_money(float(paid))}.</p>
+      <p>Outstanding balance: <strong>{_format_money(balance, currency)}</strong>. Credit: {_format_money(float(credit), currency)}. Payments: {_format_money(float(paid), currency)}.</p>
     </section>
     """
     return summary, matches[columns].reset_index(drop=True)
@@ -1218,11 +1472,12 @@ def _get_inventory_detail(item: str | None, db_path: str | Path | None) -> tuple
     bought = pd.to_numeric(matches.loc[matches["transaction_type"] == "inventory_purchase", "quantity"], errors="coerce").fillna(0).sum()
     sold = pd.to_numeric(matches.loc[matches["transaction_type"] == "sale", "quantity"], errors="coerce").fillna(0).sum()
     stock = round(float(bought - sold), 2)
-    status = "low stock" if stock < LOW_STOCK_THRESHOLD else "in stock"
+    threshold = get_low_stock_threshold(db_path)
+    status = "low stock" if stock < threshold else "in stock"
     summary = f"""
     <section class="vl-detail-card">
       <h2>{escape(item_name)} · {status}</h2>
-      <p>Bought: {_format_quantity(bought)}. Sold: {_format_quantity(sold)}. Current stock: <strong>{_format_quantity(stock)}</strong>.</p>
+      <p>Bought: {_format_quantity(bought)}. Sold: {_format_quantity(sold)}. Current stock: <strong>{_format_quantity(stock)}</strong>. Low-stock threshold: {_format_quantity(threshold)}.</p>
     </section>
     """
     return summary, matches[columns].reset_index(drop=True)
@@ -1230,8 +1485,13 @@ def _get_inventory_detail(item: str | None, db_path: str | Path | None) -> tuple
 
 def _generate_daily_summary_report(db_path: str | Path | None) -> tuple[str | None, str]:
     """Generate the Daily Summary PDF for download in Gradio."""
+    settings = get_business_settings(db_path)
     try:
-        report_path = generate_daily_summary_pdf(db_path=db_path)
+        report_path = generate_daily_summary_pdf(
+            db_path=db_path,
+            business_name=settings["business_name"],
+            currency_symbol=settings["currency_symbol"],
+        )
     except Exception as exc:
         return None, f"Could not generate report: {exc}"
     return str(report_path), "Daily Summary PDF is ready."
@@ -1239,16 +1499,25 @@ def _generate_daily_summary_report(db_path: str | Path | None) -> tuple[str | No
 
 def _run_daily_closeout(db_path: str | Path | None) -> tuple[str, str | None, str | None, str, str]:
     """Generate the daily closeout summary and exports."""
+    settings = get_business_settings(db_path)
+    currency = settings["currency_symbol"]
+    threshold = get_low_stock_threshold(db_path)
     sales = calculate_daily_sales(db_path)
     expenses = calculate_daily_expenses(db_path)
     profit = calculate_net_profit(db_path)
     credit = outstanding_credit(db_path)
-    low_stock = low_stock_items(db_path, threshold=LOW_STOCK_THRESHOLD)
+    low_stock = low_stock_items(db_path, threshold=threshold)
 
     pdf_path: str | None
     csv_path: str | None
     try:
-        pdf_path = str(generate_daily_summary_pdf(db_path=db_path))
+        pdf_path = str(
+            generate_daily_summary_pdf(
+                db_path=db_path,
+                business_name=settings["business_name"],
+                currency_symbol=currency,
+            )
+        )
     except Exception:
         pdf_path = None
     try:
@@ -1256,15 +1525,20 @@ def _run_daily_closeout(db_path: str | Path | None) -> tuple[str, str | None, st
     except Exception:
         csv_path = None
 
-    whatsapp = generate_whatsapp_summary(db_path=db_path, low_stock_threshold=LOW_STOCK_THRESHOLD)
+    whatsapp = generate_whatsapp_summary(
+        db_path=db_path,
+        low_stock_threshold=threshold,
+        business_name=settings["business_name"],
+        currency_symbol=currency,
+    )
     summary = f"""
     <section class="vl-closeout-card">
       <h2>Daily Closeout Ready</h2>
       <div class="vl-closeout-grid">
-        <span><strong>Sales</strong>{_format_money(sales)}</span>
-        <span><strong>Expenses</strong>{_format_money(expenses)}</span>
-        <span><strong>Profit</strong>{_format_money(profit)}</span>
-        <span><strong>Credit</strong>{_format_money(credit)}</span>
+        <span><strong>Sales</strong>{_format_money(sales, currency)}</span>
+        <span><strong>Expenses</strong>{_format_money(expenses, currency)}</span>
+        <span><strong>Profit</strong>{_format_money(profit, currency)}</span>
+        <span><strong>Credit</strong>{_format_money(credit, currency)}</span>
       </div>
       <p>{len(low_stock)} low-stock item(s). PDF, WhatsApp summary, and CSV are prepared below.</p>
     </section>
@@ -1356,18 +1630,30 @@ def _metric_card(label: str, value: str, note: str, profit: float | None = None)
     """
 
 
-def _format_money(value: float) -> str:
+def _generate_whatsapp_summary(db_path: str | Path | None) -> str:
+    """Generate a WhatsApp summary using seller settings."""
+    settings = get_business_settings(db_path)
+    return generate_whatsapp_summary(
+        db_path=db_path,
+        low_stock_threshold=get_low_stock_threshold(db_path),
+        business_name=settings["business_name"],
+        currency_symbol=settings["currency_symbol"],
+    )
+
+
+def _format_money(value: float, currency_symbol: str | None = None) -> str:
     """Format money for dashboard cards."""
+    symbol = currency_symbol if currency_symbol is not None else get_business_settings()["currency_symbol"]
     amount = float(value)
     if amount.is_integer():
-        return f"₹{int(amount):,}"
-    return f"₹{amount:,.2f}"
+        return f"{symbol}{int(amount):,}"
+    return f"{symbol}{amount:,.2f}"
 
 
-def _highlight_low_stock(row: pd.Series) -> list[str]:
+def _highlight_low_stock(row: pd.Series, threshold: float = LOW_STOCK_THRESHOLD) -> list[str]:
     """Highlight rows where stock is below the configured threshold."""
     current_stock = row.get("current_stock")
-    if current_stock is not None and float(current_stock) < LOW_STOCK_THRESHOLD:
+    if current_stock is not None and float(current_stock) < threshold:
         return ["background-color: #fff3cd; color: #5f370e"] * len(row)
     return [""] * len(row)
 
@@ -1414,9 +1700,12 @@ def _empty_detail_card(title: str, body: str = "Select an item to see details.")
 
 def _review_card(transaction: Transaction, source_message: str, warnings: list[str]) -> str:
     """Render a human-friendly transaction review card."""
-    warning_markup = "".join(f'<span class="vl-warning-badge">{escape(warning)}</span>' for warning in warnings)
-    if not warning_markup:
-        warning_markup = '<span class="vl-success-badge">Ready to save</span>'
+    readiness = _review_readiness(transaction, warnings)
+    warning_markup = "".join(
+        f'<span class="{_warning_badge_class(warning)}">{escape(warning)}</span>'
+        for warning in warnings
+    )
+    warning_markup = f"{readiness}{warning_markup}"
 
     fields = [
         ("Type", transaction.transaction_type),
@@ -1448,6 +1737,8 @@ def _review_warnings(transaction: Transaction, db_path: str | Path | None) -> li
     warnings: list[str] = []
     if transaction.transaction_type == "unknown":
         warnings.append("Unknown type")
+    if transaction.transaction_type in {"sale", "inventory_purchase"} and not transaction.item:
+        warnings.append("Missing item")
     if transaction.amount is None and transaction.transaction_type in {"sale", "expense", "customer_credit", "customer_payment"}:
         warnings.append("Missing amount")
     if transaction.transaction_type in {"customer_credit", "customer_payment"} and not transaction.customer:
@@ -1461,6 +1752,23 @@ def _review_warnings(transaction: Transaction, db_path: str | Path | None) -> li
     return warnings
 
 
+def _review_readiness(transaction: Transaction, warnings: list[str]) -> str:
+    """Return the primary trust cue for a parsed transaction."""
+    blocking_warnings = {"Unknown type", "Missing item", "Missing amount", "Missing customer", "Inventory would go negative"}
+    if transaction.transaction_type == "inventory_purchase" and transaction.quantity is not None:
+        blocking_warnings.discard("Missing amount")
+    if any(warning in blocking_warnings for warning in warnings):
+        return '<span class="vl-warning-badge vl-warning-strong">Needs review</span>'
+    return '<span class="vl-success-badge">Safe to save</span>'
+
+
+def _warning_badge_class(warning: str) -> str:
+    """Return a severity-aware warning badge class."""
+    if warning in {"Inventory would go negative", "Possible duplicate"}:
+        return "vl-warning-badge vl-warning-strong"
+    return "vl-warning-badge"
+
+
 def _would_make_stock_negative(transaction: Transaction, db_path: str | Path | None) -> bool:
     """Return whether saving this sale would take inventory below zero."""
     if transaction.transaction_type != "sale" or not transaction.item or transaction.quantity is None:
@@ -1532,6 +1840,7 @@ def _status_message(
 ) -> str:
     """Return a human-readable parsing status."""
     parts = []
+    parts.append(_source_chip(source_message, fallback_reason))
     if prefix:
         parts.append(prefix)
     parts.append(source_message)
@@ -1547,6 +1856,15 @@ def _status_message(
     return " ".join(parts)
 
 
+def _source_chip(source_message: str, fallback_reason: str | None = None) -> str:
+    """Return a visual parse-source chip for Markdown/HTML status output."""
+    if fallback_reason or "local" in source_message.lower() or "fallback" in source_message.lower():
+        return '<span class="vl-status-chip vl-status-chip-fallback">Local fallback</span>'
+    if "modal" in source_message.lower() or "nemotron" in source_message.lower():
+        return '<span class="vl-status-chip vl-status-chip-cloud">Cloud AI</span>'
+    return '<span class="vl-status-chip">Parsed</span>'
+
+
 def _transcription_status(result: modal_api.TranscriptionResult) -> str:
     """Return a concise transcription source status."""
     status = result.message

voiceledger/ui/theme.py

@@ -315,7 +315,9 @@ body,
 .vl-detail-card,
 .vl-closeout-card,
 .vl-pipeline-strip,
-.vl-small-model-card {
+.vl-small-model-card,
+.vl-command-center,
+.vl-seller-timeline {
   background: #ffffff !important;
   border: 1px solid var(--vl-border) !important;
   border-radius: 14px !important;
@@ -330,7 +332,9 @@ body,
 .vl-detail-card *,
 .vl-closeout-card *,
 .vl-pipeline-strip *,
-.vl-small-model-card * {
+.vl-small-model-card *,
+.vl-command-center *,
+.vl-seller-timeline * {
   color: var(--vl-text) !important;
   opacity: 1 !important;
 }
@@ -341,7 +345,9 @@ body,
 .vl-detail-card h2,
 .vl-closeout-card h2,
 .vl-pipeline-strip h2,
-.vl-small-model-card h2 {
+.vl-small-model-card h2,
+.vl-command-center h2,
+.vl-seller-timeline h2 {
   font-size: 18px !important;
   font-weight: 800 !important;
   margin: 0 0 10px !important;
@@ -350,7 +356,8 @@ body,
 .vl-today-panel div,
 .vl-review-grid,
 .vl-closeout-grid,
-.vl-small-model-card div {
+.vl-small-model-card div,
+.vl-command-center div {
   display: grid !important;
   gap: 10px !important;
   grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)) !important;
@@ -359,7 +366,8 @@ body,
 .vl-today-panel span,
 .vl-review-grid div,
 .vl-closeout-grid span,
-.vl-small-model-card span {
+.vl-small-model-card span,
+.vl-command-center span {
   background: #f6f7f2 !important;
   border: 1px solid var(--vl-border) !important;
   border-radius: 10px !important;
@@ -370,7 +378,8 @@ body,
 .vl-today-panel strong,
 .vl-review-grid span,
 .vl-closeout-grid strong,
-.vl-small-model-card strong {
+.vl-small-model-card strong,
+.vl-command-center strong {
   color: #475247 !important;
   display: block !important;
   font-size: 12px !important;
@@ -418,6 +427,12 @@ body,
   color: #5f370e !important;
 }
 
+.vl-warning-strong {
+  background: #f8d7da !important;
+  border-color: #d98b91 !important;
+  color: #651922 !important;
+}
+
 .vl-success-badge {
   background: #e7f6ed !important;
   border: 1px solid #9bd2ad !important;
@@ -472,6 +487,58 @@ body,
   margin-top: 4px !important;
 }
 
+.vl-seller-timeline ol {
+  display: grid !important;
+  gap: 8px !important;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)) !important;
+  list-style: none !important;
+  margin: 0 !important;
+  padding: 0 !important;
+}
+
+.vl-seller-timeline li {
+  background: #f6f7f2 !important;
+  border: 1px solid var(--vl-border) !important;
+  border-left: 5px solid #4aa357 !important;
+  border-radius: 10px !important;
+  padding: 10px !important;
+}
+
+.vl-seller-timeline li strong,
+.vl-seller-timeline li span {
+  display: block !important;
+}
+
+.vl-seller-timeline li span {
+  color: #475247 !important;
+  font-size: 13px !important;
+  margin-top: 4px !important;
+}
+
+.vl-status-chip {
+  background: #eef6ed !important;
+  border: 1px solid #b9d4b4 !important;
+  border-radius: 999px !important;
+  color: #183525 !important;
+  display: inline-block !important;
+  font-size: 12px !important;
+  font-weight: 900 !important;
+  margin-right: 6px !important;
+  padding: 4px 9px !important;
+}
+
+.vl-status-chip-cloud {
+  background: #e8f0ff !important;
+  border-color: #9eb8eb !important;
+  color: #173c73 !important;
+}
+
+.vl-status-chip-fallback {
+  background: #fff3cd !important;
+  border-color: #e3bc5b !important;
+  color: #5f370e !important;
+}
+
 .vl-chip {
   background: #2c2926 !important;
   border-radius: 6px !important;