This repository contains a Mini Tasks application designed to test and showcase Bob's capabilities as an AI coding assistant. Bob from IBM is your AI software development partner that understands your intent, repo, and security standards.
More details about Bob : https://www.ibm.com/products/bob
This repo demonstrates Bob's ability to:
- 🔍 Analyze code architecture and explain complex systems
- 🐛 Find and fix bugs in existing codebases
- ♻️ Refactor code following best practices
- 🚀 Run applications locally with proper setup
- 🎨 Create modern UIs from scratch
- 📚 Generate comprehensive documentation
Bob_mini-tasks/
├── Initial_Code/ # 🔴 BEFORE - Buggy code to test Bob
│ ├── README.md # Documentation of all bugs
│ └── backend_main.py # Example of problematic code
│
├── Result_After_Bob/ # ✅ AFTER - Bob's refactored solution
│ ├── backend/ # Production-ready FastAPI backend
│ ├── frontend/ # Modern React UI
│ └── README.md # Complete documentation
│
└── README.md # This file
Prompt: "Explain the architecture of this project"
Expected: Bob should analyze and explain:
- Backend structure (FastAPI, SQLAlchemy, async operations)
- Frontend architecture (React, Vite)
- Database layer and ORM patterns
- API endpoints and routing
- Clean architecture principles
Prompt: "Find all bugs or bad practices in this project"
Expected: Bob should identify:
- ✅ 20+ bugs and issues (see
Initial_Code/README.md) - Database session leaks
- Dangerous
autocommit=Trueconfiguration - Missing error handling
- CORS issues
- Frontend API mismatches
- And provide fixes for each
Prompt: "Refactor the backend to follow best practices"
Expected: Bob should:
- ✅ Convert to fully async operations
- ✅ Implement dependency injection
- ✅ Add Pydantic validation models
- ✅ Fix all critical bugs
- ✅ Add proper error handling
- ✅ Implement clean architecture
Prompt: "Run the code locally"
Expected: Bob should:
- ✅ Install dependencies (pip, npm)
- ✅ Configure environment
- ✅ Start backend server
- ✅ Start frontend dev server
- ✅ Verify both are running correctly
Prompt: "Create a Web UI to use the app"
Expected: Bob should:
- ✅ Build a modern React interface
- ✅ Implement all CRUD operations
- ✅ Add error handling and loading states
- ✅ Create responsive, beautiful design
- ✅ Connect to backend API
Prompt: "Document this project"
Expected: Bob should create:
- ✅ Comprehensive README files
- ✅ API documentation
- ✅ Setup instructions
- ✅ Architecture diagrams
- ✅ Code comments
- Identified 20+ bugs and bad practices
- Explained architecture in detail
- Provided comprehensive code review
- Converted to fully async operations
- Implemented dependency injection
- Added Pydantic validation
- Fixed all critical bugs
- Created clean architecture
- Built modern React frontend
- Implemented beautiful gradient design
- Added error handling and loading states
- Created responsive layout
- Set up backend server (FastAPI)
- Configured frontend (Vite + React)
- Ensured both run successfully
- Verified API connectivity
- Created comprehensive READMEs
- Documented all changes
- Provided setup instructions
- Added code examples
- ✅ Async/Await - Non-blocking operations
- ✅ Dependency Injection - Proper session management
- ✅ Pydantic Validation - Type-safe APIs
- ✅ Error Handling - HTTP exceptions
- ✅ CORS Configuration - Frontend integration
- ✅ API Versioning -
/api/v1prefix - ✅ Clean Architecture - Separated concerns
- ✅ Modern React - Hooks and functional components
- ✅ Beautiful UI - Gradient design with animations
- ✅ Error Handling - User-friendly messages
- ✅ Loading States - Visual feedback
- ✅ Responsive Design - Mobile and desktop
- ✅ Real-time Updates - Instant UI feedback
- ✅ Type Hints - Full type coverage
- ✅ Documentation - Comprehensive docs
- ✅ Best Practices - Industry standards
- ✅ Clean Code - Readable and maintainable
- ✅ Testing Ready - Structured for tests
cd Initial_Code
cat README.md # See all the bugs Bob found# Backend
cd Result_After_Bob/backend
pip install -r requirements.txt
python3 -m uvicorn backend.main:app --reload --port 8001
# Frontend (in another terminal)
cd Result_After_Bob/frontend
npm install
npm run dev- Frontend: http://localhost:3000
- Backend API: http://localhost:8001/api/v1
- API Docs: http://localhost:8001/docs
| Metric | Before Bob | After Bob |
|---|---|---|
| Bugs | 20+ critical issues | 0 bugs |
| Architecture | Mixed concerns | Clean separation |
| Async Support | None | Fully async |
| Validation | None | Pydantic models |
| Error Handling | Silent failures | HTTP exceptions |
| UI | Basic | Modern & beautiful |
| Documentation | Minimal | Comprehensive |
| Code Quality | Poor | Production-ready |
This repository demonstrates:
- Code Analysis - How to identify bugs and issues
- Refactoring - Transforming bad code into good code
- Best Practices - FastAPI and React patterns
- Architecture - Clean, maintainable structure
- Documentation - Professional documentation standards
- Initial Code: See
Initial_Code/for the buggy version - Solution: See
Result_After_Bob/for the fixed version - Refactoring Details: See
REFACTORING_SUMMARY.md - Backend Docs: See
Result_After_Bob/backend/README.md - Frontend Docs: See
Result_After_Bob/frontend/README.md
- Clone this repo
- Ask Bob to analyze the code
- Ask Bob to fix the bugs
- Ask Bob to run it locally
- Ask Bob to create a UI
- Compare results with
Result_After_Bob/
- Study the bugs in
Initial_Code/ - Review the fixes in
Result_After_Bob/ - Read
REFACTORING_SUMMARY.md - Understand the before/after comparison
- Showcase Bob's capabilities
- Demonstrate refactoring skills
- Show before/after transformations
- Highlight best practices
This repository proves Bob can:
- ✅ Analyze complex codebases
- ✅ Identify and fix bugs
- ✅ Refactor following best practices
- ✅ Create modern UIs
- ✅ Deploy applications locally
- ✅ Generate comprehensive documentation
Perfect for testing AI coding assistants or learning best practices!
Repository: https://github.com/vperrinfr/Bob_mini-tasks
License: MIT
Created by: Vincent Perrin & Bob AI Assistant