A comprehensive full-stack business intelligence application with integrated video library, database persistence, and direct source integration for business news.
- Women in Business Section - Dedicated page with pink theme for women entrepreneurs
- Sustainability Videos - Green-themed educational content on sustainable business
- YouTube Integration - Real videos when API configured, sample videos as fallback
- Video Player - Modal player with full-screen support
- Video Search - Find specific videos across categories
- Metadata - View count, duration, channel, publish date
- Firebase Integration - Free Realtime Database for data persistence
- Article Saving - Save important news articles
- User Preferences - Store viewing preferences and settings
- Quiz Results - Track learning progress
- Leaderboard - Competitive scoring with persistent storage
- In-Memory Fallback - Works without database configuration
- Direct Source Integration: Fetches news from 10+ business sources
- RSS Feed Aggregation: Real-time updates from trusted sources
- Interactive Quiz System: AI-generated and traditional questions
- Market Analytics: Real-time market data
- Environmental Tracking: ESG scores and sustainability metrics
- User Authentication: Student ID-based login
- Games & Engagement: 6 interactive business games
- AI Insights: Market analysis and trend predictions
- Sustainability Dashboard: Environmental impact tracking
- Link Verification: Automated URL verification
- AI Content Validation: Gemini AI credibility scoring
- React 18 with Vite
- Tailwind CSS for responsive design
- Axios for API communication
- Firebase for real-time data
- react-youtube for video embedding
- Node.js with Express.js
- Firebase Admin SDK for database
- YouTube Data API for videos
- Gemini AI for content validation
- Axios for external APIs
- Morgan for logging
# Backend
cd backend && npm install && npm run dev
# Frontend (new terminal)
cd frontend && npm install && npm run devVisit http://localhost:5173 - Works with sample data!
Get free API keys from:
- NewsAPI.org
- GNews API
- NewsData.io
- TheNewsAPI
Create backend/.env:
NEWSAPI_KEY=your_key
GNEWS_API_KEY=your_key
NEWSDATA_API_KEY=your_key
THENEWSAPI_KEY=your_key
Get key from Google Cloud Console, add to .env:
YOUTUBE_API_KEY=your_key
Firebase free tier:
FIREBASE_SERVICE_ACCOUNT=your_json
FIREBASE_DATABASE_URL=your_url
FIREBASE_STORAGE_BUCKET=your_bucket
Get Gemini API key from aistudio.google.com:
GEMINI_API_KEY=your_key
- QUICKSTART.md - 5-minute setup guide
- SETUP_GUIDE.md - Detailed configuration
- FEATURES.md - Complete feature list
- IMPLEMENTATION_SUMMARY.md - What's new in V1.1
- Daily Briefing - Aggregated business news (gold/amber theme)
- Library - Browse article categories
- Saved Articles - Your bookmarked content
- Market Data - Real-time market analytics
- AI Insights - AI-powered analysis (blue theme)
- Leaderboard - User rankings by points
- Daily Quiz - Test your knowledge
- Games - Interactive business games
-
Women in Business 👩💼 - Pink theme (#ff1493)
- Women entrepreneurs and leaders
- Financial independence
- Leadership skills
- Business growth strategies
-
Sustainability 🌱 - Green theme (#228B22)
- Environmental impact tracking
- Green business practices
- Carbon footprint metrics
- ESG scoring
- Sustainability videos
Primary Blue: #1e3a8a (Charts, headers)
Accent Gold: #d97706 (Highlights)
Success Green: #228B22 (Sustainability)
Women Pink: #ff1493 (Women in Business)
Neutral Gray: #6b7280 (Text, borders)
- Node.js 18+ and npm
- Google Gemini API key (optional but recommended)
cd backend
npm install
cp .env.example .env
# Edit .env with your API keys (Gemini optional)
npm run devcd frontend
npm install
npm run devGEMINI_API_KEY=your_gemini_api_key_here
PORT=4000
ECO_PAPERS_BASE=12847
ECO_CO2_PER_PAPER=200GET /api/news/daily-briefing- Aggregated business newsGET /api/news/daily-briefing?enhanced=true- News with AI validationGET /api/quiz/daily?ai=true- AI-generated quiz questions
GET /api/videos/women-in-business- Women entrepreneurs videosGET /api/videos/sustainability- Sustainability education videosGET /api/videos/featured- Featured videos across categoriesGET /api/videos/search?q=query- Search video library
POST /api/db/save-article- Save article to databaseGET /api/db/articles- Get saved articlesPOST /api/db/user-preference- Store user preferencesGET /api/db/user-preference/:userId- Get preferencesPOST /api/db/quiz-result- Save quiz resultsGET /api/db/leaderboard- Get leaderboard rankings
POST /api/verify/link- Verify single URLPOST /api/verify/links- Verify multiple URLsGET /api/verify/stats- Verification statisticsDELETE /api/verify/cache- Clear cache
POST /api/ai/validate-article- Validate credibilityPOST /api/ai/enhance-summary- Improve summaryPOST /api/ai/generate-alternative- Generate content
GET /api/health- Service status and configurationGET /api/market- Market data snapshotGET /api/eco- Environmental metrics
- Format:
cb.sc.u4aie24***(where *** are 3 digits) - Case insensitive
- Username equals password for simplicity
- Examples:
cb.sc.u4aie24001,CB.SC.U4AIE24999
- Profile management with statistics
- Points system for quiz participation
- Leaderboard rankings
- Saved articles functionality
- Business Trivia - Multiple choice questions
- Market Predictor - Predict market movements
- Headline Scramble - Unscramble business headlines
- News Bingo - Find keywords in articles
- Speed Reader Challenge - Timed reading comprehension
- Sentiment Analysis - Analyze article sentiment
- Content Validation: Credibility scoring (1-10 scale)
- Link Recovery: Generate alternative content for broken links
- Summary Enhancement: Improve article readability
- Quiz Generation: Create contextual quiz questions
- Source Verification: Validate news source credibility
- Graceful degradation when AI services are unavailable
- Cached fallback content for offline scenarios
- Traditional quiz generation as AI backup
- Direct homepage links when RSS feeds fail
- Real-time Parsing: Automatic RSS feed processing
- Multi-source Aggregation: Combines feeds from 10+ sources
- Content Extraction: Intelligent title, summary, and link extraction
- Error Handling: Robust fallback to homepage links
- Caching: Efficient content caching and refresh cycles
- Standard RSS 2.0
- Atom feeds
- Custom business feed formats
- CDATA content handling
- Article source distribution
- Link verification success rates
- Domain-wise content analysis
- User engagement metrics
- RSS feed health monitoring
- Feed parsing success rates
- Content freshness indicators
- Source availability tracking
- User interaction patterns
- Configure Gemini API key for AI features (optional)
- Ensure RSS feed accessibility
- Configure proper CORS settings
- Set up monitoring for source availability
- Intelligent RSS feed caching
- Batch processing for content aggregation
- Graceful error handling and fallbacks
- Optimized content parsing
Created by:
- Naga Shiva D
- Kaushal Reddy S
- Ranjith Raja B
Contact: teambizai@gmail.com
© 2026 BizAI. Built with ❤️ for educational purposes.
-
Clone and Setup
git clone <repository-url> cd bizai
-
Backend
cd backend npm install cp .env.example .env # Optionally add Gemini API key to .env npm run dev
-
Frontend
cd frontend npm install npm run dev -
Access Application
- Frontend: http://localhost:5173
- Backend API: http://localhost:4000
- Health Check: http://localhost:4000/api/health
-
Login
- Use format:
cb.sc.u4aie24001(username = password) - Explore business news from major sources!
- Use format:
This version aggregates news directly from major business websites and RSS feeds, providing reliable access to business content without dependency on third-party news APIs.