setup

.streamlit/config.toml

@@ -0,0 +1,18 @@
+[global]
+developmentMode = false
+
+[server]
+headless = true
+port = 8501
+enableCORS = false
+enableXsrfProtection = false
+
+[browser]
+gatherUsageStats = false
+
+[theme]
+primaryColor = "#1f77b4"
+backgroundColor = "#ffffff"
+secondaryBackgroundColor = "#f0f2f6"
+textColor = "#262730"
+font = "sans serif" 

README.md

@@ -1,19 +1,120 @@
 ---
 title: Dev LMS
-emoji: 🚀
-colorFrom: red
-colorTo: red
+emoji: 📚
+colorFrom: blue
+colorTo: purple
 sdk: docker
 app_port: 8501
 tags:
 - streamlit
+- lms
+- education
+- pdf
 pinned: false
-short_description: Streamlit template space
+short_description: A Learning Management System with user authentication and PDF document management
 ---
 
-# Welcome to Streamlit!
+# Dev LMS - Learning Management System
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+A comprehensive Learning Management System built with Streamlit that provides user authentication and PDF document management capabilities.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+## 🚀 Features
+
+### 🔐 Authentication
+- Secure user login system
+- Multiple user roles (Admin, Teacher, Student)
+- Session management with cookies
+- Password hashing for security
+
+### 📄 Document Management
+- PDF document upload and storage
+- Text extraction from PDF files
+- Document preview and search functionality
+- Document library with user ownership tracking
+
+### 📊 Dashboard
+- User activity metrics
+- Document statistics
+- Recent activity tracking
+- System overview
+
+### 🔍 Search & Navigation
+- Search documents by filename, content, or owner
+- Filter documents by various criteria
+- Easy navigation between different sections
+- Document categorization
+
+## 👥 Default Users
+
+The system comes with three default user accounts:
+
+| Role | Username | Password |
+|------|----------|----------|
+| Administrator | `admin` | `admin123` |
+| Teacher | `teacher` | `teacher123` |
+| Student | `student` | `student123` |
+
+## 🛠️ Installation & Usage
+
+1. **Install Dependencies:**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+2. **Run the Application:**
+   ```bash
+   streamlit run src/streamlit_app.py
+   ```
+
+3. **Access the Application:**
+   - Open your browser and go to `http://localhost:8501`
+   - Login with one of the default credentials
+   - Start uploading and managing PDF documents!
+
+## 📁 Application Structure
+
+```
+├── src/
+│   └── streamlit_app.py    # Main application file
+├── data/                   # Data storage (created automatically)
+│   ├── documents/         # Document storage
+│   └── users/             # User configuration
+├── requirements.txt       # Python dependencies
+└── README.md             # This file
+```
+
+## 🔧 Technical Details
+
+- **Framework:** Streamlit
+- **Authentication:** streamlit-authenticator
+- **PDF Processing:** PyPDF2
+- **Data Storage:** Session state + YAML configuration
+- **Security:** bcrypt password hashing
+
+## 🎯 Use Cases
+
+- **Educational Institutions:** Manage course materials and assignments
+- **Corporate Training:** Organize training documents and resources
+- **Research Teams:** Share and collaborate on research papers
+- **Document Management:** Centralized PDF storage and retrieval
+
+## 🔒 Security Features
+
+- Secure password hashing using bcrypt
+- Session-based authentication
+- User role management
+- Document ownership tracking
+- Secure file upload handling
+
+## 📈 Future Enhancements
+
+- Database integration for persistent storage
+- Advanced document annotation features
+- User permission management
+- Document versioning
+- Real-time collaboration tools
+- Mobile-responsive design
+
+---
+
+**Built with ❤️ using Streamlit**

data/users/users.yaml

@@ -0,0 +1,14 @@
+credentials:
+  usernames:
+    admin:
+      email: admin@example.com
+      name: admin
+      password: admin
+    student:
+      email: student@example.com
+      name: Student
+      password: $2b$12$/aG0V/TytqnA1/eDjKfxbOC6KcBZgNng4ugaUDz6Y7TUmgkQV98ci
+    teacher:
+      email: teacher@example.com
+      name: Teacher
+      password: $2b$12$uFiJhI1IMGLnd9b/8anHRek.2vnkt0YAiH6q8G5FvciFZXsk.I442

requirements.txt

@@ -1,3 +1,7 @@
 altair
 pandas
-streamlit
+streamlit
+streamlit-authenticator
+PyPDF2
+python-multipart
+bcrypt

run_app.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""
+Dev LMS Startup Script
+======================
+
+This script provides an easy way to start the Dev LMS application.
+It handles dependency checking and provides helpful information.
+"""
+
+import subprocess
+import sys
+import os
+
+def check_dependencies():
+    """Check if required dependencies are installed"""
+    required_packages = [
+        'streamlit',
+        'streamlit_authenticator',
+        'PyPDF2',
+        'yaml',
+        'bcrypt'
+    ]
+    
+    missing_packages = []
+    
+    for package in required_packages:
+        try:
+            __import__(package.replace('-', '_'))
+        except ImportError:
+            missing_packages.append(package)
+    
+    return missing_packages
+
+def install_dependencies():
+    """Install missing dependencies"""
+    print("Installing missing dependencies...")
+    try:
+        subprocess.check_call([sys.executable, '-m', 'pip', 'install', '-r', 'requirements.txt'])
+        print("✅ Dependencies installed successfully!")
+        return True
+    except subprocess.CalledProcessError:
+        print("❌ Failed to install dependencies. Please install them manually:")
+        print("   pip install -r requirements.txt")
+        return False
+
+def main():
+    print("🚀 Dev LMS - Learning Management System")
+    print("=" * 50)
+    
+    # Check if we're in the right directory
+    if not os.path.exists('src/streamlit_app.py'):
+        print("❌ Error: Please run this script from the project root directory")
+        print("   (where src/streamlit_app.py is located)")
+        sys.exit(1)
+    
+    # Check dependencies
+    print("🔍 Checking dependencies...")
+    missing = check_dependencies()
+    
+    if missing:
+        print(f"❌ Missing dependencies: {', '.join(missing)}")
+        response = input("Would you like to install them now? (y/n): ")
+        if response.lower() in ['y', 'yes']:
+            if not install_dependencies():
+                sys.exit(1)
+        else:
+            print("Please install dependencies manually and try again.")
+            sys.exit(1)
+    else:
+        print("✅ All dependencies are installed!")
+    
+    print("\n🎯 Starting Dev LMS...")
+    print("📖 Default login credentials:")
+    print("   - Admin: admin / admin123")
+    print("   - Teacher: teacher / teacher123")
+    print("   - Student: student / student123")
+    print("\n🌐 The application will open in your browser at: http://localhost:8501")
+    print("⏹️  Press Ctrl+C to stop the application")
+    print("=" * 50)
+    
+    try:
+        # Start the Streamlit app
+        subprocess.run([
+            sys.executable, '-m', 'streamlit', 'run', 
+            'src/streamlit_app.py',
+            '--server.port=8501',
+            '--server.headless=true'
+        ])
+    except KeyboardInterrupt:
+        print("\n👋 Dev LMS stopped. Goodbye!")
+    except Exception as e:
+        print(f"❌ Error starting application: {e}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main() 

src/streamlit_app.py

@@ -1,40 +1,429 @@
-import altair as alt
-import numpy as np
-import pandas as pd
 import streamlit as st
+import streamlit_authenticator as stauth
+import yaml
+from yaml.loader import SafeLoader
+import os
+import PyPDF2
+import io
+import base64
+from datetime import datetime
+import json
 
-"""
-# Welcome to Streamlit!
-
-Edit `/streamlit_app.py` to customize this app to your heart's desire :heart:.
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
-
-In the meantime, below is an example of what you can do with just a few lines of code:
-"""
-
-num_points = st.slider("Number of points in spiral", 1, 10000, 1100)
-num_turns = st.slider("Number of turns in spiral", 1, 300, 31)
-
-indices = np.linspace(0, 1, num_points)
-theta = 2 * np.pi * num_turns * indices
-radius = indices
-
-x = radius * np.cos(theta)
-y = radius * np.sin(theta)
-
-df = pd.DataFrame({
-    "x": x,
-    "y": y,
-    "idx": indices,
-    "rand": np.random.randn(num_points),
-})
-
-st.altair_chart(alt.Chart(df, height=700, width=700)
-    .mark_point(filled=True)
-    .encode(
-        x=alt.X("x", axis=None),
-        y=alt.Y("y", axis=None),
-        color=alt.Color("idx", legend=None, scale=alt.Scale()),
-        size=alt.Size("rand", legend=None, scale=alt.Scale(range=[1, 150])),
-    ))
+# Page configuration
+st.set_page_config(
+    page_title="Dev LMS",
+    page_icon="📚",
+    layout="wide",
+    initial_sidebar_state="expanded"
+)
+
+# Initialize session state
+if 'authenticated' not in st.session_state:
+    st.session_state.authenticated = False
+if 'username' not in st.session_state:
+    st.session_state.username = None
+if 'uploaded_documents' not in st.session_state:
+    st.session_state.uploaded_documents = {}
+
+# Create data directory if it doesn't exist
+os.makedirs('data', exist_ok=True)
+os.makedirs('data/documents', exist_ok=True)
+os.makedirs('data/users', exist_ok=True)
+
+# User configuration file
+USERS_FILE = 'data/users/users.yaml'
+
+def create_default_users():
+    """Create default users if the users file doesn't exist"""
+    if not os.path.exists(USERS_FILE):
+        default_users = {
+            'credentials': {
+                'usernames': {
+                    'admin': {
+                        'email': 'admin@example.com',
+                        'name': 'Administrator',
+                        'password': stauth.Hasher(['admin123']).generate()[0]
+                    },
+                    'teacher': {
+                        'email': 'teacher@example.com',
+                        'name': 'Teacher',
+                        'password': stauth.Hasher(['teacher123']).generate()[0]
+                    },
+                    'student': {
+                        'email': 'student@example.com',
+                        'name': 'Student',
+                        'password': stauth.Hasher(['student123']).generate()[0]
+                    }
+                }
+            }
+        }
+        
+        os.makedirs(os.path.dirname(USERS_FILE), exist_ok=True)
+        with open(USERS_FILE, 'w') as file:
+            yaml.dump(default_users, file, default_flow_style=False)
+
+def load_users():
+    """Load users from YAML file"""
+    create_default_users()
+    with open(USERS_FILE) as file:
+        config = yaml.load(file, Loader=SafeLoader)
+    return config
+
+def save_document_info(username, filename, file_content, file_type):
+    """Save document information to session state"""
+    if username not in st.session_state.uploaded_documents:
+        st.session_state.uploaded_documents[username] = []
+    
+    document_info = {
+        'filename': filename,
+        'upload_time': datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
+        'file_type': file_type,
+        'size': len(file_content),
+        'content': file_content.decode('latin-1') if isinstance(file_content, bytes) else str(file_content)
+    }
+    
+    st.session_state.uploaded_documents[username].append(document_info)
+
+def extract_pdf_text(pdf_file):
+    """Extract text from PDF file"""
+    try:
+        pdf_reader = PyPDF2.PdfReader(pdf_file)
+        text = ""
+        for page in pdf_reader.pages:
+            text += page.extract_text() + "\n"
+        return text
+    except Exception as e:
+        st.error(f"Error reading PDF: {str(e)}")
+        return ""
+
+def main():
+    # Load users
+    config = load_users()
+    
+    # Create authenticator
+    authenticator = stauth.Authenticate(
+        config['credentials'],
+        'dev_lms',
+        'auth_key',
+        cookie_expiry_days=30
+    )
+    
+    # Sidebar for navigation
+    with st.sidebar:
+        st.title("📚 Dev LMS")
+        st.markdown("---")
+        
+        if not st.session_state.authenticated:
+            st.info("Please login to access the LMS")
+        else:
+            st.success(f"Welcome, {st.session_state.username}!")
+            st.markdown("---")
+            
+            # Navigation
+            page = st.selectbox(
+                "Navigation",
+                ["Dashboard", "Upload Documents", "My Documents", "Document Library", "Settings"]
+            )
+    
+    # Main content area
+    if not st.session_state.authenticated:
+        # Login page
+        st.title("🔐 Login to Dev LMS")
+        st.markdown("---")
+        
+        col1, col2, col3 = st.columns([1, 2, 1])
+        with col2:
+            name, authentication_status, username = authenticator.login('Login', 'main')
+            
+            if authentication_status == False:
+                st.error('Username/password is incorrect')
+            elif authentication_status == None:
+                st.warning('Please enter your username and password')
+            elif authentication_status:
+                st.session_state.authenticated = True
+                st.session_state.username = username
+                st.success(f'Welcome {name}')
+                st.rerun()
+        
+        # Show default credentials
+        with st.expander("Default Login Credentials"):
+            st.markdown("""
+            **Default Users:**
+            - **Admin**: username: `admin`, password: `admin123`
+            - **Teacher**: username: `teacher`, password: `teacher123`
+            - **Student**: username: `student`, password: `student123`
+            """)
+    
+    else:
+        # Authenticated user content
+        if 'page' not in locals():
+            page = "Dashboard"
+        
+        if page == "Dashboard":
+            show_dashboard()
+        elif page == "Upload Documents":
+            show_upload_documents()
+        elif page == "My Documents":
+            show_my_documents()
+        elif page == "Document Library":
+            show_document_library()
+        elif page == "Settings":
+            show_settings()
+        
+        # Logout button
+        st.sidebar.markdown("---")
+        if st.sidebar.button("Logout"):
+            st.session_state.authenticated = False
+            st.session_state.username = None
+            st.rerun()
+
+def show_dashboard():
+    """Show the main dashboard"""
+    st.title("📊 Dashboard")
+    st.markdown("---")
+    
+    col1, col2, col3 = st.columns(3)
+    
+    with col1:
+        st.metric(
+            label="My Documents",
+            value=len(st.session_state.uploaded_documents.get(st.session_state.username, [])),
+            delta="0"
+        )
+    
+    with col2:
+        total_docs = sum(len(docs) for docs in st.session_state.uploaded_documents.values())
+        st.metric(
+            label="Total Documents",
+            value=total_docs,
+            delta="0"
+        )
+    
+    with col3:
+        st.metric(
+            label="Active Users",
+            value=len(st.session_state.uploaded_documents.keys()),
+            delta="0"
+        )
+    
+    st.markdown("---")
+    
+    # Recent activity
+    st.subheader("📈 Recent Activity")
+    if st.session_state.uploaded_documents.get(st.session_state.username):
+        recent_docs = st.session_state.uploaded_documents[st.session_state.username][-5:]
+        for doc in recent_docs:
+            with st.container():
+                col1, col2, col3 = st.columns([3, 2, 1])
+                with col1:
+                    st.write(f"**{doc['filename']}**")
+                with col2:
+                    st.write(doc['upload_time'])
+                with col3:
+                    st.write(f"{doc['file_type']}")
+                st.markdown("---")
+
+def show_upload_documents():
+    """Show document upload interface"""
+    st.title("📤 Upload Documents")
+    st.markdown("---")
+    
+    uploaded_file = st.file_uploader(
+        "Choose a PDF file",
+        type=['pdf'],
+        help="Upload PDF documents to the LMS"
+    )
+    
+    if uploaded_file is not None:
+        # Display file info
+        file_details = {
+            "Filename": uploaded_file.name,
+            "File size": f"{uploaded_file.size / 1024:.2f} KB",
+            "File type": uploaded_file.type
+        }
+        
+        st.write("**File Details:**")
+        for key, value in file_details.items():
+            st.write(f"- {key}: {value}")
+        
+        # Extract and display PDF content
+        pdf_text = extract_pdf_text(uploaded_file)
+        
+        if pdf_text.strip():
+            st.subheader("📄 Document Preview")
+            with st.expander("View extracted text"):
+                st.text_area("PDF Content", pdf_text, height=300)
+        
+        # Upload button
+        if st.button("Upload Document"):
+            # Save document info
+            save_document_info(
+                st.session_state.username,
+                uploaded_file.name,
+                uploaded_file.read(),
+                "PDF"
+            )
+            
+            st.success(f"✅ Document '{uploaded_file.name}' uploaded successfully!")
+            st.balloons()
+
+def show_my_documents():
+    """Show user's uploaded documents"""
+    st.title("📁 My Documents")
+    st.markdown("---")
+    
+    user_docs = st.session_state.uploaded_documents.get(st.session_state.username, [])
+    
+    if not user_docs:
+        st.info("You haven't uploaded any documents yet.")
+        return
+    
+    # Search functionality
+    search_term = st.text_input("🔍 Search documents", placeholder="Enter filename or content...")
+    
+    # Filter documents based on search
+    filtered_docs = user_docs
+    if search_term:
+        filtered_docs = [
+            doc for doc in user_docs
+            if search_term.lower() in doc['filename'].lower() or
+               search_term.lower() in doc.get('content', '').lower()
+        ]
+    
+    if not filtered_docs:
+        st.warning("No documents match your search criteria.")
+        return
+    
+    # Display documents
+    for i, doc in enumerate(filtered_docs):
+        with st.container():
+            col1, col2, col3, col4 = st.columns([3, 2, 1, 1])
+            
+            with col1:
+                st.write(f"**{doc['filename']}**")
+            
+            with col2:
+                st.write(doc['upload_time'])
+            
+            with col3:
+                st.write(f"{doc['file_type']}")
+            
+            with col4:
+                if st.button(f"View {i}", key=f"view_{i}"):
+                    st.subheader(f"📄 {doc['filename']}")
+                    st.write(f"**Uploaded:** {doc['upload_time']}")
+                    st.write(f"**Size:** {doc['size']} bytes")
+                    
+                    # Display content if available
+                    if 'content' in doc and doc['content']:
+                        st.text_area("Document Content", doc['content'], height=400, key=f"content_{i}")
+            
+            st.markdown("---")
+
+def show_document_library():
+    """Show all documents in the system"""
+    st.title("📚 Document Library")
+    st.markdown("---")
+    
+    if not st.session_state.uploaded_documents:
+        st.info("No documents have been uploaded to the system yet.")
+        return
+    
+    # Search functionality
+    search_term = st.text_input("🔍 Search all documents", placeholder="Enter filename, content, or username...")
+    
+    # Collect all documents
+    all_docs = []
+    for username, docs in st.session_state.uploaded_documents.items():
+        for doc in docs:
+            doc_copy = doc.copy()
+            doc_copy['owner'] = username
+            all_docs.append(doc_copy)
+    
+    # Filter documents based on search
+    filtered_docs = all_docs
+    if search_term:
+        filtered_docs = [
+            doc for doc in all_docs
+            if search_term.lower() in doc['filename'].lower() or
+               search_term.lower() in doc.get('content', '').lower() or
+               search_term.lower() in doc['owner'].lower()
+        ]
+    
+    if not filtered_docs:
+        st.warning("No documents match your search criteria.")
+        return
+    
+    # Display documents
+    for i, doc in enumerate(filtered_docs):
+        with st.container():
+            col1, col2, col3, col4, col5 = st.columns([3, 2, 1, 1, 1])
+            
+            with col1:
+                st.write(f"**{doc['filename']}**")
+            
+            with col2:
+                st.write(doc['upload_time'])
+            
+            with col3:
+                st.write(f"{doc['file_type']}")
+            
+            with col4:
+                st.write(f"By: {doc['owner']}")
+            
+            with col5:
+                if st.button(f"View {i}", key=f"lib_view_{i}"):
+                    st.subheader(f"📄 {doc['filename']}")
+                    st.write(f"**Uploaded by:** {doc['owner']}")
+                    st.write(f"**Uploaded:** {doc['upload_time']}")
+                    st.write(f"**Size:** {doc['size']} bytes")
+                    
+                    # Display content if available
+                    if 'content' in doc and doc['content']:
+                        st.text_area("Document Content", doc['content'], height=400, key=f"lib_content_{i}")
+            
+            st.markdown("---")
+
+def show_settings():
+    """Show user settings"""
+    st.title("⚙️ Settings")
+    st.markdown("---")
+    
+    st.subheader("👤 User Information")
+    st.write(f"**Username:** {st.session_state.username}")
+    st.write(f"**Session ID:** {id(st.session_state)}")
+    
+    st.markdown("---")
+    
+    st.subheader("🔧 System Information")
+    st.write("**Version:** Dev LMS v1.0")
+    st.write("**Features:**")
+    st.write("- User authentication")
+    st.write("- PDF document upload")
+    st.write("- Document search and preview")
+    st.write("- Document library")
+    
+    st.markdown("---")
+    
+    # Export data option
+    if st.button("📥 Export My Data"):
+        user_docs = st.session_state.uploaded_documents.get(st.session_state.username, [])
+        if user_docs:
+            # Create JSON export
+            export_data = {
+                'username': st.session_state.username,
+                'export_date': datetime.now().isoformat(),
+                'documents': user_docs
+            }
+            
+            st.download_button(
+                label="Download JSON Export",
+                data=json.dumps(export_data, indent=2),
+                file_name=f"{st.session_state.username}_data_export.json",
+                mime="application/json"
+            )
+        else:
+            st.info("No data to export.")
+
+if __name__ == "__main__":
+    main()