{"id":20165609,"url":"https://github.com/maxralph1/geminn","last_synced_at":"2026-05-03T10:31:55.403Z","repository":{"id":154183977,"uuid":"620701817","full_name":"maxralph1/geminn","owner":"maxralph1","description":"Gem-Inn is an ecommerce online store for a jewelries and clothing shop crafted in Django (Python), vanilla JavaScript and Bootstrap 5.3 with online payment channels","archived":false,"fork":false,"pushed_at":"2023-07-12T10:55:11.000Z","size":19306,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-01T01:26:39.455Z","etag":null,"topics":["boostrap5","creditcard","css3","django","ecommercestore","paypal","pytest","python","selenium"],"latest_commit_sha":null,"homepage":"https://geminn.up.railway.app/","language":"HTML","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/maxralph1.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-29T07:52:20.000Z","updated_at":"2024-09-19T20:14:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"4ab83d1b-cc66-4ba1-bd6b-eff122b58392","html_url":"https://github.com/maxralph1/geminn","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maxralph1/geminn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxralph1%2Fgeminn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxralph1%2Fgeminn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxralph1%2Fgeminn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxralph1%2Fgeminn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxralph1","download_url":"https://codeload.github.com/maxralph1/geminn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxralph1%2Fgeminn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32566443,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["boostrap5","creditcard","css3","django","ecommercestore","paypal","pytest","python","selenium"],"created_at":"2024-11-14T00:38:26.673Z","updated_at":"2026-05-03T10:31:55.380Z","avatar_url":"https://github.com/maxralph1.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gem-Inn Online Jewelry Store\n\nGuides (usage and description) to the Gem-Inn application.\n\n**Table of Contents**\n\n1. [What Gem-Inn Is](#what-is-gem-inn)\n2. [Technologies Utilized in Crafting Gem-Inn](#technologies-utilized-in-crafting-gem-inn)\n3. [Database Structure](#database-structure)\n4. [How to Install and Run the Gem-Inn Application Locally On Your Device](#how-to-install-and-run-the-gem-inn-application-locally-on-your-device)\n5. [Log into the Application with existing User Credentials](#log-into-the-application-with-existing-user-credentials)\n6. [Files to Update for your Payment Processing Keys](#files-to-update-for-your-payment-processing-keys)\n   1. [Paypal](#paypal)\n   2. [Stripe](#stripe)\n7. [Contributor's Words !important](#contributors-words-important)\n\n## What Is Gem-Inn?\n\nGem-Inn is an online store application for jewelries and clothings with online payment channels.\n\n## Preview (Working Application)\n\n(gif image for preview here)\n\n## Technologies Utilized in Crafting Gem-Inn\n\nGem-Inn is crafted in:\n\nthe following programming languages and frameworks:\n\n1. **Django (Python)**\n   1. **Pytest** (for comprehensive test of the application)\n   2. **Coverage** to determine more tests to be ran\n   3. **Selenium** for client-side UX tests\n2. vanilla **JavaScript**\n3. **Bootstrap 5.3**\n4. vanilla **CSS3**\n\nThe online payment channels are handled by:\n\n1. **PayPal** (credit/debit card and PayPal payments)\n2. **Stripe** (credit/debit card payments) — (yet to come)\n\n## Database Structure\n\n![image for the database structure of Gem-Inn](./gem_inn_database_schema.png)\n\n## How to Install and Run the Gem-Inn Application Locally On Your Device\n\n1. You must have Python3 downloaded and installed on your device.\n\n   On a laptop/desktop, follow the guidelines on the official [Python website](https://www.python.org/downloads/).\n\n   If on an Android device, follow these instructions to download and install this app, [Termux](https://github.com/termux/termux-app#f-droid). (Termux is a virtual environment for running almost all programs that could be run on a computer, on your mobile device.) After following these instructions, run the following command;\n   \u003cbr /\u003e\n\n   ```\n   pkg install python\n   ```\n\n2. After installing Python3, download and install a text editor [(e.g. VS Code)](https://code.visualstudio.com/Download) if you do not have one.\n\n   If on an Android device, follow these instructions to download and install this app, [Acode](https://acode.foxdebug.com/)\n\n---\n\nThen go to your terminal and follow these steps:\n\n(For the following steps, I encourage you to use either your GitBash terminal provided by your VS Code or your Android Termux terminal, as I explain these installation steps in Linux commands. Do not use Windows Shell, unless you intend to use the synonyms (Windows translations) for these Linux commands.)\n\n3. cd (change directory) into the folder directory from your terminal and create a folder in your favorite directory on your computer manually or you may create one from there using the following commands like below;\n\n   ```\n   cd C:/Users/maxim/Desktop\n   ```\n\n   Here I changed directory into my personal Desktop space on my windows Computer.\n\n   If on an Android device, use these commands on the Termux shell (this gets you into your phone's internal storage file directory. And then;):\n\n   ```\n   cd /storage/emulated/0\n   ```\n\n   And then on either desktop or mobile;\n\n   ```\n   mkdir gem-inn\n   ```\n\n   Or whatever you wish to call the application\n\n4. cd into this newly created folder\n\n   ```\n   cd gem-inn\n   ```\n\n   and create a virtual environment (skip this if on an Android device, as Termux is already a virtual environment running on your device)\n\n   ```\n   py -m venv venv\n   ```\n\n5. Activate the newly created virtual environment so that you can install Django and other dependencies.\n\n   ```\n   source venv/Scripts/activate\n   ```\n\n   You may decide to skip this step (step 5), to install and run Django from the system-wide installation. But virtual environments are always recommended.\n\n6. Clone this repository from here on Github using either of the 2 commands on your terminal:\n\n   ```\n   git clone https://github.com/maxralph1/gem-inn.git\n   ```\n\n   or\n\n   ```\n   git clone git@github.com:maxralph1/gem-inn.git\n   ```\n\n7. Use the command below to install all dependencies I utilized in this application as can be seen from my requirements.txt file\n\n   ```\n   pip install -r requirements.txt\n   ```\n\n8. Now, cd into the geminn folder included from the cloned github repository and run the command below;\n\n   ```\n   cd geminn\n   ```\n\n   and\n\n   ```\n   py manage.py runserver\n   ```\n\n9. Finally go to your browser and visit the link:\n   ```\n   http://localhost:8000/\n   ```\n   or\n   ```\n   http://127.0.0.1:8000/\n   ```\n\n## Log into the Application with existing User Credentials\n\nUse either of these credentials below to login to existing users in the database we already created.\n\nOn the other hand, if you intend to start afresh and know what you are doing, delete the database and run migrations afresh utilizing our existing database schema on this app's codebase.\n\nFor generic user:\n\n```\nUsername: user\nPassword: password1234\n```\n\nFor admin:\n\n```\nUsername: admin\nPassword: password1234\n```\n\n## Files to Update for your Payment Processing Keys\n\nYou must update these files following these instructions, to be able to process payments.\n\n### PayPal\n\n(instructions here)\n\n### Stripe\n\n(instructions here)\n\n## Contributor's Words !important\n\nIf you have any suggestions on how to improve this project, please share.\nThis application is strictly for demonstration purposes.\n\nIt is not yet production-ready and should never be used as such.\n\nI have decided to put in my time into other projects as this isn't generating funds for me at the moment.\n\nI will continue to gradually update this project in my free time, over a period of time (couple of months) until it is production-ready, while I handle other projects that would sustain my income.\n\nHowever, if you would love to have this project completed urgently for your personal use, do not hesitate to contact me on: maxralph01@gmail.com.\n\n\\*\\*On the general pattern of coding, if you noticed, the entire application has a specific approach in structure. I however decided to deviate (bring in several flavors) a little (but paid attention not to deviate too much) from these principles so as to showcase my skills.\nI would stick to a particular pattern in a real-world application (N.B: my next e-commerce store before the end of 2023 would follow this strict pattern).\n\nFinally, contributions/suggestions are welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxralph1%2Fgeminn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxralph1%2Fgeminn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxralph1%2Fgeminn/lists"}