Samvid Ghanam — User Guide

How to ask questions, sign in as a scholar or admin, and use every workflow in the portal. Three reader paths below — pick the one that matches your role.

Overview

Samvid Ghanam (संविद् घनम्) is a curated Q&A hub for Vedic and Sanātana topics. The flow is intentionally simple:

  1. A visitor poses a question.
  2. An admin reviews it and assigns it to one or more scholars (or the question auto-routes by subject group).
  3. Scholars compose answers — text, audio, video, references — and submit drafts.
  4. Admins approve drafts; published answers appear on the relevant topic page, and the asker is notified.

Roles in the system: visitor (no sign-in), scholar(answers questions in their subject groups), operator(sees all pending questions and can author answers), admin(full management — users, assignments, approvals).

For Visitors (no sign-in needed)

Ask a question

Click Ask in the top nav (or the saffron button on the home page). Before you submit, the form shows live suggestions from the 2,267 topics in the master list — if your question matches an existing topic, you can link to it directly so a scholar already covering that subject picks it up faster.

Required: question body. Optional but recommended: name, email (so we can send the answer link when it's published), city/country, category. If you don't pick a category, the system auto-categorizes via AI.

Browse and search

  • Topics — three views: Subject Groups (grid of 106 groups), Detailed List (sortable table of all 2,267 topics with filter), A–Z Index (jump-to-letter alphabetical).
  • Questions — every public question with status pills: All / Pending / Answered. Filter by category or asker.
  • Answers — list of every published scholar answer.
  • Search — the bar under the header on every page (or press / from anywhere) suggests matching topics in real-time, with both English and Sanskrit names plus scriptural reference (e.g. RV 1.1).

For Scholars

First-time sign-in

An admin invites you by email at Admin → Users → New user. Once added, sign in two ways:

  1. Sign in with Google (recommended) — at /login, click the Google button, pick your Google account whose email matches what the admin entered. Done — no password to remember.
  2. Email + password — if you'd rather not use Google, go to /forgot-password, enter your email, click the reset link in the email, set a password.

After sign-in you land on /scholar — your Question Queue.

Reading the queue

The queue shows pending questions in two flavors:

  • Assigned to you — a thicker indigo border. An admin specifically assigned this to you. You also received an email when it was assigned. These come first.
  • No badge — questions that fall in your subject groups (set by the admin in Users → Edit). Anyone in the group can pick these up; first-come, first-served.

Writing an answer

Click Answer this → on any question. The answer form has:

  • Topic to attach this answer to — start typing to search the 2,267 topics. The answer publishes on that topic's page once approved.
  • Answer text — plain text or HTML. Cite scriptural references.
  • Video URL — paste a YouTube or Vimeo link.
  • Audio URL — paste a SoundCloud or direct audio link.

You don't need to fill all fields — at least one of text, video, or audio is enough.

Save draft vs Submit for review

  • Save draft — your work is saved; you can come back later and continue editing. Doesn't notify the admin yet.
  • Submit for review — flags the answer as ready for admin approval. The admin sees it under Admin → Review drafts. Once approved, the answer goes live on the topic page and the asker is emailed.

For Operators

Operators have the same answering surface as scholars (/scholar queue, answer form, drafts) but with two differences:

  • You see every pending question, not only those in matching subject groups. Useful for triage and transcription work.
  • You can author answers on any topic regardless of group assignment.

You cannot manage users or approve drafts — that's admin-only.

For Admins

The admin dashboard at /admin has tiles for the four things you'll do most:

Manage users

Admin → Users — add scholars, operators, or other admins. For each scholar you add, tick the subject groups they should answer questions in (Rigveda - Shakala Samhitaa, Bhāgavata Purāṇa, etc.). New scholars sign in via Google or via the forgot-password flow.

To delete a user, click the Delete link in their row. Can't delete yourself — protect against accidental lockout.

Question allocation

Admin → Questions & assignmentsshows three layers:

  1. Counts by subject group — clickable chips. Each shows <count> · <group name>. Click to filter the list below to that group only.
  2. Counts by category — read-only summary (Vedas, Philosophy, Rituals, …).
  3. List of questions — pending/answered/all + unassigned-only toggle + text filter.

To assign:

  1. Click Assign… on any question.
  2. The modal lists scholars in the matching subject group first, then others below.
  3. Tick one or more, add an optional note, click Assign.
  4. The system emails each assigned scholar immediately with the question text + a direct link to their answer page. The "email pending → email sent" status shows on the assignment chip.

To remove an assignee, click the × on their pill chip.

Review drafts

Admin → Review drafts — three tabs: Submitted for Review (the action queue), Scholar Drafts(still being edited), All. Each card shows the question, the answer body, video / audio links, and the author. Two actions:

  • Approve & Publish — sets answer status to published, marks the topic as published, sets the asker's answered_at, and the answer is now visible on the topic page and on the public /answers list. Optional note.
  • Reject — note required (sent back to the scholar so they can revise).

The full picture

From the dashboard tiles you can also see at a glance:

  • Total users by role (admins / operators / scholars)
  • Questions: total, pending, answered
  • Answers: drafts, submitted, published

Lifecycle of a Question


  ┌─────────────────┐
  │ Visitor on /ask │      ← Browser, no sign-in
  └────────┬────────┘
           │   POST /api/questions
           ▼
  ┌─────────────────────────────────┐
  │  Question                        │
  │  • status: pending               │
  │  • category: AI-categorized      │
  │  • matched_topic_id: optional    │
  └────────┬────────────────────────┘
           │
           │   Admin assigns →   ✉ email to scholar(s)
           │                     (Gmail API)
           ▼
  ┌─────────────────────────────────┐
  │  Scholar opens /scholar/         │
  │  answer/<qid> → composes:        │
  │  • body_html  • video_url        │
  │  • audio_url  → Submit           │
  └────────┬────────────────────────┘
           │
           ▼
  ┌─────────────────────────────────┐
  │  Answer.status = submitted       │
  │  Visible in /admin/drafts        │
  └────────┬────────────────────────┘
           │   Admin approves
           ▼
  ┌─────────────────────────────────┐
  │  Answer.status = published       │
  │  Topic.status = published        │
  │  Question.answered_at = now()    │
  │  ✉ asker notified (future)       │
  │  Visible on /answers + topic page│
  └─────────────────────────────────┘

Troubleshooting & FAQ

Can't sign in with Google — "no active account exists for X"

Your Google account email isn't yet in the user table. An admin must add you under Admin → Users → New user with the exact email Google associates with your account.

Can't sign in with Google — picker shows wrong account

Open the login page in Incognito (Ctrl+Shift+N) to avoid your default Google session. Sign in with the email you were invited under.

Forgot password

Click Forgot your password? on the sign-in page. A reset link is emailed; clicking it lets you set a new password and signs you in immediately.

I assigned a scholar but they say they didn't get the email

The email send is best-effort — it shows "email sent" or "email pending" on the assignment chip in Admin → Questions. If it shows "email pending", re-assign (it's idempotent — won't double-assign) to retry. Also check the recipient's spam folder.

How do I rebuild the topic list?

Topic ingest happens at backend image build time from Topics 2K Master List ... .xlsx. Replace that file in the repo root, push, and the next deploy bakes the new list.

Where does the data live?

SQLite database, persisted to a Google Cloud Storage bucket (gs://sumvidghanam-data/samvid.db) on every commit, restored on container start. Cloud Run is configured with --max-instances=1to avoid concurrent writers.

Where do I report bugs / suggest improvements?

Email tech@dharmaposhanam.in.