{"id":20619927,"url":"https://github.com/mafda/django_employees","last_synced_at":"2026-05-02T08:31:51.954Z","repository":{"id":81393534,"uuid":"280998446","full_name":"mafda/django_employees","owner":"mafda","description":"Employees App is a project where you can realize an open search or visualize the employees' list. You can also create new employees and choose the interface idiom","archived":false,"fork":false,"pushed_at":"2020-07-20T13:09:19.000Z","size":365,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-09T23:36:43.557Z","etag":null,"topics":["css","django","django-project","html","python3"],"latest_commit_sha":null,"homepage":"http://mafda-django-employees.herokuapp.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mafda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-20T02:58:06.000Z","updated_at":"2020-07-20T13:20:13.000Z","dependencies_parsed_at":"2023-03-02T06:45:49.589Z","dependency_job_id":null,"html_url":"https://github.com/mafda/django_employees","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mafda/django_employees","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafda%2Fdjango_employees","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafda%2Fdjango_employees/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafda%2Fdjango_employees/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafda%2Fdjango_employees/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mafda","download_url":"https://codeload.github.com/mafda/django_employees/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafda%2Fdjango_employees/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528179,"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":["css","django","django-project","html","python3"],"created_at":"2024-11-16T12:12:51.069Z","updated_at":"2026-05-02T08:31:51.928Z","avatar_url":"https://github.com/mafda.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Employees app\n\n:rocket: A demo of this project is available [here](http://mafda-django-employees.herokuapp.com/).\n\n***Employees App***  is a project that has the following features:\n\n* In the **Search Tab**, you can realize an open search in the employees' list.\n  * The application will perform a search of the term of interest in all the database fields and will return the list of matched employees.\n  * To improve the user experience, a wait animation was implemented. A spin and a bar pulse animations were used for desktop and mobile applications, respectively.\n  * To better appreciate those animations, a database response delay of 1 second was simulated.\n* In the **New Tab**, you can visualize the complete employees' list with document number, name, last name, and salary data.\n  * Here, it is possible to create new employees too.\n  * The app will verify the document number to avoid data entry redundancy.\n    * I.e., it is possible to have two employees with the same name but not two employees with the same document number.\n* It is possible to choose the interface idiom between **Spanish, Portuguese, and English**.\n  * The default language will depend on your location. \n\n## Technologies\n\n* The project was developed using the framework [Django](https://www.djangoproject.com/) with [Python 3](https://www.python.org/).\n* HTML was used to create the layouts templates.\n* CSS and [Bootstrap](https://getbootstrap.com/) were used for the basic styling of the navbar, forms, and other components.\n* [Font Awesome](https://fontawesome.com/) and [Google Fonts](https://fonts.google.com) were used for complementary styling.\n* To have a better user experience, JavaScript and [AJAX](https://api.jquery.com/jquery.ajax/) were used to manage the client requisitions and interface events.  \n* The multiple application languages were managed with the feature of [internationalization and localization](https://docs.djangoproject.com/en/3.0/topics/i18n/) of Django.\n* Finally, [Heroku](www.heroku.com) was used to deploy the project.\n  \n## Screenshots\n\n### Web\n\n![web django employee](img/web_django_employee.png)\n\n### Mobile\n\n![mobile django employee](img/mobile_django_employee.png)\n\n## Development \n\n```shell\n# 1. Create the virtual environment\npython -m venv /path/to/new/virtual/environment\n\n# 1.1. Activate it\nsource /path/to/new/virtual/environment/bin/activate\n\n# 2. Clone the project\ngit clone https://github.com/mafda/django_employees.git\n\n# 2.1. Go to the project directory\ncd django_employees\n\n# 3. Install the project dependencies\npip install -r requirements.txt\n\n# 4. Make database migrations\npython manage.py migrate\n\n# 5. Run the server\npython manage.py runserver\n\n# 6. Enjoy it!\necho \"well done! :)\"\n```\n\nDone! Now navigate to http://localhost:8000/\n\n\n### Heroku deploy \n\n```shell\n# 1. Create the app on Heroku \nheroku create awesome-employees-app\n\n# 2. Deploy it :)\ngit push heroku master\n\n# 3. Make database migrations\nheroku run python manage.py migrate\n\n# 4. Enjoy it!\necho \"well done! :)\"\n```\n\nDone! Now navigate to https://awesome-employees-app.herokuapp.com/\n\n\u003e The application link will depend on the application name registered on Heroku.\n\n## License\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)\n\n---\n\n**\u003c/\u003e** with 💙 by [mafda](https://mafda.github.io/).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmafda%2Fdjango_employees","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmafda%2Fdjango_employees","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmafda%2Fdjango_employees/lists"}