🌿 LokVeda — Your E-Gram Panchayat

LokVeda is a web-based E-Gram Panchayat system designed to digitize essential village-level services with a strong focus on authentication, session security, accessibility, and UX clarity.

This project currently represents a preview / base release (v1.0.1), focusing on secure access, role-based dashboards, and system flow rather than full service execution.

🔗 Live Demo: https://dipsana.github.io/lokveda/

---

🚀 Tech Stack

---

🏛️ Project Overview

LokVeda simulates a real-world government service portal for Indian villages, where citizens are pre-registered and authenticated via OTP.
No public sign-up is required, reflecting real administrative workflows.

The system supports three roles:

• 👤 User (Citizen)
• 🧑‍💼 Staff
• 🛡️ Admin

Each role has a dedicated login page and dashboard.

---

✨ Key Features (Implemented)

🔐 Authentication & Security

• OTP-based login (Aadhaar-linked phone number)
• Regex-based input validation (length, digits, format)
• Friendly status messages for success/failure
• Max attempt limit (blocks user for 24 hours after repeated failures)
• Session lock if user exits improperly
• Secure logout with warning modal

⏱️ Session Management

• Session creation & validation via Firebase
• Auto logout after 15 minutes of inactivity
• Session guard prevents:
  • Direct dashboard access without login
  • Sneaky URL navigation
• Users attempting multiple logins are restricted for 3 hours

🌍 Location Checker

• Ensures role-based geographic access:
  • Users → same village
  • Staff → same state
  • Admin → within India (border-aware logic)
• Prevents misuse from outside allowed regions

👋 Greeting System

• Dynamic greeting message displayed across dashboards
• Personalized with user name
• Time-aware greeting logic

🌙 Dark Mode (UX-focused)

• Detects browser theme preference instantly
• Preserves user choice locally (until cache cleared)
• Smooth, non-blinding transitions
• Minimal, clean toggle button with hover aura

---

🧭 Navigation Bar (Post-Login)

Displayed only after successful authentication:

• Greeting text
• Dashboard shortcut
• Search icon + expandable search bar (UI-ready)
• Dark mode toggle
• Secure logout button

Visibility is managed using reusable hide() and show() utilities.

---

📄 Forms & Services (Preview Stage)

• Forms are created and load dynamically via form-loader

• URL parameter-based loading implemented

• Submission, updates, and downloads are not yet implemented

• Undeveloped features are clearly marked using:

  element.title = 'In development';

---

🗂️ Firebase as Virtual Backend

All database and authentication logic is encapsulated inside firebase.js.

• Acts as a virtual backend
• Exports only required getters/setters
• Prevents data tampering via encapsulation
• Must be initialized exactly once
• Re-initialization triggers forced logout

If moved server-side, the app architecture remains secure.

---

📁 Clickable Project Structure

Perfect, this is clean now. Below is a fully updated, clickable folder structure with all form files included and linked individually, exactly suitable for README / mini-readme / documentation repo view (GitHub).

You can copy-paste this as-is.

---

📁 Clickable Project Structure — LokVeda: Your E-Gram Panchayat

lokveda-egram-panchayat/
├── 📁 assets/
│ └── 📁 icons/
│
├── 📁 auth/
│ ├── auth-user.html
│ ├── auth-staff.html
│ ├── auth-admin.html
│ ├── auth-core.js
│ └── auth.css
│
├── 📁 dashboard/
│ ├── dashboard-user.html
│ ├── dashboard-staff.html
│ ├── dashboard-admin.html
│ ├── dashboard.js
│ └── dashboard.css
│
├── 📁 form-loader/
│ ├── form-api.js
│ ├── form-loader.js
│ ├── form-ui.css
│ └── form-view.html
│
├── 📁 forms/
│ ├── birth.html
│ ├── death.html
│ ├── dues.html
│ ├── election-updates.html
│ ├── grievance.html
│ ├── health-checkup.html
│ ├── jobs.html
│ ├── land.html
│ ├── mgnrega.html
│ ├── property-tax.html
│ ├── property.html
│ ├── public-notices.html
│ ├── public-works.html
│ ├── rti.html
│ ├── sanitation.html
│ ├── skill-training.html
│ ├── subsidies.html
│ ├── tenders.html
│ ├── voter-id.html
│ ├── voter-list.html
│ ├── water-tax.html
│ └── welfare-schemes.html
│
├── 📁 services/ (future scope)
│
├── dom.js
├── firebase.js
├── greeting-bot.js
├── nav-bar.js
├── script-global.js
├── style-global.css
├── utilities.css
├── index.html
├── favicon.png
├── preview.png
│
├── 📁 documentation/
│ ├── 📒 LOKVEDA_COLLEGE.docx
│ ├── 📒 LOKVEDA_COLLEGE.pdf
│ ├── 📒 LOKVEDA_STUDENT.docx
│ ├── 📒 LOKVEDA_STUDENT.pdf
│ ├── 📗 SRS.docx
│ ├── 📕 SRS.pdf
│ └── 📄 README.md │
├── 🕒 CHANGELOG.md
├── 🔑 LICENSE
└── 📄 README.md

---

📚 Documentation

• 📄 Software Requirements Specification (SRS)
• 📒 College Documentation
• 📒 Student Documentation
• 🕒 Changelog
• 🔑 License (MIT)

---

🔮 Future Scope

• Service application submission (CRUD)
• Admin approval workflows
• Staff verification flow
• Downloadable forms (PDF/DOCX)
• Profile management
• Full backend deployment

---

👥 Contributors

• Dipsana Roy — Core architecture, frontend, authentication, session logic, UX, Firebase integration
• Ayushman Saha — Documentation & Presentation
• Sayan Goswami — Documentation & Presentation
• Ananya Saha — Forms & Documentation
• Smritilata Sardar — Forms & Documentation

---

📜 License

This project is licensed under the MIT License.

---

References

1. IEEE Software Requirements Specification Standards
2. Firebase Official Documentation
3. Twilio Console
4. MDN Web Docs – HTML, CSS, JavaScript
5. Research papers on E-Governance systems
6. ChatGPT (OpenAI) — Assisted in documentation structuring, content refinement, and automation of repetitive coding tasks

---

Note: This project intentionally prioritizes system design, security flow, and real-world logic over feature completeness for this phase.