PilarEaseDJO

PilarEase - An Emotional Support Platform for Pilar College students, providing resources and a supportive community to foster emotional well-being.

📱 Interface Preview

PilarEase Home	Login Interface	Register Interface
Profile Setting	Avatar Options	Password Manager
Chat Interaction	Manage Referral	Profanity Filtering

🔍 Overview

PilarEaseDJO is a Django-based emotional support platform designed specifically for Pilar College students. The platform combines modern web technologies with machine learning to provide a safe, supportive environment where students can express themselves, receive guidance, and access mental health resources.

Key components include:

• Emotion-based status sharing with sentiment analysis
• AI-powered chatbot for emotional assessment and support
• Profanity filtering and content moderation
• Counselor referral system for professional support
• Administrative tools for the ITRC team

---

⚙️ Installation

Prerequisites

• Python 3.8+
• Supabase account (PostgreSQL)
• Git

1. Clone the Repository

git clone https://github.com/KCprsnlcc/PilarEaseDJO.git
cd PilarEaseDJO

2. Set Up Virtual Environment

For macOS/Linux:

python3 -m venv .venv
source .venv/bin/activate

For Windows:

# Optional: Set PowerShell execution policy
Set-ExecutionPolicy RemoteSigned -Scope Process -Force

# Create and activate virtual environment
python -m venv .venv
.venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt --progress-bar on

4. Configure Database

Set up a Supabase project and configure your environment variables.

The application connects to Supabase using direct API integration. Create a .env file in your project root with the following variables (replace with your Supabase credentials):

# Supabase credentials
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

# Django settings
SECRET_KEY=your_django_secret_key
DEBUG=True

# Email settings
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_HOST_USER=your_email@gmail.com
EMAIL_HOST_PASSWORD=your_app_password
EMAIL_USE_TLS=True

5. Apply Database Migrations

python manage.py migrate

6. Start Development Server

python manage.py runserver

7. Access the Application

Open your browser and navigate to:

http://localhost:8000

8. Docker Deployment (Alternative)

You can also use Docker for deployment:

docker-compose up --build

---

✨ Features

🔐 User Authentication & Management

Secure Login/Logout	Session tracking with audit trails and secure session termination
Smart Registration	Enrollment masterlist verification with auto/manual approval workflows
Password Recovery	Email-based reset with rate limiting and expiring tokens
Email Verification	Account verification and email change management

👤 User Profile & Personalization

Profile Management	Update personal details, contact info, and academic information
Password Security	Secure password updates with current password verification
Customizable Avatars	Upload and select from various avatar options with validation
Session Analytics	Track login sessions and device information

🏠 Interface & Navigation

Modern UI/UX	Intuitive navigation with responsive design
Information Pages	About page with platform details and testimonials
Contact System	User inquiry submission with admin review functionality
Dynamic Dashboard	Personalized activity feed with status updates and analytics

📝 Status & Content Management

Emotion-Based Posting	Share statuses with automatic emotion analysis
Content Moderation	AI-powered profanity filtering and inappropriate content detection
Categorized Views	Filter content by recency, popularity, or emotional categories
Counselor Referrals	Flag concerning content for professional review

🤖 Emotional Intelligence & Chatbot

Sentiment Analysis	ML-powered emotion detection with detailed breakdown
Interactive Chatbot	Guided emotional assessment with adaptive questioning
Response Validation	Smart response processing with follow-up recommendations
Chat History	Interaction logs with pagination

🧠 AI & Machine Learning

Emotion Classification	Transformer-based model for accurate emotion detection
Content Safety	Multi-layered profanity filtering with custom dictionaries
Sentiment Scoring	Analyze feedback and user content for tone and intent

🔔 Notifications & Activity Tracking

Real-time Alerts	Instant notifications for interactions and updates
Activity Feed	Chronological display of status replies and interactions
Preference Settings	Customizable notification options with highlight system

🛠️ Administrative Tools

Admin Dashboard	Control panel with secure access
User Verification	Review and approval workflows
Bulk Operations	Efficient management of multiple accounts simultaneously
Enrollment Management	Upload and manage student enrollment data
Audit System	Detailed activity logging for administrative actions

👩‍⚕️ Counselor Support System

Referral Dashboard	Organized interface for managing student referrals
Interaction Review	Access to chatbot histories for assessment
Appointment Scheduling	Calendar integration for counseling sessions

📊 Analytics & Reporting

Engagement Metrics	User activity and session analytics
Emotional Insights	Visual representations of emotion trends and distributions
Usage Reports	Exportable data for institutional reporting

## 🚀 Deployment

Local Deployment

Follow the installation instructions above to set up a local development environment.

Docker Deployment

A Dockerfile and docker-compose.yml are provided for containerized deployment with Supabase integration:

# Make sure your .env file contains the required variables (SUPABASE_URL, SUPABASE_KEY, etc.)
docker-compose up --build

Railway Deployment

This project is configured for deployment on Railway with railway.json configuration.

🔧 Technology Stack

• Backend: Django 5.0+, Python 3.8+
• Database: PostgreSQL (via Supabase)
• Frontend: HTML5, CSS3, JavaScript, Bootstrap
• AI/ML: Hugging Face Transformers, NLTK, TextBlob
• Containerization: Docker
• Security: Django security middleware, CSRF protection, rate limiting

👥 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

This project is licensed under the MIT License - see LICENSE.md for details.

📞 Support

For support or inquiries, please contact the development team at pilarease@pilarcollege.edu.

11. System Notifications & Alerts for ITRC Staff

• Custom Notifications: Admins can broadcast notifications for all users or selected groups.
• Notification History: Maintains a log of all sent notifications for reference and audit.
• Email and SMS Alerts: Sends email and SMS notifications for significant user actions (e.g., password resets, account status changes).

12. User Demographic Insights

• Role-Based Insights: Distribution of user roles (e.g., ITRC staff, counselor, student) for system demographics.
• Verification Status Overview: Tracks user verification statuses (verified, pending, rejected).

---

Contributing

Contributions are welcome! Please refer to the Contribution Guidelines for details.

---

License

This project is licensed under the terms outlined in the License.

---

Support

For inquiries or issues, please contact kcpersonalacc@gmail.com.

---

Note: PilarEase is under active development, and features may evolve as enhancements and fixes are applied.