RateProfCuaBan / RateUrProf (Đánh Giá Giảng Viên Của Bạn)

Comprehensive Nationwide Academic Information Platform & Bilingual Search Engine for Vietnam

RateProfCuaBan is an institutional-grade academic discovery platform that catalogs universities, faculties, departments, and professors across Vietnam. It combines an automated, polite data acquisition and enrichment pipeline with a high-performance bilingual (Vietnamese/English) search engine, while preserving community student reviews and ratings.

---

Screenshots

Home & Search Portal

Nationwide Professor Search

Professor Profile & Student Ratings

University Directory Search

University Profile & Evaluation

---

Platform Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                       RATEPROFCUABAN SYSTEM ARCHITECTURE                     │
└─────────────────────────────────────────────────────────────────────────────┘

  ┌─────────────────────────────────────────────────────────────────────────┐
  │ 1. DATA ACQUISITION & ENRICHMENT PIPELINE (Python 3.10+)                │
  │                                                                         │
  │  [Seed Directory] ────> [Polite Crawler] ───> [University Adapters]    │
  │  • 35+ VN Unis          • robots.txt check    • HUST, VNU, HCMUT, FTU   │
  │  • North/Central/South  • 1.5s rate limit     • NEU, UIT, Generic       │
  │                                                                         │
  │  [Entity Resolution] ─> [Image Rights Check]─> [Quality Assurance]     │
  │  • Vietnamese Diacritics• Fair use classifier • Completeness scoring    │
  │  • Academic title strip • SVG Avatar fallback • Regional balance audit  │
  └────────────────────────────────────┬────────────────────────────────────┘
                                       │ Generates JSON & Synced to DB
                                       ▼
  ┌─────────────────────────────────────────────────────────────────────────┐
  │ 2. CLOUD DATABASE PERSISTENCE & HARDENED ACCESS CONTROL                 │
  │                                                                         │
  │  • Public Academic Catalogs: universities, faculties, professors,      │
  │    departments, courses, academicPublications, sourceDocuments         │
  │  • Community Reviews: reviews, reports, users (Rating rollup rules)     │
  │  • Admin Pipeline Controls: sourceRegistry, entityMatchCandidates,     │
  │    ingestionJobs, ingestionRuns, dataQualityReports                     │
  └────────────────────────────────────┬────────────────────────────────────┘
                                       │ Indexed for Retrieval
                                       ▼
  ┌─────────────────────────────────────────────────────────────────────────┐
  │ 3. NEXT.JS 16 WEB PLATFORM & BILINGUAL SEARCH ENGINE                    │
  │                                                                         │
  │  • App Router (Next.js 16.4.1) with Cache Components & Partial Prefetch  │
  │  • Full Bilingual Routing (/vi and /en) with Search Param Preservation  │
  │  • Citation-Grounded Search with Verified University Source Links       │
  │  • Sub-millisecond In-Memory Search (p95 = 0.22ms over 1,000 queries)    │
  └─────────────────────────────────────────────────────────────────────────┘

---

Key Features

1. Nationwide Academic Coverage

• Geographic Balance: Seeded across Northern (Hà Nội, Thái Nguyên), Central (Đà Nẵng, Huế, Quy Nhơn), and Southern (TP. Hồ Chí Minh, Cần Thơ) Vietnam.
• Academic Hierarchy: Institutions $\rightarrow$ Faculties/Schools $\rightarrow$ Departments $\rightarrow$ Teaching Staff $\rightarrow$ Courses & Publications.
• Instructional Rank Integrity: Strictly distinguishes statutory instructional ranks (GS / PGS) from academic degrees (TS / ThS) in compliance with the State Council for Professorship (Hội đồng Giáo sư Nhà nước).

2. Bilingual Citation-Grounded Search

• Strict Anti-Hallucination Policy: Grounded exclusively in verified .edu.vn official records. If institutional evidence is unavailable (e.g., narrow subfields without indexed staff), the engine explicitly abstains rather than inventing faculty records.
• Clickable Markdown Citations: Every factual statement provides clickable source links to official university faculty directories.
• Identity Disambiguation: Detects cross-university identical or near-identical names and presents clear disambiguation notices.
• Language Auto-Matching: Automatically detects Vietnamese or English query intent and responds in the user's preferred language.

3. Polite & Legal Compliance Engine

• Polite Crawling: Respects robots.txt, identifies via RateUrProfs-Academic-Bot/2.0 (+https://rateurprofs.site/bot), and enforces a minimum 1.5s polite delay with exponential backoff.
• No Anti-Bot Bypassing: Social platforms (Facebook/LinkedIn) are never scraped behind authentication. Optional authorized manual exports are imported as unverified leads (social_lead_unverified) requiring administrative review.
• Image Rights & Neutral SVG Fallbacks: Copyright classifier checks whether photographs are licensed for reuse. If rights are uncertain, the system generates neutral SVG initials avatars.
• Privacy Compliance: Built to adhere to Vietnamese Decree 13/2023/NĐ-CP on Personal Data Protection, offering clear distinction between public institutional records and student opinions, accompanied by an administrative Right to Erasure / Correction protocol.

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗