marine-library
ASHUTOSH SINGH📘 PROJECT REQUIREMENT DOCUMENT (PRD) Namma-Pustaka – Smart Library Assistant for Rural Schools 🧾 1. Project Overview Project Title: Namma-Pustaka Domain: Education Technology (EdTech) Platform: Android Application (Kotlin) Description: Namma-Pustaka is a smart digital library assistant designed for rural schools. It transforms traditional book storage systems into an organized digital platform where students and teachers can easily manage, access, and track books. ❗ 2. Problem Statement In many village schools: Libraries are unorganized (books stored in cupboards) No tracking of issued/returned books Students are unaware of available books Teachers manually maintain records → errors & book loss 👉 This leads to: Poor reading culture Mismanagement of resources Lack of accountability 🎯 3. Objectives Digitize rural school libraries Encourage reading habits among students Simplify book tracking for teachers Introduce basic digital workflows 💡 4. Proposed Solution Namma-Pustaka is a mobile app that: Displays books in a digital catalog Allows students to browse, reserve, and review books Enables teachers to track borrowing digitally Uses QR codes for easy book issuing Sends overdue reminders 👥 5. Target Users 👨🎓 Students Browse books Reserve books Rate and review 👨🏫 Teachers (Admin) Add/manage books Issue/return books Track overdue books 🔐 6. User Roles & Access Feature Student Teacher View Books ✅ ✅ Search Books ✅ ✅ Reserve Books ✅ ❌ Add/Edit Books ❌ ✅ Issue Books (QR) ❌ ✅ View Overdue ❌ ✅ Leaderboard ✅ ✅ 🔄 7. App Workflow User logs in (Student/Teacher) Dashboard loads Student: Browses catalog → reserves book → reviews Teacher: Scans QR → issues book → tracks due dates System: Highlights overdue books in RED Updates leaderboard 📱 8. Features 📚 Book Catalog Grid layout (RecyclerView) Categories: Story, Science, History Search by name/author 📷 QR Borrow System Scan QR using camera Assign book to student Track issue & return ⭐ Review System 1–5 star rating One-line feedback 🏆 Leaderboard Rank students by pages read Monthly tracking 🔔 Overdue Alerts Highlight overdue books Reminder notifications 🛠️ 9. Technical Requirements Frontend Language: Kotlin UI: XML (Material Design) Components: RecyclerView, CardView Backend Database: Room DB (local) Optional: Firebase (cloud sync) Libraries QR Scanning: Google ML Kit Image Loading: Glide/Coil 🧱 10. System Architecture MVVM Architecture Layers: UI Layer (Activity/Fragment) ViewModel Repository Database (Room/Firebase) 🗄️ 11. Data Model Book id title author category pages User id name role (Student/Teacher) Transaction bookId studentId issueDate dueDate status Review rating comment 📊 12. Success Criteria Add book using camera input Overdue books show RED color automatically Search functionality works correctly QR-based issue system works Smooth UI navigation 🌍 13. Impact 📖 Literacy Promotion Encourages reading habits 🧾 Resource Management Reduces book loss 💻 Digital Awareness Introduces students to digital systems ⚠️ 14. Constraints Limited internet in rural areas Low-end Android devices Need for simple UI 🚀 15. Future Enhancements Multi-language support (Kannada + English) Voice-based search AI-based book recommendations Cloud sync across schools ✅ 16. Conclusion Namma-Pustaka is a practical, scalable solution to modernize rural school libraries. It bridges the gap between traditional systems and digital technology, promoting education and efficient resource management. make an app accordint to the contet,have spearte login for librarian and students
Comments (0)
Sign in to leave a comment
System Requirements
System Requirements Document (SRD)
marine-library
1. Introduction
The "marine-library" project is a smart digital library assistant designed to modernize library management for rural schools. It aims to transform traditional book storage systems into an organized digital platform where students and teachers can efficiently manage, access, and track books. The system will work both online and offline, ensuring usability in areas with limited internet connectivity.
2. System Overview
The marine-library system will be implemented as a mobile application, primarily targeting Android devices. It will provide functionalities for students to browse, reserve, and review books, while enabling teachers to manage book inventories, issue books using QR codes, and track overdue books. Firebase will be used for cloud synchronization, ensuring data consistency across devices.
3. Functional Requirements
As story points:
- As a Student, I should be able to browse books by categories and search by name or author.
- As a Student, I should be able to reserve books for borrowing.
- As a Student, I should be able to rate and review books.
- As a Student, I should be able to view my reading progress and overdue books.
- As a Teacher, I should be able to add, edit, and manage books in the catalog.
- As a Teacher, I should be able to issue and return books using QR codes.
- As a Teacher, I should be able to track overdue books and send reminders.
- As a Teacher, I should be able to view a leaderboard of students based on reading activity.
- As a System, I should highlight overdue books in red and send notifications for reminders.
4. User Personas
1. Student
- Role: Library user
- Actions: Browse, reserve, review books, track reading progress, view overdue books.
2. Teacher (Admin)
- Role: Library manager
- Actions: Add/edit books, issue/return books, track overdue books, manage student leaderboard.
5. Visuals Colors and Theme
Color Palette
- primary: #0057D9 (Deep Blue)
- primary_light: #4DA3FF (Sky Blue)
- secondary: #FF6F3C (Vibrant Orange)
- accent: #FFD700 (Golden Yellow)
- highlight: #FF3B30 (Bright Red)
- bg: #F9FAFB (Soft White)
- surface: rgba(255, 255, 255, 0.9) (Translucent White)
- text: #1A1A1A (Dark Gray)
- text_muted: #6B7280 (Muted Gray)
- border: rgba(0, 87, 217, 0.2) (Subtle Blue)
6. Signature Design Concept
Interactive Library Explorer
The homepage will feature an interactive bookshelf where books are displayed as 3D cards. Users can swipe through categories like "Story," "Science," and "History," with smooth transitions powered by framer-motion. Hovering over a book will reveal a quick preview, while clicking will open a detailed view with options to reserve or issue the book.
- Animations: Books will "pop out" slightly when hovered over, and categories will slide horizontally with inertia-based scrolling.
- Transitions: Smooth fade-ins for book details and dynamic color shifts for category headers.
- Libraries Used:
framer-motionfor animations,react-three/fiberfor 3D effects.
7. Interaction Model & Motion Direction
Landing Page Interaction Model
- Parallax: Layered depth effects for categories and books, with scroll-triggered animations.
- Animated: Hover transitions for books and smooth page navigation.
- Internal Pages: Static layouts for dashboards, settings, and forms to prioritize clarity.
Distinctive Section Mechanics
- Book Categories: Swipeable carousel with inertia scrolling.
- Leaderboard: Dynamic ranking animations with hover effects on student profiles.
- Profile Page: Interactive progress bars for reading streaks and overdue books.
8. Non-Functional Requirements
- Offline functionality for browsing and issuing books.
- Firebase integration for cloud sync and notifications.
- Optimized for low-end Android devices.
- Simple and intuitive UI for rural users.
9. Tech Stack
Frontend
- Android (Kotlin)
- XML (Material Design)
Backend
- Firebase (Cloud Sync)
- Room DB (Local Database)
Libraries
- QR Scanning: Google ML Kit
- Image Loading: Glide/Coil
- Animations: framer-motion
10. Assumptions and Constraints
- Limited internet connectivity in rural areas.
- Low-end Android devices with minimal processing power.
- Need for a bilingual interface (Kannada + English).
11. Glossary
- QR Code: A machine-readable code used for book issuing and returning.
- Leaderboard: A ranking system based on students' reading activity.
- Firebase: A cloud-based platform for data synchronization and notifications.
- Room DB: A local database for offline functionality.
This SRD provides a comprehensive blueprint for the marine-library project, ensuring alignment with the user's vision and requirements. Let me know if you'd like to refine or expand any section!
Your Smart Library Awaits
Transform your school library into a digital hub. Students browse, reserve, and track books seamlessly — teachers manage everything with QR codes, even offline.
Popular on the Shelf
Discover the most borrowed and highest-rated books in our library this month.
Browse Categories
Swipe to explore book collections
Discover Your Next Read
Handpicked books based on your reading history and category preferences. Browse, reserve, and start your next adventure.
Top Readers
Start Your Reading Journey
Track your reading progress, discover books across dozens of categories, and earn badges as you complete your literary adventures.
Manage Your Library Efficiently
Issue books with QR codes, track overdue returns in real time, and keep students engaged with automated reminders — all from one place.
Manage books, students, and returns in one dashboard
Your Smart Library Awaits
Transform your school library into a digital hub. Students browse, reserve, and track books seamlessly — teachers manage everything with QR codes, even offline.
Popular on the Shelf
Discover the most borrowed and highest-rated books in our library this month.
Browse Categories
Swipe to explore book collections
Discover Your Next Read
Handpicked books based on your reading history and category preferences. Browse, reserve, and start your next adventure.
Top Readers
Start Your Reading Journey
Track your reading progress, discover books across dozens of categories, and earn badges as you complete your literary adventures.
Manage Your Library Efficiently
Issue books with QR codes, track overdue returns in real time, and keep students engaged with automated reminders — all from one place.
Manage books, students, and returns in one dashboard
No comments yet. Be the first!