{"id":20098685,"url":"https://github.com/ashlynn4567/employee-tracker","last_synced_at":"2026-05-02T08:33:14.411Z","repository":{"id":53324671,"uuid":"482087975","full_name":"ashlynn4567/Employee-Tracker","owner":"ashlynn4567","description":"Employee Tracker is an application that uses Node.js, Inquirer, and SQL to create a database that connects with the command line interface. Users can search for employee information by entering key words into each inquiry prompt. ","archived":false,"fork":false,"pushed_at":"2022-08-04T17:57:03.000Z","size":70703,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-02T16:48:02.942Z","etag":null,"topics":["consoletablejs","dotenv","inquirerjs","javascript","mysql2","nodejs","npm"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashlynn4567.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-15T21:24:00.000Z","updated_at":"2022-08-01T21:38:35.000Z","dependencies_parsed_at":"2022-09-02T04:22:31.716Z","dependency_job_id":null,"html_url":"https://github.com/ashlynn4567/Employee-Tracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ashlynn4567/Employee-Tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashlynn4567%2FEmployee-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashlynn4567%2FEmployee-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashlynn4567%2FEmployee-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashlynn4567%2FEmployee-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashlynn4567","download_url":"https://codeload.github.com/ashlynn4567/Employee-Tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashlynn4567%2FEmployee-Tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["consoletablejs","dotenv","inquirerjs","javascript","mysql2","nodejs","npm"],"created_at":"2024-11-13T17:06:16.616Z","updated_at":"2026-05-02T08:33:14.393Z","avatar_url":"https://github.com/ashlynn4567.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Employee Tracker\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Table-of-Contents\n\n- [Description](#description)\n- [Features](#features)\n- [Installation](#installation)\n- [Technologies](#technologies)\n- [Future Development](#future-development)\n- [Credits](#credits)\n\n## Description\n\nEmployee Tracker is an application that uses Node.js, Inquirer, and SQL to create a database that connects with the command line interface. Users can search for employee information by entering key words into each inquiry prompt. \n\nThis application is useful to employers who wish to track their employees in one central database. They can view departments, roles, or employee tables. They can also add, delete, or update each of these tables.\n\n## Features\n\nThis application is run using the user's terminal. Before running this application, please see the [Installation](#installation) section.\n\n1. It is invoked using the command `npm start`, which will then begin to prompt the user for input regarding which action they want to take to interact with their employee database.\n2. Users can navigate the menu to choose between the following options:\n   - View\n     - Departments\n     - Roles\n     - Employees\n   - Add\n     - Departments\n     - Roles\n     - Employees\n   - Delete\n     - Departments\n     - Roles\n     - Employees\n   - Update\n     - Employee's Role\n     - Employee's Manager\n3. If the user chooses to view:\n   - **departments**, then they are presented with a table showing the _department name_ and _department ID_.\n   - **roles**, then they are presented with a table showing the _job title_, _role ID_, _department ID_ that the role belongs to, and _salary_ for that role.\n   - **employees**, then they are presented with a table showing the employee data, including _employee ID_, _first name_, _last name_, _job title_, _department_, _salary_, and _manager_ that the employee reports to.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"A demonstration gif showing the user starting the application with the command 'npm start'. The terminal produces prompts asking what the user would like to do. The user can navigate the menu that appears to create (add), read (view), update, or delete employees, roles, or departments. This gif shows the user navigating through the view functions for departments, roles, and employees. Each menu shows the user a nicely formatted table with more information about each of those topics.\" src=\"./assets/images/employee-tracker-demo.gif\"/\u003e\n\u003cbr\u003eHere's a \u003ca href=\"https://drive.google.com/file/d/14LtnZmnGXcX4tiMS_4fKaWJqJxf4-9Pj/view\" target=\"_blank\"\u003elink\u003c/a\u003e to the video version of the above gif.\n\u003c/p\u003e\n\n4. Users can add departments, roles, or employees as well. Once they select these prompts, they will be asked to enter the relevant information to fill out the table within the employee tracker database. If the user views the tables after adding an element, they can see their changes in the corresponding tables.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"A demonstration gif showing the user adding a department, role, and employee. After the user enters the relevant information for each of these options, they can view the corresponding tables again to see that their new data has been added.\" src=\"./assets/images/employee-tracker-demo-2.gif\"/\u003e\n\u003cbr\u003eHere's a \u003ca href=\"https://drive.google.com/file/d/1IrLyyJofYABCGJzKCgP4ezqA8Ptu3wJn/view\" target=\"_blank\"\u003elink\u003c/a\u003e to the video version of the above gif.\n\u003c/p\u003e\n\n5. Users can delete departments, roles, or employees as well. After the deletion, the corresponding tables will update to show that the relevant data has been removed. Note that any links from other tables to the deleted information will become null.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"A demonstration gif showing the user deleting a department, role, and employee. After the deletion, the corresponding tables will update to show that the relevant data has been removed.\" src=\"./assets/images/employee-tracker-demo-3.gif\"/\u003e\n\u003cbr\u003eHere's a \u003ca href=\"https://drive.google.com/file/d/1RFrqKqw9HEfsFiEDZcmncNt4nsUlNZHx/view\" target=\"_blank\"\u003elink\u003c/a\u003e to the video version of the above gif.\n\u003c/p\u003e\n\n6. And finally, users can update employee information. They have the option to update the employee's role or manager.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"A demonstration gif showing the user adding a department, role, and employee. After the user enters the relevant information for each of these options, they can view the corresponding tables again to see that their new data has been added.\" src=\"./assets/images/employee-tracker-demo-4.gif\"/\u003e\n\u003cbr\u003eHere's a \u003ca href=\"https://drive.google.com/file/d/1SnRzKbNktA2SaONRK_va66s2Fd7TYqi_/view\" target=\"_blank\"\u003elink\u003c/a\u003e to the video version of the above gif.\n\u003c/p\u003e\n\n## Installation\n\nIn order to use this application, you will need to install it on your local computer.\n\n1. Open the command line interface.\n2. Clone the repository onto your local machine using the `git clone` command.\n3. Once the repository has been cloned, navigate into the root directory of the application using the command `cd Team-Profile-Generator`.\n4. This application has dependencies that must be installed prior to running the application (i.e. dotenv, inquirer, MySQL2, and console.table). Run the command `npm install` to install necessary packages and dependencies.\n5. This application relies on private enviromental variables. In the main directory of the application, create a `.env` file.\n   - The contents of your `.env` file should look like this, where [MySQL username] is your MySQL username, and [MySQL password] is your MySQL password:\n   ```\n   DB_NAME=\"employee_tracker\"\n   DB_USER=\"[MySQL username]\"\n   DB_PW=\"[MySQL password]\"\n   ```\n   - For example, if my username is `ashlynn4567` and my password is `password1234`, my `.env` file will look like the following:\n   ```\n   DB_NAME=\"employee_tracker\"\n   DB_USER=\"ashlynn4567\"\n   DB_PW=\"password1234\"\n   ```\n6. Next, you will need to seed the data. Note: You must have MySQL installed on your computer in order to seed the data.\n   - Log in to MySQL in your command line with the command `mysql -u root -p`.\n   - Enter your login credentials.\n   - Type the command `source db/schema.sql`.\n   - Next, type the command `source db/seeds.sql`.\n   - Quit MySQL with the command `quit`.\n7. Now you can start the application. Enter the command `npm start` in your terminal to begin.\n8. Navigate through the prompts in your command line interface using your keyboard.\n9. If you wish to quit the application at any time, simply type `ctrl + C`.\n\nFor further help with installation, please refer to the below demonstration video.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"A demonstration gif showing how to clone the repository to your local machine, install all necessary dependencies, create a .env file, and seed your database.\" src=\"./assets/images/employee-tracker-demo-5.gif\"/\u003e\n\u003cbr\u003eHere's a \u003ca href=\"https://drive.google.com/file/d/1kjlwdRrU_z9p4R0omZOK5NPl_s6_9WNK/view\" target=\"_blank\"\u003elink\u003c/a\u003e to the video version of the above gif.\n\u003c/p\u003e\n\n## Technologies\n\n- JavaScript\n- Node.js\n- npm\n- [dotenv](https://www.npmjs.com/package/dotenv)\n- [MySQL2](https://www.npmjs.com/package/mysql2)\n- [Inquirer](https://www.npmjs.com/package/inquirer)\n- [console.table](https://www.npmjs.com/package/console.table)\n\n## Future Development\n\nIn the future, I would like to add the following improvements:\n\n- A feature that allows users to export their employee tracker into an excel spreadsheet.\n- A front-end UI so that users don't have to go through complicated installation instructions in order to use the application.\n\nI'm always interested in refactoring code to improve it's functionality. If you would like to suggest your own improvements, you can reach me at the links below.\n\n- \u003ca href=\"mailto:ashleylynnsmith.dev@gmail.com\"\u003eEmail\u003c/a\u003e\n- \u003ca href=\"https://github.com/ashlynn4567\"\u003eGitHub\u003c/a\u003e\n- \u003ca href=\"https://www.linkedin.com/in/ashley-lynn-smith/\"\u003eLinkedIn\u003c/a\u003e\n\n## Credits\n\nThis project was built with the help of the University of Oregon's Coding Boot Camp.\n\n## Licensing\n\nThe application is covered under the following license: [MIT](https://opensource.org/licenses/MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashlynn4567%2Femployee-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashlynn4567%2Femployee-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashlynn4567%2Femployee-tracker/lists"}