Skip to content

ModelSettlers/jsrb

Repository files navigation

🚀 Reverse Job Board 🌟

Welcome to the Reverse Job Board, the ultimate tool for individuals and organizations to manage their skills, track what they have, and identify what they need to conquer the world! This is not your typical job board. Oh no! We're flipping the script and empowering you to manage your skills like a boss.

With this platform, you'll:

  • Manage your skills like a rockstar.
  • Track both Need and Have values for each skill.
  • Keep your progress stored in a slick SQLite database.
  • Add skills dynamically and make them work for you.

If you're into personal growth, team skill management, and maybe a little world domination, you've come to the right place.


🔥 Features

Here’s what this bad boy can do:

  • Skills Management – Track, update, and manage the skills you need and have.
  • Live Updates – Use the + and - buttons to adjust your skill levels in real-time. Get those numbers up!
  • Persistent Data – All your hard work is stored in a local SQLite database for consistency.
  • Easy Skill Addition – Add new skills to your profile with zero hassle. Start with Need and Have set to 0.
  • Sleek UI – Simple, clean, and interactive design. Manage your skills like a boss.
  • Minimal & Fast – No bloat, just the good stuff. Get up and running in no time!

📜 Table of Contents

  1. Installation
  2. Setting Up the Database
  3. Running the Application
  4. Folder Structure
  5. Usage
  6. Contributing
  7. License

🚀 Installation

Get yourself set up with Reverse Job Board in just a few steps. We’re going full throttle!

Example Screenshot

Prerequisites

Before you get started, make sure you have:

  • Python 3.x (tested with 3.9 and later)
  • SQLite (don’t worry, it’s built-in!)
  • A wild love for personal development, skills, and growth

Steps

  1. Clone the repository:

    git clone https://github.com/yourusername/reverse-job-board.git
    cd reverse-job-board
  2. Create a virtual environment (Let’s keep things tidy):

    python3 -m venv venv
    source venv/bin/activate  # For Windows: `venv\Scripts\activate`
  3. Install the dependencies:

    pip install -r requirements.txt

⚙️ Setting Up the Database

First time running? No worries! The app will take care of the database setup for you.

To initialize the database:

  1. Automatic Initialization: The app will auto-create your database when it runs. But if you're a control freak (like us), you can initialize it manually by running the init_db() function in app.py.

    def init_db():
        with sqlite3.connect(DB_PATH) as conn:
            cursor = conn.cursor()
            cursor.execute('''CREATE TABLE IF NOT EXISTS skills (
                                id INTEGER PRIMARY KEY,
                                name TEXT UNIQUE NOT NULL,
                                need INTEGER NOT NULL,
                                have INTEGER NOT NULL)''')
            conn.commit()

🏃‍♂️ Running the Application

Now that we’re set up, it’s time to launch this beast and make it yours!

  1. Run the server: In your terminal, fire up the server with:

    python app.py
  2. Access the app: Open your browser and navigate to http://localhost:8000/skills. BOOM, you’re in!


📂 Folder Structure

Here’s the rundown of the folder structure so you can see the magic behind the scenes:

Folder/File What’s Inside
reversejobboard/ The heart of the project.
app.py The brains behind the operation (Python code for the app).
skills.db Your personal skill ledger (SQLite database for storing your data).
templates/ If you need to tweak things, here’s where the HTML templates live (optional).
static/ CSS, JS, all that jazz.
static/style.css The style that makes everything look sharp.
static/script.js JavaScript that powers the dynamic interactions (e.g., updating counters).
README.md This awesome documentation.
requirements.txt All the Python packages you need to run the app.

📋 Usage

Once the application is running, here's how you can rock it:

  1. View Your Skills: All your skills (and their current values) are listed on the dashboard.
  2. Update Skills: Hit the + and - buttons to adjust your "Need" and "Have" counts.
  3. Add New Skills: Type in a new skill, click "Add Skill", and voila! It’ll show up with the default values of 0 for "Need" and "Have".
  4. All Your Data is Saved: The app stores your changes in SQLite, so you never lose track of your progress.

💥 Contributing

Want to make this project even better? Contributing is easy!

  1. Fork the repo on GitHub.
  2. Create a new branch for your feature (git checkout -b feature-name).
  3. Make your changes and commit them (git commit -am 'Add new feature').
  4. Push your changes to your forked repo (git push origin feature-name).
  5. Create a pull request to merge your changes into the main repo.

🛡️ License

This project is licensed under the MIT License.


Feel free to fork, clone, and contribute. The Reverse Job Board is here to stay, and with your help, it can only get better. 🚀💡


🎉 That’s it, folks! Let’s get those skills managed and turn this board into a global movement! 🌍✨