{"id":27006818,"url":"https://github.com/robinoosterik2/scoutingdrankkas","last_synced_at":"2025-06-23T19:04:25.524Z","repository":{"id":266705169,"uuid":"899099565","full_name":"robinoosterik2/ScoutingDrankKas","owner":"robinoosterik2","description":"Using ","archived":false,"fork":false,"pushed_at":"2025-06-16T22:09:23.000Z","size":1210,"stargazers_count":0,"open_issues_count":19,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-16T22:34:58.253Z","etag":null,"topics":["bar","docker","docker-compose","javascript","mongodb","mongoose","mongoose-schema","nuxt3","nuxtjs","typescript"],"latest_commit_sha":null,"homepage":"","language":"Vue","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/robinoosterik2.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,"zenodo":null}},"created_at":"2024-12-05T16:09:34.000Z","updated_at":"2025-05-08T21:41:23.000Z","dependencies_parsed_at":"2024-12-05T17:27:10.543Z","dependency_job_id":"a83fe99b-5408-4fd5-a4be-05fc5ac69861","html_url":"https://github.com/robinoosterik2/ScoutingDrankKas","commit_stats":null,"previous_names":["robinoosterik2/scoutingdrankkas"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/robinoosterik2/ScoutingDrankKas","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinoosterik2%2FScoutingDrankKas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinoosterik2%2FScoutingDrankKas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinoosterik2%2FScoutingDrankKas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinoosterik2%2FScoutingDrankKas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robinoosterik2","download_url":"https://codeload.github.com/robinoosterik2/ScoutingDrankKas/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinoosterik2%2FScoutingDrankKas/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261539319,"owners_count":23174135,"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":["bar","docker","docker-compose","javascript","mongodb","mongoose","mongoose-schema","nuxt3","nuxtjs","typescript"],"created_at":"2025-04-04T08:16:41.818Z","updated_at":"2025-06-23T19:04:25.444Z","avatar_url":"https://github.com/robinoosterik2.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ScoutingDrankKas\nI created the ScoutingDrankKas as a system to sell and manage drinks effectively, providing a seamless experience for users and barkeepers at my scouting.\n\nI am planning on adding a lot of features to the system, but for now I am focusing on the basics. The system is built with Nuxt 3 and uses a MongoDB database.\n\nIt is maintained but not my main focus as I am rounding up my studies. I am open to contributions and suggestions for improvements.\n\n---\n\n## 🚀 Features\n- **User Management**: Registration, authentication, and role-based access control.\n- **Product Management**: Add, edit, and manage products with stock tracking.\n- **Order Management**: Efficiently handle orders and track sales.\n- **Stock Management**: Monitor and update product stock levels.\n- **Logging and Monitoring**: Track user actions and system events.\n- **Role Management**: Assign and manage custom roles with permissions.\n- **Dark Mode Support**: User-friendly interface with light and dark themes.\n- **Localization**: Multi-language support with i18n.\n\n---\n\n## 🛠️ Tech Stack\n- **Full-Stack Framework**: [Nuxt 3](https://nuxtjs.org/)\n- **Database**: [MongoDB](https://www.mongodb.com/)\n- **Styling**: [Tailwind CSS](https://tailwindcss.com/)\n- **Containerization**: [Docker](https://www.docker.com/)\n- **Version Control**: [Git](https://git-scm.com/)\n\n---\n\n## 📦 Installation\n\n1. Clone the repository:\n\n``` bash\ngit clone https://github.com/robinoosterik2/ScoutingDrankKas.git\n```\n\n2. Navigate to the project directory:\n\n``` bash\ncd ScoutingDrankKas\n```\n3. Install dependencies:\n\n``` bash\nnpm install\n```\n\n4. Create a `.env` file in the root directory. For an example look at `.env.example`:\n\n``` bash\ncp .env.example .env\n```\n\n5. Start the development server:\n\n``` bash\ndocker compose up --build\n```\n6. Open your browser and navigate to `http://localhost`.\n\n7. Create a superuser account:\n Sadly this work in progress. At this moment create a user, comment out the middleware checking for admin and add your own admin role :(.\n---\n\n## 📂 Project Structure\n\n- `/components`: Reusable Vue components.\n- `/layouts`: Layout components for different pages.\n- `/pages`: Vue pages for routing.\n- `/plugins`: Nuxt plugins for extending functionality.\n- `/store`: Vuex store for state management.\n- `/middleware`: Middleware for route handling.\n- `/assets`: CSS files for styling.\n- `/public`: Static files and assets.\n- `/server`: Server-side code and API routes.\n- `/utils`: Utility functions and helpers.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome and greatly appreciated! To contribute to this project, please follow these steps:\n\n1. **Fork the Repository**:  \n\nClick the \"Fork\" button at the top of this repository to create your own copy.\n\n2. **Clone Your Fork**:  \n\nClone your forked repository to your local machine:\n```bash\ngit clone https://github.com/your-username/ScoutingDrankKas.git\ncd ScoutingDrankKas\n```\n\n3. **Create a Branch**:\n```bash\ngit checkout -b feature-name\n```\n\n4. **Make Changes**:\nImplement your feature or fix a bug. Ensure that your code follows the project's coding standards and conventions.\n\n5. **Test Your Changes**:\n(TODO add tests) Ensure that your changes work as expected and do not introduce any new issues.\n6. **Commit Your Changes**:\n```bash\ngit commit -m \"feature-name: Brief description of changes\"\n```\n7. **Push to Your Fork**:\n```bash\ngit push origin feature-name\n```\n8. **Create a Pull Request**:\nGo to the original repository and click on the \"Pull Requests\" tab. Click the \"New Pull Request\" button and select your branch. Provide a clear description of your changes and submit the pull request.\n\n---\n\n## 👤 Author\n\nRobin Oosterik\n- linkedin: [Robin Oosterik](https://www.linkedin.com/in/robin-oosterik/)\n---\n\n## 📜 License\n\nThis project is licensed under the [MIT License](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinoosterik2%2Fscoutingdrankkas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobinoosterik2%2Fscoutingdrankkas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinoosterik2%2Fscoutingdrankkas/lists"}