# JobyApp

> AI-Powered Job Search & Application Automation Platform that combines intelligent job scraping from multiple sources, AI-powered job-candidate matching, and automated generation of personalized application documents.

JobyApp streamlines the entire job hunting process with a comprehensive multi-service architecture including job discovery, profile analysis, document generation, and application management.

## Core API Documentation

- [API Documentation](https://www.jobyapp.live/api): Complete RESTful API documentation with authentication, job search, and document generation endpoints
- [Authentication System](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-docs/api/AUTHENTICATION.md): JWT-based authentication with Google OAuth integration and secure session management
- [Job Search API](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/routes/jobs.js): Multi-platform job scraping from LinkedIn, Indeed, WTTJ, HelloWork, and France Travail with advanced filtering
- [Document Generation API](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-docs/api/DOCUMENT_SERVICE_API.md): Automated CV and cover letter generation using customizable DOCX templates
- [Profile Management](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/routes/profile.js): User profile system with skills, experience, and AI-powered profile analysis

## Architecture & System Design

- [System Architecture](https://www.jobyapp.live/architecture): Complete overview of multi-service architecture with frontend (Astro/React), backend (Node.js/Express), and Python processing pipeline
- [Database Schema](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-docs/architecture/DATABASE_SCHEMA.md): PostgreSQL database design with user management, job storage, and document generation models
- [Python Processing Pipeline](https://github.com/koukouvagabou/JobyApp/tree/main/jobyapp-server/python): Background processing for job scraping, document generation, and AI integration using OpenAI GPT models
- [Caching & Performance](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/services/cacheService.js): Redis-based caching system for API optimization and rate limiting

## Frontend Documentation

- [Component Library](https://github.com/koukouvagabou/JobyApp/tree/main/square-spiral/src/components): React/Astro component reference with dashboard, templates, interview, and profile management components
- [User Interface Guide](https://www.jobyapp.live/docs): Complete UI/UX documentation with responsive design and multi-language support (French/English)
- [State Management](https://github.com/koukouvagabou/JobyApp/tree/main/square-spiral/src/hooks): Custom React hooks for API integration, authentication, and real-time WebSocket updates
- [Styling System](https://github.com/koukouvagabou/JobyApp/blob/main/square-spiral/src/styles/globals.css): Tailwind CSS-based design system with consistent theming and responsive layouts

## Development & Deployment

- [Getting Started Guide](https://www.jobyapp.live/docs): Complete development setup with Node.js, Python, PostgreSQL, and Redis configuration
- [Environment Configuration](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/.env.example): Detailed environment variables setup for local development and production deployment
- [CI/CD Pipeline](https://github.com/koukouvagabou/JobyApp/tree/main/.github/workflows): GitHub Actions workflows for automated testing, deployment, and quality assurance
- [Testing Framework](https://github.com/koukouvagabou/JobyApp/tree/main/tests): Playwright-based end-to-end testing with comprehensive coverage of user flows

## Optional

- [Production Deployment](https://github.com/koukouvagabou/JobyApp/tree/main/Docs/Deploy): Heroku backend deployment and Vercel frontend hosting with DNS configuration
- [Security Implementation](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/middleware/security.js): Security middleware with rate limiting, CORS, helmet.js, and input validation
- [Monitoring & Analytics](https://github.com/koukouvagabou/JobyApp/blob/main/jobyapp-server/routes/analytics.js): Performance monitoring, usage tracking, and system health checks
- [Document Templates](https://github.com/koukouvagabou/JobyApp/tree/main/square-spiral/src/components/templates): Template management system for DOCX-based CV and cover letter generation