sandbox-notebookllamalm/SIMPLIFIED_PLAN.md

NotebookLlaMa - Simplified Plan (NotebookLM Style)

🎯 Core Concept

Notebook-First Approach:

• Notebooks are the PRIMARY unit (not documents)
• Documents only exist WITHIN notebooks
• All actions happen at the notebook level
• Users work with notebooks, not individual files

---

📱 User Flow

1. Login/Signup

User visits app → Login/Signup → Dashboard

2. Create Notebook

Dashboard → "Create Notebook" button
  ↓
Enter name: "Q4 Marketing Analysis"
Enter description: "All marketing reports for Q4 2024"
  ↓
Click "Create" → Notebook created

3. Upload Documents

Notebook Detail page → "Upload Documents" button
  ↓
Select multiple PDFs (1-20 files)
  ↓
Upload all at once
  ↓
System processes each document (summaries, Q&A, highlights)
  ↓
All saved to notebook

4. View Notebook

Notebook Detail page shows:
- Notebook name & description
- List of all documents
- Combined summary (from all docs)
- Key highlights (from all docs)
- Q&A section (from all docs)
- Actions: Chat, Generate Podcast, Share, Add More Docs

5. Chat with Notebook

Click "Chat" → Opens chat interface
  ↓
Ask: "What are the main marketing trends?"
  ↓
AI searches ACROSS ALL documents in notebook
  ↓
Response shows:
  - Answer
  - Sources: "From: Marketing_Report_Q4.pdf, Budget_2024.pdf"

6. Generate Podcast

Notebook Detail → "Generate Podcast" button
  ↓
System combines summaries from all documents
  ↓
Creates 10-15 minute audio conversation
  ↓
Podcast saved to notebook
  ↓
Listen/download

7. Share Notebook

Notebook Detail → "Share" button
  ↓
Enter email: colleague@company.com
  ↓
Select permission: Read / Write
  ↓
Click "Share"
  ↓
Colleague gets access to entire notebook
  (all docs, summaries, chat history, podcast)

---

🏗️ Page Structure

1. Dashboard (Home)

• Welcome message
• Grid of user's notebooks (cards with thumbnails)
• "Create New Notebook" button (primary)
• Quick stats: X notebooks, Y documents total

2. My Notebooks (Current page 6)

• List all notebooks
• For each notebook show:
  • Name
  • Description
  • Document count
  • Created date
  • Last updated
  • Actions: View, Chat, Edit, Delete

3. Create Notebook (Modal or new page)

• Form:
  • Notebook Name* (required)
  • Description (optional)
  • Upload documents now? (checkbox)
• If "upload now" checked → show multi-file uploader
• Click "Create" → Creates notebook + processes docs

4. Notebook Detail (NEW - Most important page!)

[Notebook Name]
[Description]
[Edit] [Share] [Delete]

📄 Documents (3):
  • Marketing_Report_Q4.pdf (245 KB) - Processed ✓
  • Budget_Analysis_2024.pdf (512 KB) - Processed ✓
  • Competitor_Research.pdf (1.2 MB) - Processing...

[Upload More Documents]

---

## Summary
[Combined summary from all documents]

## Key Highlights
• Bullet point 1 (from doc 1)
• Bullet point 2 (from doc 2)
• ...

## Q&A
**Q: What is the main focus?**
A: [Answer citing multiple docs]

---

[💬 Chat with Notebook] [🎙️ Generate Podcast]

🎙️ Podcast: Ready! [▶️ Play] [⬇️ Download]

5. Notebook Chat (Enhanced page 2)

Chatting with: [Q4 Marketing Analysis]
3 documents

Chat interface with history
Each response shows: "Sources: doc1.pdf, doc2.pdf"

6. Shared Notebooks (NEW)

• List notebooks shared WITH you
• Same view as "My Notebooks" but show owner
• Can view, chat (based on permissions)

7. Settings/Profile (Optional)

• User info
• Change password
• Delete account

---

🗄️ Database Changes (Already Done!)

✅ notebooks table - collections ✅ notebook_documents - links docs to notebooks ✅ document_summaries - per-document analysis ✅ chat_sessions - has notebook_id ✅ CASCADE deletes fixed

---

🔨 Implementation Order

Phase 1: Core Notebook Flow (P0 - Do First!)

1. ✅ Fix database schema (done!)
2. 📝 Update "Create Notebook" to allow immediate upload
3. 📝 Create comprehensive Notebook Detail page
4. 📝 Multi-document upload with progress bars
5. 📝 Process and save ALL documents properly

Phase 2: Multi-Document Intelligence (P1)

6. 📝 Notebook-level chat (query all docs)
7. 📝 Source attribution in responses
8. 📝 Combined summary generation
9. 📝 Aggregate highlights and Q&A

Phase 3: Sharing & Collaboration (P1)

10. 📝 Share notebook with users
11. 📝 Shared Notebooks view
12. 📝 Permission levels (read/write)

Phase 4: Podcast & Polish (P2)

13. 📝 Podcast generation from notebook
14. 📝 Audio player
15. 📝 Download podcast

Phase 5: Cleanup (P2)

16. 📝 Remove "My Documents" page
17. 📝 Remove standalone "Process Document" page
18. 📝 Update navigation
19. 📝 Polish UI/UX

---

🎨 Key Differences from Current System

OLD (Document-First):

Upload Doc → Process → View Doc → Maybe add to notebook → Chat with doc

NEW (Notebook-First):

Create Notebook → Upload Docs → Process All → Chat with Notebook → Share Notebook

What Changes:

• ❌ No more standalone documents
• ❌ No more "My Documents" page
• ❌ No more individual document chat
• ✅ Everything starts with creating a notebook
• ✅ Documents are PART OF a notebook
• ✅ Chat queries ALL documents in notebook
• ✅ Share entire notebooks, not documents

---

💡 Quick Wins (Do These First!)

1. Enhanced "Create Notebook" Flow

Add multi-file uploader right in the create form:

if st.button("Create Notebook"):
    notebook = create_notebook(name, description)
    if uploaded_files:
        for file in uploaded_files:
            upload_to_notebook(notebook.id, file)

2. Notebook Detail Page

Show everything about the notebook in one place:

• Documents
• Summaries
• Chat button
• Podcast button
• Share button

3. Fix Processing

Make sure summaries actually save (MCP crash fix)

---

🚀 Success Metrics

User should be able to:

1. ✅ Create a notebook in 10 seconds
2. ✅ Upload 5 PDFs at once
3. ✅ See processing progress
4. ✅ Chat across all documents
5. ✅ Know which doc each answer came from
6. ✅ Generate a podcast in 2 minutes
7. ✅ Share notebook with colleague
8. ✅ Colleague can access everything

---

📝 Example Use Case

Scenario: Product manager preparing for Q4 review

1. Create notebook → "Q4 Product Review"
2. Upload docs →
   • Product_Roadmap_Q4.pdf
   • Customer_Feedback_Report.pdf
   • Sales_Numbers_Q4.pdf
   • Competitor_Analysis.pdf
3. Wait 2 minutes → All processed
4. View notebook → See combined insights
5. Chat → "What were our biggest wins?"
   • AI: "Based on all 4 documents: ..."
6. Generate podcast → 12-minute discussion
7. Share → Send to exec team
8. Exec opens → Sees everything, can chat too

---

🎯 Next Steps

1. Start with "Create Notebook" enhancement
2. Build comprehensive Notebook Detail page
3. Implement multi-doc upload
4. Fix MCP crash so summaries save
5. Build notebook-level chat
6. Add podcast generation
7. Add sharing
8. Remove old pages
9. Polish & test

This is the vision! Let's make it happen! 🦙