Internary AI Assistant

# Internary - Internship Platform Overview

Internary is a modern, full-stack web application designed to connect students and recent graduates with internship opportunities. It provides a centralized platform for companies to post and manage internships, and for students to discover and apply for them. The application is built with a modern tech stack, featuring role-based access control (Student, Company, Admin), real-time data fetching, and AI-powered assistance for applicants.

## Core Features:

### Student/Applicant Features:
- **Internship Search & Filtering**: Comprehensive search and filtering by keyword, company, category, location, type, stipend, and pincode.
- **Internship Listings & Details**: Display of internships with essential information (title, company, location, duration, stipend) and detailed views including description, requirements, responsibilities, and company info.
- **Application Submission**: Users can apply for internships, with integrated AI assistance for cover letter generation.
- **Profile Management**: Complete student profiles including skills, resume, location, qualification tracking, and a profile completeness indicator.
- **Application History**: Track all submitted applications and their status (submitted, viewed, accepted, rejected).

### Company Features:
- **Company Registration & Profiles**: Companies can register, create profiles (logo, description, industry, contact), and showcase their brand.
- **Company Verification**: Admin approval workflow for new company registrations.
- **Internship Posting**: Post and manage internship listings with detailed descriptions, requirements, responsibilities, and stipend information.
- **Application Management**: View and manage received applications from students.
- **Company Dashboard**: Personalized dashboard for managing internships and applications.

### Admin Features:
- **Comprehensive Analytics Dashboard**: Real-time platform analytics including visitor metrics, engagement, time-series trends, device analytics, geographic data, session metrics, page analytics, and platform statistics (user counts, company status, internship distribution).
- **User Management**: View, filter, and manage user accounts by role.
- **Company Management**: Review, approve/reject, and manage company statuses, including blocking companies.
- **Application Management**: Oversee all applications across the platform.
- **Message Management**: Handle contact messages from users.

## AI Integration Details:
- **AI-Powered Cover Letters**: An integrated Genkit flow helps students generate professional cover letter drafts based on their profile and specific internship details.
- **AI Model**: The AI functionality uses the `gemini-2.5-flash` model.
- **API Key Requirement**: A `GEMINI_API_KEY` must be set in the `.env.local` file for the AI features to function correctly.

## Technical Stack:
- **Framework**: Next.js (App Router)
- **Language**: TypeScript (strict mode)
- **Styling**: Tailwind CSS, ShadCN UI
- **Database & Authentication**: Firebase (Firebase Auth for user authentication, Firebase Firestore for real-time database, Firebase Storage for image uploads like internship posters and company logos).
- **AI Integration**: Genkit (for AI functionality with `gemini-2.5-flash`).
- **Analytics**: Pure Firebase-based analytics with Firestore (no third-party services).
- **Deployment**: Vercel.
- **UI Components**: Radix UI, Lucide React for icons.
- **Data Visualization**: Recharts.
- **Animations**: Framer Motion.

## Getting Started:
1.  **Prerequisites**: Node.js (v18+), npm/yarn.
2.  **Clone Repository**: `git clone [repo_url]`
3.  **Install Packages**: `npm install`
4.  **Environment Variables**: Create `.env.local` with Firebase project config and `NEXT_PUBLIC_FIREBASE_...` variables. **Crucially, include `GEMINI_API_KEY` for AI features.**
5.  **Run Development Server**: `npm run dev`

## Deployment:
The application is configured for easy deployment on Vercel. After pushing code to a Git repository, import it into Vercel, add environment variables (including `GEMINI_API_KEY`) to Vercel project settings, and deploy.