# Interactive Tutorials

Welcome to SocialSeed-E2E Interactive Tutorials! 🚀

This directory contains comprehensive, interactive learning materials to help you master the framework.

## 📚 What's Available

### 📝 Jupyter Notebooks
Interactive Python notebooks you can run and modify:

1. **[01-getting-started.ipynb](./notebooks/01-getting-started.ipynb)** - Your first steps
2. **[02-ai-test-generation.ipynb](./notebooks/02-ai-test-generation.ipynb)** - AI-powered testing
3. **03-running-tests.ipynb** - Execute and analyze tests *(Coming soon)*
4. **04-advanced-features.ipynb** - Advanced capabilities *(Coming soon)*

**How to use:**
```bash
# Install Jupyter
pip install jupyter

# Launch notebook server
jupyter notebook docs/tutorials/notebooks/
```

### 📖 Step-by-Step Guides
Detailed written guides with interactive elements:

- **[Guide 1: Installation](./guides/guide-01-installation.md)** - Get up and running
- **[Guide 2: First Project](./guides/guide-02-first-project.md)** - Create your first tests *(Coming soon)*
- **[Guide 3: Generate Tests](./guides/guide-03-generate-tests.md)** - AI test generation *(Coming soon)*
- **[Guide 4: Run Tests](./guides/guide-04-run-tests.md)** - Test execution *(Coming soon)*
- **[All Guides](./guides/README.md)** - Complete list

### 🔍 API Explorer
Interactive API documentation:

- **[API Explorer](./api-explorer.md)** - Browse and search all APIs
- **[Quick Reference](./quick-reference.md)** - Common operations *(Coming soon)*

### 💻 Live Examples
Runnable code examples:

- **[Hello World](./examples/README.md#example-1-hello-world-test)** - Basic test
- **[Authentication Flow](./examples/README.md#example-2-api-authentication-flow)** - Login/logout
- **[CRUD Operations](./examples/README.md#example-3-crud-operations)** - Full CRUD
- **[AI Examples](./examples/README.md#-ai-powered-examples)** - AI features
- **[All Examples](./examples/README.md)** - Complete list

### 🎮 Interactive Playground
Try code directly in your browser *(Coming soon)*:

```
./playground/
├── python-repl.html      - Interactive Python console
├── code-editor.html      - Full code editor
└── examples-runner.html  - Run examples
```

---

## 🎯 Learning Paths

### 🌱 Beginner
New to E2E testing? Start here:

1. 📚 Read [Installation Guide](./guides/guide-01-installation.md)
2. 📝 Run [Getting Started Notebook](./notebooks/01-getting-started.ipynb)
3. 💻 Try [Hello World Example](./examples/README.md)
4. 📖 Complete [First Project Guide](./guides/guide-02-first-project.md)

**Time:** ~2 hours | **Outcome:** You'll have your first working tests

### 🚀 Intermediate
Ready for more? Try these:

1. 📝 [AI Test Generation Notebook](./notebooks/02-ai-test-generation.ipynb)
2. 📖 [AI Manifest Guide](./guides/guide-05-ai-manifest.md)
3. 💻 [Authentication Flow Example](./examples/README.md#example-2-api-authentication-flow)
4. 📖 [Deep Context Guide](./guides/guide-06-deep-context.md)

**Time:** ~4 hours | **Outcome:** You'll master AI-powered testing

### 🏆 Advanced
For experienced users:

1. 📝 [Advanced Features Notebook](./notebooks/04-advanced-features.ipynb) *(Coming soon)*
2. 📖 [Security Testing Guide](./guides/guide-10-security.md)
3. 💻 [Parallel Execution Example](./examples/README.md#example-6-parallel-test-execution)
4. 📖 [CI/CD Integration Guide](./guides/guide-12-cicd.md)

**Time:** ~6 hours | **Outcome:** You'll build production-ready test suites

---

## 🎓 Tutorial Videos

### Video Series: Getting Started

#### Video 1: Introduction (5 min)
[![Video 1](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Overview of SocialSeed-E2E and what you'll learn.

#### Video 2: Installation (8 min)
[![Video 2](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Step-by-step installation and setup.

#### Video 3: First Test Project (15 min)
[![Video 3](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Create and run your first E2E tests.

### Video Series: AI Features

#### Video 4: AI Manifest Generation (20 min)
[![Video 4](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Let AI understand your codebase.

#### Video 5: Business Logic Detection (18 min)
[![Video 5](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Automatically detect workflows and relationships.

#### Video 6: AI Protocol (25 min)
[![Video 6](https://img.youtube.com/vi/placeholder/0.jpg)](https://www.youtube.com/watch?v=placeholder)

Communicate with AI agents using standardized protocol.

**📺 [View All Videos](./videos/README.md)**

---

## 🛠️ Interactive Features

### Code Playground
Try code without installing anything:

```python
# Click "Run" to execute
from socialseed_e2e import __version__
print(f"Version: {__version__}")
```

[🎮 Open Playground](./playground)

### Live API Testing
Test APIs directly from the documentation:

```
Endpoint: GET /api/users
Base URL: [https://api.example.com__________]

Headers:
Content-Type: application/json
Authorization: Bearer [token________________]

[Send Request]

Response:
{
  "status": 200,
  "data": [...]
}
```

[🔍 Open API Explorer](./api-explorer.md)

---

## 📊 Progress Tracking

Track your learning progress:

```
Your Progress:
[████████░░░░░░░░░░░░] 40% Complete

Completed:
☑ Installation Guide
☑ Getting Started Notebook
☑ Hello World Example
☐ AI Test Generation
☐ Deep Context Analysis
☐ Advanced Features

Achievements:
🏆 First Test Created
🏆 AI Manifest Generated
🏆 10 Tests Passed
```

---

## 💡 Tips for Learning

### 1. Practice Along
Don't just read—type the code yourself!

### 2. Experiment
Modify examples to see what happens.

### 3. Ask Questions
Stuck? Check the [FAQ](../faq.md) or [ask on GitHub](https://github.com/daironpf/socialseed-e2e/discussions).

### 4. Build Projects
Apply what you learn to real projects.

### 5. Share Knowledge
Help others in the community.

---

## 📚 Additional Resources

- 📖 [Full Documentation](../README.md)
- 🔍 [API Reference](../api-reference.md)
- 💬 [Community Forum](https://github.com/daironpf/socialseed-e2e/discussions)
- 🐛 [Issue Tracker](https://github.com/daironpf/socialseed-e2e/issues)
- 📝 [Blog](https://blog.example.com)

---

## 🎯 Quick Start

**New here?** Start with these in order:

1. [Installation Guide](./guides/guide-01-installation.md) (5 min)
2. [Getting Started Notebook](./notebooks/01-getting-started.ipynb) (30 min)
3. [Hello World Example](./examples/README.md) (15 min)

**Total time:** ~50 minutes

---

Happy Learning! 🚀

*Have feedback? [Let us know](https://github.com/daironpf/socialseed-e2e/issues)!*
