Skip to content

Update README.md #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
magdaDas wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update README.md #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
195 changes: 132 additions & 63 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,64 +1,133 @@
# 🗺️ JobHunter - Intelligent Job Board
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>🗺️ Job Hunter 2024 - Intelligent Job Board</title>
</head>
<body>
<h1>🗺️ Job Hunter 2024 - Intelligent Job Board</h1>
<div class="badges">
<a href="https://www.python.org/" target="_blank"><img src="https://img.shields.io/badge/python-3.9-blue" alt="Python Version"></a>
<a href="https://www.php.net/" target="_blank"><img src="https://img.shields.io/badge/php-8.0-blue" alt="PHP Version"></a>
<a href="https://reactjs.org/" target="_blank"><img src="https://img.shields.io/badge/react-18.2.0-blue" alt="React Version"></a>
<a href="https://www.typescriptlang.org/" target="_blank"><img src="https://img.shields.io/badge/typescript-4.9-blue" alt="TypeScript"></a>
<a href="https://nodejs.org/" target="_blank"><img src="https://img.shields.io/badge/node.js-18.16.0-green" alt="Node.js"></a>
<a href="https://laravel.com/" target="_blank"><img src="https://img.shields.io/badge/laravel-8.0-red" alt="Laravel Version"></a>
</div>
<h2>🚀 About the Project</h2>
<p>JobHunter is an intelligent platform for viewing jobs and IT events in Romania, featuring:</p>
<ul>
<li>🏯️ Interactive maps with location clusters</li>
<li>📌 Semantic ontology for classification</li>
<li>🤖 AI-based recommendation system</li>
<li>📊 Real-time event statistics</li>
<li>🔍 Advanced search capabilities</li>
</ul>
## About the Project

[![React Version](https://img.shields.io/badge/react-18.2.0-blue)](https://reactjs.org/)
[![Leaflet Version](https://img.shields.io/badge/leaflet-1.9.4-green)](https://leafletjs.com/)

An intelligent platform for viewing jobs in Romania and IT events, integrating:
- **Interactive maps** with location clusters
- **Semantic ontology** for classifying jobs and events
- **Recommendation system** based on preferences
- **Event statistics**
- **Search for events**

![Demo Screenshot](screenshot.png)

## 🚀 Key Features
- ✔️ Geographical view of jobs with dynamic clusters
- 🔍 Ontology-based intelligent filtering
- 📌 Semantic recommendation system
- 📊 Dashboard with statistics
- 🔗 SPARQL endpoint integration

## 🛠️ Tech Stack
**Frontend:**
- React 18 + TypeScript
- Leaflet + React-Leaflet
- React-Bootstrap (UI)
- Axios (comunicare API)

**Backend/Semantic:**
- API Node.js
- Apache Jena Fuseki (SPARQL endpoint)
- Ontologie OWL2
- Python
- PHP
- FastAPI
-
### :key: Environment Variables

To run this project, you will need to add the following environment variables to your .env file

`API_STORE_EVENT_TRIPLE`
`FRONTEND_URL`
`RSS_FEED_URL`
`JOB_HUNTER_QUERY_API_URL`
`JOB_HUNTER_API_USERNAME`
`JOB_HUNTER_API_PASSWORD`
`ONTOLOGY_URL`
`PAPERTRAIL_HOST`
`PAPERTRAIL_PORT`


## 📦 Installation
1. Clone the repository:
```bash
git clone https://github.com/JobHunter2024/BetaTeam.git
```

## 💎 Acknowledgements
Useful resources and libraries that we have used in out project.

skillNer
Protégé
Stanza
spaCY
This **#project** is part of a larger collaborative initiative that we built together with our colleagues for the **#Wade** class at Alexandru Ioan Cuza University of Iași (**#infoiasi**). As part of our **#Web Development** course, we combined our skills and ideas to create a cutting-edge **#web** application that addresses real-world challenges in the job listing domain. This endeavor not only highlights our technical expertise but also our commitment to teamwork and innovation.
<h2>📚 Table of Contents</h2>
<ol>
<li><a href="#tech-stack">🛠️ Tech Stack</a></li>
<li><a href="#installation">📦 Installation</a></li>
<li><a href="#environment">🔧 Environment Variables</a></li>
<li><a href="#screenshots">📸 Screenshots</a></li>
<li><a href="#team">👥 Team</a></li>
<li><a href="#resources">📂 Resources</a></li>
<li><a href="#acknowledgements">💎 Acknowledgements</a></li>
<li><a href="#tags">🏷️ Tags</a></li>
</ol>
<h2 id="tech-stack">🛠️ Tech Stack</h2>
<h3>🌐 Frontend</h3>
<ul>
<li>⚪ React 18 + TypeScript</li>
<li>🌟 React-Bootstrap</li>
<li>🏯️ Leaflet/React-Leaflet</li>
<li>🔗 Axios</li>
</ul>
<h3>🔩 Backend</h3>
<ul>
<li>🐍 Python 3.9 (Data Processing)</li>
<li>⚡ Node.js + Express</li>
<li>🐘 PHP Laravel 8</li>
<li>📡 Apache Jena Fuseki</li>
<li>🧠 OWL2 Ontology</li>
</ul>
<h2 id="installation">📦 Installation</h2>
<ol>
<li>🔹 Clone the repository:
<pre><code>git clone https://github.com/JobHunter2024/BetaTeam.git</code></pre>
</li>
<li>🔹 Install dependencies:
<pre><code>cd "Roca Maria/SparqlEndpoint"
npm install</code></pre>
</li>
<li>🔹 Start the server:
<pre><code>php artisan serve</code></pre>
</li>
</ol>
<h2 id="environment">🔧 Environment Variables</h2>
<div class="env-section">
<h3>🔑 CiobanuAna/Processing/.env</h3>
<pre>
API_STORE_EVENT_TRIPLE=
FRONTEND_URL=
RSS_FEED_URL=
JOB_HUNTER_QUERY_API_URL=
JOB_HUNTER_API_USERNAME=
JOB_HUNTER_API_PASSWORD=
ONTOLOGY_URL=
PAPERTRAIL_HOST=
PAPERTRAIL_PORT=</pre>
</div>
<div class="env-section">
<h3>🔑 Roca Maria/SparqlEndpoint/.env</h3>
<pre>
SERVER_PORT=
JOB_HUNTER_UPDATE_API_URL=
JOB_HUNTER_QUERY_API_URL=
JOB_HUNTER_API_USERNAME=
JOB_HUNTER_API_PASSWORD=
PYTHON_SCRIPT_PATH=
PAPERTRAIL_HOST=
PAPERTRAIL_PORT=</pre>
</div>
<h2 id="screenshots">📸 Screenshots</h2>
<div class="screenshots">
<img src="https://github.com/JobHunter2024/BetaTeam/blob/main/Documentation/map.png" alt="Map Interface" style="width: 60%;">
<p>🌍 Interactive job/event map clusters</p>
<img src="https://github.com/JobHunter2024/BetaTeam/blob/main/Documentation/documentation_images/pieChart.png" alt="Statistics Dashboard" style="width: 60%;">
<p>📈 Event distribution analytics</p>
</div>
<h2 id="team">👥 Team & Contributors</h2>
<div class="team-section">
<h3>🌟 Core Team</h3>
<ul>
<li>👩💻 Ciobanu Ana</li>
<li>👩💻 Roca Maria-Magdalena</li>
</ul>
<h3>🤝 Contributors</h3>
<ul>
<li>👩💻 Harton Amalia</li>
<li>👨💻 Habasescu Andrei</li>
</ul>
</div>
<h2 id="resources">📂 Resources</h2>
<ul>
<li>📄 <a href="https://github.com/JobHunter2024/BetaTeam/tree/main/Documentation">Technical Documentation</a></li>
<li>📜 <a href="https://github.com/JobHunter2024/BetaTeam/tree/main/openAPIspecifications">API Specifications</a></li>
<li>🎥 <a href="https://drive.google.com/file/d/1TtBJh8zh-k3DXM9MzoIYm6JunJv8VYH9/view">Demo Video</a></li>
</ul>
<h2 id="acknowledgements">💎 Acknowledgements</h2>
<ul>
<li>🛠️ <a href="https://github.com/animesh-sk/skillNER">skillNER</a></li>
<li>🏢 <a href="https://protege.stanford.edu/">Protégé</a></li>
<li>🌐 <a href="https://stanfordnlp.github.io/stanza/">Stanza</a></li>
<li>🧠 <a href="https://spacy.io/">spaCy</a></li>
</ul>
<footer>
<h3>🏷️ Tags</h3>
<p>#project #infoiasi #wade #web #WebDevelopment #JobHunter</p>
</footer>
</body>
</html>