---

🎓 CampusGuardian

Learn. Connect. Grow.

CampusGuardian is a comprehensive university community application designed to bridge the gap between students, alumni, and professors. It facilitates mentorship, peer-to-peer skill sharing, and knowledge exchange in a centralized, user-friendly platform.

---

🚀 Features

1. 🤝 Mentorship System

Connect with experienced seniors, alumni, and professors.

• Find Mentors: Browse mentor profiles filtered by expertise and availability.
• Book Sessions: Schedule sessions based on real-time mentor availability slots.
• Session Management: Track pending, confirmed, and completed sessions with status updates.
• Feedback & Ratings: Rate sessions and provide feedback to ensure quality mentorship.
• Mentor Dashboard: Users can toggle their availability and manage their mentor profile details.

2. 📚 Knowledge Hub (MicroTalks)

A social feed for sharing academic insights and articles.

• Posts Feed: View and interact with posts created by the community.
• Create & Edit: Rich text support for creating posts with thumbnail images.
• Engagement: Like and comment on posts to foster discussion.

3. 🔄 Skill Exchange

A peer-to-peer marketplace for learning.

• Exchange Offers: Post "I can teach X, I want to learn Y" offers.
• History: View past and closed exchange requests.
• Connect: Direct integration with chat to propose exchanges.

4. 💬 Communication

• Private Chat: Real-time 1-on-1 messaging with read receipts and online status indicators.
• AI KnowledgeBot: An intelligent chatbot powered by Google Gemini AI to answer student queries instantly.

5. 👤 User Profile

• Academic Identity: Manage university details, session, batch, and CGPA.
• Social Links: Integration for LinkedIn and Facebook profiles.
• Security: Secure login, signup, and password management.

---

🛠️ Tech Stack

• Framework: Flutter (Dart)
• Backend: Firebase (Auth, Firestore, Storage)
• AI Integration: Google Generative AI (Gemini)
• State Management: setState, StreamBuilder
• Navigation: go_router
• Key Packages:
  • cloud_firestore, firebase_auth
  • google_generative_ai
  • flutter_markdown, gpt_markdown
  • shared_preferences
  • url_launcher

---

📸 Screenshots

Splash Screen-1	Login-2

Sign Up-3	Reset Password-4

ResetPassword throughLink-5	Change Password-6

dashboard-7	findMentor-8

Mentor profile-9	book session-10

My session-11	feedback-12

session and feedback-13	mentee profile-14

Edit profile-15	messageBox-16

chat page-17	mentorship setting-18

Mypost_knowledgeHub-19	nested comment-20

skill exchange-21	edit skill exchange-22

Search-23	knowledge bot-24

---

⚙️ Installation & Setup

Follow these steps to run the project locally.

Prerequisites

• Flutter SDK (Version ^3.8.1 or higher)
• Dart SDK
• A Firebase Project

1. Clone the Repository

git clone https://github.com/your-username/campus-guardian.git
cd campus-guardian

2. Install Dependencies

flutter pub get

3. Firebase Configuration

This project uses flutterfire_cli for Firebase configuration.

1. Ensure you have the Firebase CLI installed.
2. Run the following command to link your Firebase project:

   flutterfire configure

   This will generate the firebase_options.dart file in lib/.

4. Environment Variables

Create a .env file in the root directory and add your Gemini API key:

GEMINI_API_KEY=your_api_key_here

(Make sure to add .env to your .gitignore file)

5. Run the App

flutter run

---

📂 Project Structure

lib/
├── core/               # App-wide constants (Routes, Theme)
├── features/           # Feature-based modules
│   ├── auth/           # Login, Signup, Auth Gate
│   ├── chat/           # Private messaging
│   ├── dashboard/      # Home screen & Global Search
│   ├── knowledgebot/   # Gemini AI Chatbot
│   ├── mentorship/     # Mentor booking & listing
│   ├── microtalks/     # Posts & Knowledge Hub
│   ├── profile/        # User profile & settings
│   ├── skill_exchange/ # Skill swap marketplace
│   └── splash/         # Splash screen
├── services/           # Firebase & API services
└── widgets/            # Reusable UI components

---

🚀 Future Improvements

🔔 Notifications & Real-Time Updates

• Push Notifications: Implement Firebase Cloud Messaging (FCM) to notify users of new messages, session bookings, and replies. (Currently, the NotificationService is drafted but not fully integrated).
• In-App Alerts: Add a notification center to view past alerts and updates.

💬 Enhanced Chat Features

• Media Sharing: Allow users to send images, documents, and voice notes in private chats (currently text-only).
• Typing Indicators: Add real-time "User is typing..." indicators in private 1-on-1 chats.
• Group Chats: Enable group conversations for study groups or project teams.

🤖 AI Bot Enhancements

• Contextual Memory: Update AiBotService to send the conversation history to the Gemini API, allowing the bot to remember previous context within a session.
• Custom Personas: Allow the bot to switch "modes" (e.g., "Career Counselor," "Academic Advisor," "Code Reviewer").

📅 Advanced Mentorship

• Video Integration: Integrate Jitsi or Agora for in-app video/audio calls during mentorship sessions.
• Calendar Sync: Integrate with Google Calendar or Outlook to automatically add booked sessions to the user's personal calendar.
• Session Reminders: automated reminders 15 minutes before a session starts.

🎨 UI/UX & Customization

• Dark Mode: Implement a system-aware Dark Mode (currently hardcoded to AppTheme.lightTheme).
• Localization: Add support for multiple languages (e.g., Bengali/English toggle) to serve a broader student base.
• Onboarding Flow: Create a dedicated onboarding tutorial for new users to explain features like "Wisdom Credits."

🛠 Technical Optimizations

• State Management: Migrate complex screens from setState to a more robust solution like Riverpod or Bloc for better scalability.
• Offline Support: Optimize Firestore caching to allow users to view their schedule and saved posts while offline.
• Admin Panel: Create a web-based admin panel to moderate posts, verify mentors, and manage reported content.

---

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/YourFeature).
3. Commit your changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a Pull Request.

---

👨‍💻 Developer

Developed by Abdullah Nazmus-Sakib CSE, Jahangirnagar University

---

📄 License

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