{"id":28085739,"url":"https://github.com/codeperfectplus/goldsilverbilling","last_synced_at":"2025-08-29T09:18:47.304Z","repository":{"id":252970531,"uuid":"840938147","full_name":"codeperfectplus/GoldSilverBilling","owner":"codeperfectplus","description":"Simplify the process of calculating gold/silver prices for jewellers and customers","archived":false,"fork":false,"pushed_at":"2024-08-29T03:47:08.000Z","size":1451,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-11T20:09:58.322Z","etag":null,"topics":["calculator","gold-calculator","gold-price","jewellery-management","jewellery-shop","jewelry","jwellery","silver-calculator"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/codeperfectplus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["codeperfectplus"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-08-11T06:35:53.000Z","updated_at":"2024-12-18T22:46:53.000Z","dependencies_parsed_at":"2024-08-20T18:28:33.538Z","dependency_job_id":"1a07bbbb-5c91-49bb-bb7a-11c00e394d04","html_url":"https://github.com/codeperfectplus/GoldSilverBilling","commit_stats":null,"previous_names":["codeperfectplus/goldsilverbilling"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FGoldSilverBilling","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FGoldSilverBilling/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FGoldSilverBilling/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2FGoldSilverBilling/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeperfectplus","download_url":"https://codeload.github.com/codeperfectplus/GoldSilverBilling/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253925638,"owners_count":21985358,"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":["calculator","gold-calculator","gold-price","jewellery-management","jewellery-shop","jewelry","jwellery","silver-calculator"],"created_at":"2025-05-13T10:41:46.123Z","updated_at":"2025-05-13T10:41:46.584Z","avatar_url":"https://github.com/codeperfectplus.png","language":"HTML","funding_links":["https://github.com/sponsors/codeperfectplus"],"categories":[],"sub_categories":[],"readme":"# Gold Silver Billing\n\n![Homepage](/screenshots/app.png)\n\n## Mission\n\nOur goal is to simplify the process of calculating gold prices for jewelers and customers alike. We aim to provide a user-friendly, accurate, and efficient tool for gold price calculations. By ensuring transparency and trust in every transaction, we help users make informed decisions and streamline their billing processes.\n\n## Features\n\n- **Real-time Price Calculation:** Provides immediate and accurate estimates for gold prices based on user inputs.\n- **Transaction History:** Maintains a detailed log of all transactions for easy tracking and reference.\n- **Multi-Level Authentication:** Implements secure login with distinct roles for different user types (e.g., admin, manager, customer).\n- **User-Friendly Interface:** Designed with an intuitive layout for easy navigation and use.\n- **Customizable Charges:** Allows users to adjust service charges, taxes, and other fees according to their needs.\n- **Responsive Design:** Ensures the application is fully functional on various devices, including desktops, tablets, and smartphones.\n- **Secure Data Handling:** Protects sensitive information with robust security measures.\n- **Business Customization:** Provides options for tailoring the application to specific business requirements, including currency settings and theme preferences.\n\n## Demo\n\nExplore the live demo of the application on the following platforms:\n\n- [Railway (Server 1)](https://goldsilverbilling-production.up.railway.app/)\n- [Render (Server 2)](https://goldsilverbilling.onrender.com/)\n\n## Building and Running the Docker Container\n\nTo get the application up and running using Docker, follow these steps:\n\n1. **Build the Docker Image:**\n\n    ```bash\n    docker build -t goldsilverbilling .\n    ```\n\n    This command creates a Docker image named `goldsilverbilling` based on the Dockerfile in the project directory.\n\n2. **Run the Docker Container:**\n\n    ```bash\n    docker run -p 5000:5000 goldsilverbilling\n    ```\n\n    This command runs a container from the `goldsilverbilling` image and maps port 5000 of the container to port 5000 on your host machine.\n\n## Screenshots\n\nHere are some screenshots of the application:\n\n### Homepage\n\n![Homepage](/screenshots/homepage.png)\n\n### Admin Dashboard\n\n![Admin Dashboard](/screenshots/admin_dashboard.png)\n\n### Gold Calculator\n\n![Gold Calculator](/screenshots/gold_calculator.png)\n\n### System Settings\n\n![System Settings](/screenshots/system_setting.png)\n\n### Transaction History\n\n![Transaction History](/screenshots/transaction_history.png)\n\n## Planned Improvements\n\nWe are continually working on enhancing the application. Here are some planned improvements:\n\n| Improvement            | Type                  | Details                                                                                   | Status |\n|------------------------|-----------------------|-------------------------------------------------------------------------------------------|--------|\n| **User Authentication**    | Security              | Implement a robust login system to secure sensitive data and restrict access based on user roles.       | ✅ |\n| **Data Persistence**       | Functionality         | Ensure historical data is stored and easily retrievable for future reference.                            | ✅ |\n| **Multi-Currency Support** | Functionality         | Introduce support for multiple currencies to allow users to perform conversions and calculations in different currencies. | ✅ |\n| **Responsive Design**      | User Experience       | Enhance the design and layout for improved usability on mobile and tablet devices.                     | ✅ |\n| **Error Handling**         | Functionality         | Implement comprehensive validation and error messaging to improve user experience and data integrity.    | ✅ |\n| **API Integration**        | Integration           | Integrate external APIs to fetch real-time gold and silver prices.                                           | :x:    |\n| **Advanced Analytics**     | Functionality         | Develop features to generate detailed reports and visualizations based on transaction data.                | :x:    |\n| **Multi-Language Support** | User Experience       | Add support for multiple languages to cater to a wider audience and enhance accessibility.                | :x:    |\n\n## Author\n\n- [@codeperfectplus](https://github.com/codeperfectplus)\n\n## License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## Acknowledgments\n\nWe'd like to acknowledge the following tools and libraries that have been instrumental in developing this project:\n\n- [Python](https://www.python.org/) - The programming language used for the backend.\n- [Flask](https://flask.palletsprojects.com/) - The web framework used for building the application.\n- [Font Awesome](https://fontawesome.com/) - For icons and graphical elements.\n- [Bootstrap](https://getbootstrap.com/) - For responsive design and styling.\n- [Render](https://render.com/) - For hosting the application on the web.\n- [Railway](https://railway.app/) - For additional hosting services.\n\n## Contact\n\nFor any questions, feedback, or suggestions, please reach out to us at [codeperfectplus@gmail.com](mailto:codeperfectplus@gmail.com).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Fgoldsilverbilling","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeperfectplus%2Fgoldsilverbilling","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Fgoldsilverbilling/lists"}