How hoaihue04/review-insight works
ReviewInsight is a Vietnamese e-commerce review analytics app for sellers. A seller submits a product link or ID; the app fetches product data and reviews, cleans and splits review text, predicts aspect-level sentiment with PhoBERT, then presents dashboard summaries, trends, and verbatim opinions. A separate review assistant answers product-specific questions using analytics and retrieved evidence. The graph covers the documented dashboard capabilities, background analysis, persistence, and assistant subsystems. Some internals are unsampled; edges are limited to relationships shown by excerpts, the source index, or README.
Main entry points: dashboard_service.py Product analysis and analytics · assistant_service.py Question answering and advice · retrieval.py Hybrid evidence retrieval · main.py FastAPI app and routes
Components 21
Product analysis
- FastAPI app and routes
app/main.py - Analysis jobs and progress
app/core/analysis_jobs.py - Product analysis and analytics
app/web/dashboard_service.py - Tiki product and review fetch
app/web/tiki_client.py - PhoBERT aspect sentiment
app/web/phobert_predictor.py
Seller dashboard
- Seller dashboard interface
app/static/seller_dashboard.js - Dashboard summaries and trends
app/web/seller_summary.py - Filtered opinion CSV
app/web/csv_fallback.py
Review assistant
- Assistant endpoints
app/api/routes/assistant.py - Question answering and advice
app/assistant/assistant_service.py - Question intent and aspects
app/assistant/query_analyzer.py - Hybrid evidence retrieval
app/assistant/retrieval.py - Question-focused statistics
app/assistant/statistics_planner.py - Product risk assessment
app/assistant/risk.py - Language model client
app/assistant/llm.py
Data and retrieval
- Product and opinion repository
app/assistant/repository.py - PostgreSQL and pgvector
app/assistant/db.py - Semantic opinion store
app/assistant/vector_store.py
Other components
- Seller
- Tiki marketplace API
- Configured LLM provider
Connections 25
- Seller → FastAPI app and routes: submits product
README.md - FastAPI app and routes → Analysis jobs and progress: starts analysis
app/main.py - FastAPI app and routes → Assistant endpoints: routes questions
app/main.py - Analysis jobs and progress → Product analysis and analytics: runs analysis
app/core/analysis_jobs.py - Product analysis and analytics → Tiki product and review fetch: fetches reviews
app/web/dashboard_service.py - Tiki product and review fetch → Tiki marketplace API: requests product data
app/web/tiki_client.py - Product analysis and analytics → PhoBERT aspect sentiment: predicts opinions
app/web/dashboard_service.py - Product analysis and analytics → Product and opinion repository: persists analysis
app/web/dashboard_service.py - Product analysis and analytics → Product risk assessment: assesses risks
app/web/dashboard_service.py - Product analysis and analytics → Dashboard summaries and trends: builds summaries
app/web/dashboard_service.py - Seller → Seller dashboard interface: views results
README.md - Seller dashboard interface → Filtered opinion CSV: exports filtered opinions
README.md - Assistant endpoints → Product analysis and analytics: analyzes product
app/api/routes/assistant.py - Assistant endpoints → Question answering and advice: requests answers
app/api/routes/assistant.py - Question answering and advice → Question intent and aspects: analyzes question
app/assistant/assistant_service.py - Question answering and advice → Hybrid evidence retrieval: retrieves evidence
app/assistant/assistant_service.py - Question answering and advice → Question-focused statistics: plans statistics
app/assistant/assistant_service.py - Question answering and advice → Product risk assessment: uses risk context
app/assistant/assistant_service.py - Question answering and advice → Language model client: generates answer
app/assistant/assistant_service.py - Language model client → Configured LLM provider: sends prompt
- Hybrid evidence retrieval → Question intent and aspects: uses query aspects
app/assistant/retrieval.py - Hybrid evidence retrieval → Semantic opinion store: searches opinions
app/assistant/retrieval.py - Hybrid evidence retrieval → Product and opinion repository: loads structured evidence
- Product and opinion repository → PostgreSQL and pgvector: reads and writes
app/assistant/repository.py - Semantic opinion store → PostgreSQL and pgvector: queries vectors
app/assistant/vector_store.py