Update app.py

app.py

@@ -292,23 +292,23 @@ with gr.Blocks(css=css, theme=gr.themes.Soft(), title="Bullish Minds AI - Stock
             chart_output = gr.HTML(get_tradingview_embed("AAPL"))
         with gr.TabItem("🎓 Lessons"):
             with gr.Tabs():
-                with gr.TabItem("Lesson 1: Exchanges & Order Book"):
-                    gr.Markdown(
-"""### Lesson 1 — Market Venues: Exchanges, Dark Pools, Auction vs. Dealer Markets
-Level: Beginner • Estimated time: 25–35 minutes • Disclaimer: Educational only. Not financial advice.
-
-#### Why this matters
+                with gr.TabItem("Lesson 1: Market Venues Explained"):
+                    gr.Markdown("## Lesson 1 — Market Venues: Exchanges, Dark Pools, Auction vs. Dealer Markets")
+                    with gr.Accordion("Why this matters", open=True):
+                        gr.Markdown("""
 Before you place any trade, it helps to know where your order goes and who it interacts with. Understanding market venues explains why a fill is fast or slow, why prices “jump,” and why a limit order protects you.
-
-#### Learning objectives
+""")
+                    with gr.Accordion("Learning objectives", open=False):
+                        gr.Markdown("""
 By the end of this lesson, you will be able to:
 - Define exchanges, dark pools (ATS), auction markets, and dealer markets.
 - Explain how orders interact on a central limit order book versus with a dealer/market maker.
 - Describe what happens during opening/closing auctions and why they matter.
 - List pros/cons of lit exchanges and dark pools for typical retail traders.
 - Choose a suitable order type (market vs. limit) based on venue dynamics.
-
-#### Key terms (quick definitions)
+""")
+                    with gr.Accordion("Key terms (quick definitions)", open=False):
+                        gr.Markdown("""
 - **Exchange (lit venue):** A registered marketplace where bids/offers are displayed ("lit") and orders match by rules (e.g., price–time priority).
 - **Central Limit Order Book (CLOB):** The public queue of buy/sell limit orders at each price.
 - **NBBO:** National Best Bid and Offer; the best quoted prices across exchanges (US concept).
@@ -318,14 +318,148 @@ By the end of this lesson, you will be able to:
 - **Dark pool / ATS:** Alternative Trading System where quotes are not displayed; orders often execute at or within NBBO.
 - **Price improvement:** Getting a better price than the displayed NBBO.
 - **Slippage:** Getting a worse execution price than expected due to fast moves or thin liquidity.
+""")
+                    with gr.Accordion("1) Big picture: Where can your order go?", open=False):
+                        gr.Markdown("""
+Your broker’s smart order router can send your order to:
+- Lit exchanges (NYSE, Nasdaq, Cboe, IEX, etc.) — orders join the public book.
+- Wholesalers/internalizers (dealer firms handling retail flow) — they fill against their inventory/quotes.
+- Dark pools (ATS) — non‑displayed venues where orders may match at midpoint or within the spread.
 
-#### [Full lesson continues...]
-[...scroll for more: Big picture, scenarios, review, glossary ...]
+You  →  Broker/Router  →  { Lit Exchange  |  Wholesaler/Dealer  |  Dark Pool }
 
-""" + """
----
-###### *Try the tools below to visualize order book mechanics and slippage:*
+Each path has trade‑offs in speed, price improvement, and transparency.
+""")
+                    with gr.Accordion("2) Exchanges (lit venues)", open=False):
+                        gr.Markdown("""
+What they are: Regulated marketplaces that publish quotes and trades. Orders line up on a public order book.
+
+How matching works (simplified):
+- Price–time priority: Best price first; earlier orders at the same price are ahead in the queue.
+- Market orders cross the spread to fill immediately; limit orders wait in the book until hit/lifted.
+
+**Auctions on exchanges:**
+- Opening auction sets the first regular‑hours price by crossing all eligible orders at a single price.
+- Closing auction sets the official closing price, often with large institutional volume.
+- Benefits: concentrated liquidity, reduced slippage at the cross; transparent reference prices.
+
+**Examples (conceptual):**
+- NYSE is a hybrid: electronic CLOB plus designated market makers (DMMs) overseeing auctions.
+- Nasdaq uses multiple market makers and an electronic book; it also runs opening/closing crosses.
+
+**Pros for retail:**
+- Transparent quotes (you can see the book’s top levels via Level I/II).
+- Strong price discovery; reference prices (open/close) are widely used.
+
+**Cons:**
+- Quoted spreads can widen during news or at the open; fills may be partial if your limit is too tight.
+""")
+                    with gr.Accordion("3) Dark pools (ATS)", open=False):
+                        gr.Markdown("""
+What they are: Electronic venues where orders are not displayed. Often match at midpoint (between bid and ask) or within the spread.
+
+Why they exist:
+- Reduce market impact for larger orders (institutions don’t reveal hand).
+- Offer potential price improvement vs. the displayed NBBO.
+
+How they work (simplified):
+- Orders reference the NBBO from lit exchanges but do not show size/price publicly.
+- Your order may match passively (you rest and wait) or actively (you interact with liquidity inside).
+
+**Pros:**
+- Possible price improvement; lower signaling.
+
+**Cons:**
+- Less transparency; potential adverse selection (you trade when price is about to move against you).
+- Limited size for thin names; not all orders get matched quickly.
+
+**Myth buster:** “Dark” ≠ illegal. These are regulated ATS venues; they’re simply non‑displayed.
+""")
+                    with gr.Accordion("4) Auction vs. Dealer markets (and today’s hybrid reality)", open=False):
+                        gr.Markdown("""
+Auction market (concept):
+- Price emerges from buyers and sellers competing on a book (continuous double auction).
+- Open/close auctions are batch auctions that cross many orders at one price.
+
+Dealer market (concept):
+- Dealers/market makers post bid/ask and stand ready to trade from their inventory.
+- Execution is against the dealer’s quote; multiple dealers may compete.
+
+Hybrid reality:
+- Modern US equities combine both: electronic order books and market makers. Nasdaq is dealer‑heavy with an order book; NYSE is auction‑centric with DMMs.
+
+Why you care:
+- In dealer interactions, you may see price improvement and fast fills; on auctions/books, you can seek transparent price with tighter control via limits.
+""")
+                    with gr.Accordion("5) Routing, best execution, and your order type", open=False):
+                        gr.Markdown("""
+Brokers must seek best execution (price, speed, likelihood of fill, etc.).
+
+- Market orders aim for immediate fill but can be exposed to slippage in fast moves.
+- Limit orders set a maximum buy or minimum sell price, protecting you from surprise fills.
+
+For thin or volatile names, prefer limits; around the open/close, consider participating in auctions or waiting a few minutes for spreads to normalize.
+""")
+                    with gr.Accordion("6) Practical tips (beginner‑friendly)", open=False):
+                        gr.Markdown("""
+- Use limit orders by default for single‑name stocks, especially at the open.
+- If placing larger orders, consider slicing (several smaller limits) to reduce impact.
+- Avoid chasing during halts/news spikes; liquidity can vanish and spreads widen.
+- For end‑of‑day execution, the closing auction can offer fair, liquid prices.
+""")
+                    with gr.Accordion("7) Mini‑scenarios (choose one answer)", open=False):
+                        gr.Markdown("""
+You want 200 shares, the spread is wide, and the stock is jumping around. Best choice?
+A) Market buy now
+B) Place a limit buy near the mid or a level you’re happy with
+
+You need the official benchmark price for a fund’s daily report. Which event?
+A) Closing auction
+B) First midpoint fill you see
+
+Which venue hides quotes but can provide price improvement?
+A) Lit exchange
+B) Dark pool (ATS)
+
+In which model do market makers quote and trade against you from inventory?
+A) Auction market
+B) Dealer market
+
+You dislike surprises in fast markets. Which order type reduces risk of a bad fill?
+A) Market order
+B) Limit order
+""")
+                    with gr.Accordion("8) Review checklist", open=False):
+                        gr.Markdown("""
+I can explain the difference between lit exchanges and dark pools.
+I know what NBBO means and why it matters.
+I understand auction vs. dealer markets and today’s hybrid reality.
+I can choose between market and limit orders based on conditions.
+I know when opening/closing auctions might be useful.
+""")
+                    with gr.Accordion("9) App‑integration hooks", open=False):
+                        gr.Markdown("""
+Interactive: Order Book Simulator (queue position, partial fills); Auction Replay (open/close cross).
+Calculator: Slippage estimator (expected fill vs. NBBO); Limit‑vs‑Market decision helper.
+Checklist widget: “Before you submit an order” (spread, volatility, venue notes).
+Glossary popovers: NBBO, CLOB, dealer, DMM, adverse selection.
+""")
+                    with gr.Accordion("10) Glossary (recap)", open=False):
+                        gr.Markdown("""
+CLOB: Central public queue of limit orders on an exchange.
+Dealer/MM: Firm quoting bid/ask and trading from inventory.
+Auction: Batch or continuous matching based on order interaction.
+Dark pool/ATS: Non‑displayed matching venue, often at NBBO/midpoint.
+NBBO: Best national bid and offer across exchanges.
+Price improvement: Better execution than the displayed best price.
+Slippage: Fill worse than expected due to movement/liquidity.
 """)
+                    with gr.Accordion("11) What’s next", open=False):
+                        gr.Markdown("""
+Proceed to Lesson 2: Order Types Deep Dive (market, limit, stop, stop‑limit, trailing, OCO), then Lesson 3: Reading the Tape (Level I/II, Time & Sales).
+""")
+                    gr.Markdown("---")
+                    gr.Markdown("*Try the tools below to visualize order book mechanics and slippage:*")
                     with gr.Tabs():
                         with gr.TabItem("Order Book Simulator"):
                             lesson1_order = gr.Interface(
@@ -335,11 +469,11 @@ By the end of this lesson, you will be able to:
                                     gr.Dropdown(["Market", "Limit"], label="Order Type"),
                                     gr.Number(value=100.00, label="Order Price (for limit)"),
                                     gr.Slider(1, 100, value=10, step=1, label="Order Size"),
-                                    gr.Number(value=123, label="Seed (optional, for replay)"),
+                                    gr.Number(value=123, label="Seed (optional, for replay)")
                                 ],
                                 outputs=[
                                     gr.Dataframe(label="Order Book (randomized)"),
-                                    gr.Textbox(label="Result / Fill Message"),
+                                    gr.Textbox(label="Result / Fill Message")
                                 ],
                                 live=False,
                                 allow_flagging="never"
@@ -350,16 +484,131 @@ By the end of this lesson, you will be able to:
                                 inputs=[
                                     gr.Dropdown(["Buy", "Sell"], label="Order Side"),
                                     gr.Slider(1, 300, value=50, step=1, label="Order Size"),
-                                    gr.Number(value=123, label="Seed (for repeatability)"),
+                                    gr.Number(value=123, label="Seed (for repeatability)")
                                 ],
                                 outputs=[
                                     gr.Textbox(label="Estimate"),
-                                    gr.Dataframe(label="Fill breakdown"),
+                                    gr.Dataframe(label="Fill breakdown")
                                 ],
                                 live=False,
                                 allow_flagging="never"
                             )
-                # Add more lessons here as needed
+                with gr.TabItem("Lesson 2: Tickers, Floats, Market Cap, Sectors, Indices"):
+                    gr.Markdown("## Lesson 2 — Tickers, Floats, Market Cap, Sectors, Indices")
+                    with gr.Accordion("Overview", open=True):
+                        gr.Markdown("""
+This lesson explains what stock tickers are, how share float affects trading, how to compute and interpret market capitalization, how sectors organize the market, and how indices track groups of companies. Simple formulas and examples are included for day-to-day use.
+""")
+                    with gr.Accordion("Tickers", open=False):
+                        gr.Markdown("""
+A **ticker** is the short symbol used to identify a publicly traded company on an exchange (e.g. `AAPL` for Apple). Each exchange manages unique symbols, and finance apps use tickers to retrieve data.  
+Tickers link directly to price, news, filings, and company fundamentals.
+
+**Quick checks:**  
+- Confirm the exchange if companies share similar symbols (e.g., US vs. international).  
+- Use the ticker consistently in screeners, EDGAR filings, and news searches.
+""")
+                    with gr.Accordion("Float (Floating Shares)", open=False):
+                        gr.Markdown(r"""
+**Definition:**  
+Float = Shares Outstanding − Restricted or Insider Shares
+
+Low float means fewer shares actively trade, which boosts volatility. High float dampens price swings.
+
+**Why float matters:**  
+- **Liquidity:** Higher float usually narrows the bid-ask spread; low float can cause sharp jumps.
+- **Corporate actions:** Buybacks, splits, and insider sales alter float and trading dynamics.
+
+**Example:**  
+Company has 20M outstanding shares, 5M are insider-restricted.  
+Float = 20M − 5M = **15M** shares.
+""")
+                    with gr.Accordion("Market Capitalization", open=False):
+                        gr.Markdown(r"""
+**Definition:**  
+Market Cap = Share Price × Shares Outstanding
+
+Market cap reflects the total equity value of a company.
+
+**Size buckets:**  
+- Micro-cap: < $250M  
+- Small-cap: $250M – $2B  
+- Mid-cap: $2B – $10B  
+- Large-cap: $10B – $200B  
+- Mega-cap: > $200B  
+(Cutoffs may vary).
+
+**Example:**  
+Company trades at $20 with 5M shares outstanding.  
+Market cap = $20 × 5,000,000 = **$100M** (small-cap).
+""")
+                    with gr.Accordion("Sectors", open=False):
+                        gr.Markdown("""
+**Sectors** are broad industry groups (e.g., Information Technology, Health Care, Financials) used by analysts and index providers.  
+Grouping by sector makes it easier to benchmark companies and build portfolios.
+
+**Tips:**  
+- Analyze peers within the same sector for meaningful comparisons.
+- Sector rotation strategies try to overweight sectors based on macro trends.
+""")
+                    with gr.Accordion("Indices", open=False):
+                        gr.Markdown("""
+An **index** tracks the performance of a basket of stocks (e.g., S&P 500, Dow Jones, Nasdaq-100, Russell 2000).
+
+**Weighting methods:**  
+- **Market-cap-weighted:** Larger companies have more influence.
+- **Equal-weighted:** All companies have the same weight.
+- **Price-weighted:** High-priced stocks move the index more.
+
+**Why indices matter:**  
+- **Benchmarks:** Used to compare portfolio returns.
+- **Access:** Index funds/ETFs enable diversified investing.
+""")
+                    with gr.Accordion("Putting It Together", open=False):
+                        gr.Markdown("""
+- **Ticker →** the unique handle that links all research and trading data.
+- **Float →** governs real trading volume, volatility, and liquidity.
+- **Market Cap →** frames company size, growth, and risk.
+- **Sectors →** context for analyzing peers and market cycles.
+- **Indices →** anchor performance and guide diversified investing.
+""")
+                    with gr.Accordion("Mini-Formulas and Examples", open=False):
+                        gr.Markdown(r"""
+**Float:**  
+\( \text{Float} = \text{Outstanding} - \text{Restricted} \)  
+Example: \( 10M - 3M = 7M \) tradable shares.
+
+**Market Cap:**  
+\( \text{Cap} = P \times N \)  
+Example: \( \$50 \times 5,000,000 = \$250M \) (micro/small-cap).
+
+**Index weight (market-cap):**  
+\( \text{Weight} = \frac{\text{Company Cap}}{\text{Index Cap}} \)
+""")
+                    with gr.Accordion("Red Flags and Pro Tips", open=False):
+                        gr.Markdown("""
+- Low float stocks can swing wildly on news or social buzz—use limit orders!
+- Don’t compare companies on share price alone—market cap tells true size.
+- Match your benchmark index’s strategy and market cap to your investment style.
+""")
+                    with gr.Accordion("Quick Quiz", open=False):
+                        gr.Markdown("""
+**Q:** Company has 50M shares outstanding; 15M are restricted. What’s the float?  
+**A:** 35M
+
+**Q:** Share price is $25; outstanding shares are 80M. Market cap?  
+**A:** $25 × 80M = $2B (mid-cap)
+
+**Q:** Why might two companies with the same share price be different sizes?  
+**A:** Because number of outstanding shares differs—changing market cap.
+
+**Q:** Name a reason sector classification is useful.  
+**A:** Peer comparison, sector ETFs.
+
+**Q:** In a market-cap-weighted index, what do bigger companies mean?  
+**A:** They carry more weight—move the index more.
+""")
+                # Add future lessons here as new gr.TabItem("Lesson X: ...")
 
     gr.Markdown("""
 ---