{"id":15797387,"url":"https://github.com/devqueue/dataset-annotation","last_synced_at":"2025-03-31T19:44:04.617Z","repository":{"id":63674397,"uuid":"565763824","full_name":"devqueue/dataset-annotation","owner":"devqueue","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-29T18:03:18.000Z","size":3403,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-12T00:30:48.140Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devqueue.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-14T09:26:19.000Z","updated_at":"2022-11-15T06:20:23.000Z","dependencies_parsed_at":"2023-01-23T19:15:47.293Z","dependency_job_id":null,"html_url":"https://github.com/devqueue/dataset-annotation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devqueue%2Fdataset-annotation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devqueue%2Fdataset-annotation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devqueue%2Fdataset-annotation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devqueue%2Fdataset-annotation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devqueue","download_url":"https://codeload.github.com/devqueue/dataset-annotation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246531984,"owners_count":20792735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-05T00:07:38.676Z","updated_at":"2025-03-31T19:44:04.598Z","avatar_url":"https://github.com/devqueue.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dataset Annotator\nA web application for gene search built with django using the [django black template](https://github.com/creativetimofficial/black-dashboard-django) by creative tim\n\n\u003cbr /\u003e\n\n## Data requirements\nRequiements will be made availible soon \n## ✨ Deploy in production using `Docker`\n\n\u003e Get the code\n\n```bash\n$ git clone \u003crepo\u003e\n$ cd dataset-annotation\n```\n\u003e Configure environment variables\n```\n1. Create a .env file and paste the contents. \n\nDEBUG=1\nDB_NAME=dbname\nDB_USER=rootuser\nDB_PASS=changeme\nSECRET_KEY=changeme\nALLOWED_HOSTS=127.0.0.1\n\n2. Change the variables to store real values\n3. Allowed hosts can be a comma seperated list of multiple hosts (IP's or domain names)\n```\n\u003e Start the app in Docker\n\n```bash\n$ docker-compose up --build\n$ docker-compose run --rm app sh -c \"python manage.py createsuperuser\"\n```\n\nVisit `http://localhost:80` in your browser. The app should be up \u0026 running.\n\n\n\u003cbr /\u003e\n\n## ✨ How to use it for development\nThe development deployment provies hot reloading for the code to update in real time\n\n```bash\n$ # Get the code\n$ git clone \u003crepo\u003e\n$ cd dataset-annotation\n$\n$ \n$ # Docker compose\n$ docker-compose -f docker-compose-dev.yml up --build\n$\n$ # open a new terminal and run \n$ docker-compose -f docker-compose-dev.yml run --rm app sh -c \"python manage.py createsuperuser\"\n$\n$ # Access the web app in browser: http://127.0.0.1/\n```\n\n\u003cbr /\u003e\n\n## ✨ Code-base structure\n\nThe project is coded using a simple and intuitive structure presented below:\n\n```bash\n\u003c PROJECT ROOT \u003e\n   |\n   |-- core/                               # Implements app configuration\n   |    |-- settings.py                    # Defines Global Settings\n   |    |-- wsgi.py                        # Start the app in production\n   |    |-- urls.py                        # Define URLs served by all apps/nodes\n   |\n   |-- apps/\n   |    |\n   |    |-- home/                          # A simple app that serve HTML files\n   |    |    |-- views.py                  # Serve HTML pages for authenticated users\n   |    |    |-- urls.py                   # Define some super simple routes  \n   |    |\n   |    |-- authentication/                # Handles auth routes (login and register)\n   |    |    |-- urls.py                   # Define authentication routes  \n   |    |    |-- views.py                  # Handles login and registration  \n   |    |    |-- forms.py                  # Define auth forms (login and register) \n   |    | \n   |    |-- search/\n   |    |    |-- views.py                  # Handles search and export\n   |    |    |-- urls.py                   # Define urls for search and export\n   |    |    |-- models.py                 # model for the gene storage\n   |    | \n   |    |-- upload/\n   |    |    |-- urls.py                   # Define upload and compute routes  \n   |    |    |-- views.py                  # Handles populating database \n   |    |    |-- forms.py                  # Define upload form\n   |    |    |-- models.py                 # model for csv file upload\n   |    | \n   |    |\n   |    |-- static/\n   |    |    |-- \u003ccss, JS, images\u003e         # CSS files, Javascripts files\n   |    |\n   |    |-- templates/                     # Templates used to render pages\n   |         |-- includes/                 # HTML chunks and components\n   |         |    |-- navigation.html      # Top menu component\n   |         |    |-- sidebar.html         # Sidebar component\n   |         |    |-- footer.html          # App Footer\n   |         |    |-- scripts.html         # Scripts common to all pages\n   |         |\n   |         |-- layouts/                   # Master pages\n   |         |    |-- base-fullscreen.html  # Used by Authentication pages\n   |         |    |-- base.html             # Used by common pages\n   |         |\n   |         |-- accounts/                  # Authentication pages\n   |         |    |-- login.html            # Login page\n   |         |    |-- register.html         # Register page\n   |         |\n   |         |-- home/                      # UI Kit Pages\n   |              |-- index.html            # Index page\n   |              |-- 404-page.html         # 404 page\n   |              |-- *.html                # All other pages\n   |\n   |-- requirements.txt                     # Development modules - SQLite storage\n   |\n   |-- .env                                 # Inject Configuration via Environment\n   |-- manage.py                            # Start the app - Django default start script\n   |\n   |-- ************************************************************************\n```\n\n\u003cbr /\u003e\n\n## ✨ Recompile CSS\n\nTo recompile SCSS files, follow this setup:\n\n\u003cbr /\u003e\n\n**Step #1** - Install tools\n\n- [NodeJS](https://nodejs.org/en/) 12.x or higher\n- [Gulp](https://gulpjs.com/) - globally \n    - `npm install -g gulp-cli`\n- [Yarn](https://yarnpkg.com/) (optional) \n\n\u003cbr /\u003e\n\n**Step #2** - Change the working directory to `assets` folder\n\n```bash\n$ cd apps/static/assets\n```\n\n\u003cbr /\u003e\n\n**Step #3** - Install modules (this will create a classic `node_modules` directory)\n\n```bash\n$ npm install\n// OR\n$ yarn\n```\n\n\u003cbr /\u003e\n\n**Step #4** - Edit \u0026 Recompile SCSS files \n\n```bash\n$ gulp scss\n```\n\nThe generated file is saved in `static/assets/css` directory.\n\n\u003cbr /\u003e \n\n## Future improvement proposals\n1. Live table update using ajax\n2. Testing time complexity with large number of files. \n\n## ✨ Credits \u0026 Links\n\n### [Django Admin Dashboards](https://appseed.us/admin-dashboards/django)\n\nIndex with UI-ready **admin dashboards** generated by the AppSeed platform in [Django Framework](https://www.djangoproject.com/).\nStart fast your next Django project by using functional admin dashboards enhanced with Database, ORM, authentication flow, helpers and deployment scripts.\n\n### Black Dashboard\n\n**Black Dashboard** is a beautiful Bootstrap 4 Admin Dashboard with a huge number of components built to fit together and look amazing. If you are looking for a tool to manage and visualize data about your business, this dashboard is the thing for you. It combines colors that are easy on the eye, spacious cards, beautiful typography, and graphics.\n\n\u003cbr /\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevqueue%2Fdataset-annotation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevqueue%2Fdataset-annotation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevqueue%2Fdataset-annotation/lists"}