{"id":14955380,"url":"https://github.com/bright-phiri/stylepos-api","last_synced_at":"2026-01-30T20:33:11.304Z","repository":{"id":66741275,"uuid":"591356290","full_name":"Bright-Phiri/StylePos-API","owner":"Bright-Phiri","description":"A StylePos  API ","archived":false,"fork":false,"pushed_at":"2024-11-09T14:11:41.000Z","size":357,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T03:41:18.404Z","etag":null,"topics":["backend","backend-development","rails-api","rails-application","rails7","sidekiq"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/Bright-Phiri.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-01-20T15:00:52.000Z","updated_at":"2024-11-09T14:11:44.000Z","dependencies_parsed_at":"2024-02-19T10:46:15.443Z","dependency_job_id":"f999eda1-1234-429d-940f-635451daa60c","html_url":"https://github.com/Bright-Phiri/StylePos-API","commit_stats":{"total_commits":367,"total_committers":2,"mean_commits":183.5,"dds":"0.043596730245231585","last_synced_commit":"58f9f65968ac0ab7532f2b068e204eb0b626e4b5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Bright-Phiri/StylePos-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bright-Phiri%2FStylePos-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bright-Phiri%2FStylePos-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bright-Phiri%2FStylePos-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bright-Phiri%2FStylePos-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bright-Phiri","download_url":"https://codeload.github.com/Bright-Phiri/StylePos-API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bright-Phiri%2FStylePos-API/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260438902,"owners_count":23009268,"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":["backend","backend-development","rails-api","rails-application","rails7","sidekiq"],"created_at":"2024-09-24T13:11:04.443Z","updated_at":"2026-01-30T20:33:11.249Z","avatar_url":"https://github.com/Bright-Phiri.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"StylePos-API\n===========================\n\nA StylePos API designed specifically for clothing retail stores. The API provides a comprehensive solution for managing sales, inventory, and customer information. It offers a user-friendly interface and incorporates features tailored to the unique needs of clothing retailers\n\n## Key Features:\n- Real-time Sales Data: Retrieve sales transaction data as it happens, providing up-to-the-minute information on items sold, quantities, prices, and total revenue generated.\n- Transaction Notifications: Receive instant notifications or webhook callbacks whenever a sales transaction occurs, allowing for immediate updates and triggers in connected applications.\n- Integrated Barcode Scanning: Seamlessly integrate with barcode scanners to scan and manage clothing items, improving efficiency at the point of sale and inventory management.\n- Performance Metrics: Access key performance metrics, such as total sales, average transaction value, top-selling items, and sales trends, to gain insights into business performance.\n- Filter and Search Capabilities: Apply filters and search parameters to retrieve sales data based on specific criteria, such as time range, or product categories.\n- Authentication and Security: Implement secure authentication mechanisms, such as API keys or OAuth, to ensure authorized access to the live sales tracking API.\n- Scalability and Reliability: Build upon a scalable and reliable infrastructure that can handle high transaction volumes and deliver real-time data with minimal latency.\n\n\n## Requirements\nThe following are required to run the Clothing Retail Stores API: \n\n- Ruby 3.1+\n- Rails 7.0+\n- PostgreSql\n- Redis\n\n## Getting Started\n\n1. Clone the repo\n\n   ```\n   $ git clone https://github.com/Bright-Phiri/StylePos-API.git\n   $ cd StylePos-API\n   ```\n\n2. Install dependencies\n\n   ```\n   $ bundle install\n   ```\n3. Create database:\n\n   ```\n   $ bin/rails db:create\n   ```\n\n4. Run migrations:\n\n   ```\n   $ bin/rails db:migrate\n   ```\n   \n5. Running the API\n\n   ```\n   $ bin/rails server\n   ```\n\n\n### Dealing with Missing `master.key` (Credentials Issue)\nIf you encounter an error like \"Couldn't decrypt config/credentials.yml.enc,\" it indicates that the `master.key` file, which is used to decrypt the credentials, is missing.\n\nTo resolve this issue, follow these steps:\n\n1. **Remove the existing `credentials.yml.enc`:**\n\n2. **Recreate the credentials file:**\n\nRun the following command to generate a new `credentials.yml.enc` file:\n\n$ bin/rails credentials:edit\nThis will open an editor to create new credentials.\n## Contributing:\n- Contributions to the project are welcome! If you find any issues or have suggestions for improvements, please submit a pull request or open an issue in the repository. \n\n ## Contributors \n - [Bright](https://www.github.com/Bright-Phiri) - creator and maintainer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbright-phiri%2Fstylepos-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbright-phiri%2Fstylepos-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbright-phiri%2Fstylepos-api/lists"}