How medamine-bahassou/hiregen works
Project type and purpose
• This is a full-stack web application called HireGen, whose purpose is to generate structured “fiches de mission” (mission briefs) via an AI chat integration (Groq) and persist/manage them for recruiters.
• Key use case: User enters a brief text description in the UI → AI generates a detailed JSON mission brief → the app stores, displays, and allows editing of these briefs.
File structure
Top-level structure:
• hiregen1.Server – ASP.NET Core 8 Web API project
└ Controllers → HTTP endpoints
└ Data → EF Core DbContext + Migrations → MySQL persistence
└ Models → domain entities (Mission, WeatherForecast)
└ appsettings.json → connection strings + config
• hiregen1.client – React + Vite SPA
└ src/components → Chat UI (GroqChat.jsx), MissionUpdateForm, MissionHistory, Navbar
└ src/main.jsx + index.html → app bootstrap
└ public → static assets
└ package.json → npm scripts, dependencies, VITE_GROQ_API_KEY env
• hiregen1.sln – solution glue
• .gitignore, README.md
README for additional insights
• Architecture described: React frontend, ASP.NET Core backend, EF Core + MySQL, external Groq AI service.
• Workflow: frontend sends prompt to Groq API (via client), receives JSON → posts or fetches data from backend → backend persists via EF Core → frontend reads mission history.
a. Main components
• User’s Web Browser (UI)
• Frontend SPA (React + Vite)
• Backend Web API (ASP.NET Core)
• Database (MySQL)
• External AI Service (Groq API)
b. Relationships & data-flow
1. User interaction → SPA UI
2. SPA calls GroqChat component → Groq REST API (AI generation)
3. Groq API returns JSON mission brief → SPA parses & displays
4. SPA issues HTTP POST/GET to ASP.NET API → Controllers (e.g., GroqApiResponsesController)
5. Controller uses EF Core DbContext → MySQL
6. SPA fetches mission history & details via API
c. Architectural patterns/design principles
• Client-side single-page application (SPA)
• RESTful API backend (Controller-Service-Repository pattern implied)
• ORM layer via Entity Framework Core for data access
• External integration abstracted in client component (GroqChat.jsx)
d. Relevant technologies
• Frontend: React, Vite, CSS
• Backend: .NET 8, ASP.NET Core, EF Core, C#
• Database: MySQL
• External: Groq AI REST API