{"id":35009326,"url":"https://github.com/zigameni/blockchain-store-management-system","last_synced_at":"2026-04-16T05:04:46.020Z","repository":{"id":321125635,"uuid":"1084588537","full_name":"zigameni/blockchain-store-management-system","owner":"zigameni","description":"Multi-user e-commerce platform with blockchain-based payments. Customers shop, couriers deliver, owners manage inventory. Payments secured through Ethereum smart contracts with automatic fund distribution. Fully dockerized microservices architecture.","archived":false,"fork":false,"pushed_at":"2025-10-27T22:12:55.000Z","size":119,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-28T00:14:05.494Z","etag":null,"topics":["blockchain","docker","ethereum","flask","jwt-authentication","mysql","python","rest-api","smart-contracts","sqlalchemy","web3py"],"latest_commit_sha":null,"homepage":"","language":"Python","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/zigameni.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-27T22:11:53.000Z","updated_at":"2025-10-27T22:16:26.000Z","dependencies_parsed_at":"2025-10-28T00:14:19.775Z","dependency_job_id":"dea7a3c5-c9ed-418d-84da-fdf0c05aed3a","html_url":"https://github.com/zigameni/blockchain-store-management-system","commit_stats":null,"previous_names":["zigameni/blockchain-store-management-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zigameni/blockchain-store-management-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigameni%2Fblockchain-store-management-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigameni%2Fblockchain-store-management-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigameni%2Fblockchain-store-management-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigameni%2Fblockchain-store-management-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zigameni","download_url":"https://codeload.github.com/zigameni/blockchain-store-management-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigameni%2Fblockchain-store-management-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31872036,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["blockchain","docker","ethereum","flask","jwt-authentication","mysql","python","rest-api","smart-contracts","sqlalchemy","web3py"],"created_at":"2025-12-27T04:57:01.936Z","updated_at":"2026-04-16T05:04:46.008Z","avatar_url":"https://github.com/zigameni.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Store Management System with Blockchain Payments\n\nA containerized multi-user store management system built with Flask, SQLAlchemy, and Ethereum smart contracts.\n\n## Features\n\n- **User Management**: Authentication for customers, couriers, and store owners\n- **Product Management**: CSV upload, search, and statistics\n- **Order Processing**: Full order lifecycle with status tracking\n- **Blockchain Payments**: Ethereum smart contracts for secure payment escrow\n- **Docker Deployment**: Complete containerized system with Docker Compose\n\n## Quick Start\n\n```bash\n# Clone and start\ngit clone \u003cyour-repo-url\u003e\ncd store-management-system\ndocker-compose up --build\n```\n\n**Services:**\n- Authentication: `http://localhost:5001`\n- Owner: `http://localhost:5002`\n- Customer: `http://localhost:5003`\n- Courier: `http://localhost:5004`\n- Blockchain: `http://localhost:8545`\n\n## Default Owner Account\n\n```\nEmail: onlymoney@gmail.com\nPassword: evenmoremoney\n```\n\n## Tech Stack\n\n- **Backend**: Flask, SQLAlchemy\n- **Database**: MySQL\n- **Blockchain**: Solidity, Web3.py, Ganache\n- **Deployment**: Docker, Docker Compose\n\n## Project Structure\n\n```\n.\n├── authentication/       # Auth service\n├── owner/               # Owner service\n├── customer/            # Customer service\n├── courier/             # Courier service\n├── blockchain/          # Smart contracts\n├── models.py           # Database models\n├── configuration.py    # Config\n└── docker-compose.yml  # Orchestration\n```\n\n## API Documentation\n\n### Authentication\n- `POST /register_customer` - Register customer\n- `POST /register_courier` - Register courier\n- `POST /login` - User login\n\n### Owner\n- `POST /update` - Upload products (CSV)\n- `GET /product_statistics` - Product stats\n- `GET /category_statistics` - Category stats\n\n### Customer\n- `GET /search` - Search products\n- `POST /order` - Create order\n- `POST /generate_invoice` - Get payment invoice\n- `GET /status` - View orders\n- `POST /delivered` - Confirm delivery\n\n### Courier\n- `GET /orders_to_deliver` - Available orders\n- `POST /pick_up_order` - Pick up order\n\n## Testing\n\n```bash\ncd tests\npython main.py\n```\n\n## License\n\nAcademic project - See LICENSE file\n\n## Tags\n\n`flask` `docker` `blockchain` `ethereum` `smart-contracts` `sqlalchemy` `web3py` `microservices` `rest-api` `jwt` `python` `mysql` `e-commerce` `order-management` `payment-system`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigameni%2Fblockchain-store-management-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzigameni%2Fblockchain-store-management-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigameni%2Fblockchain-store-management-system/lists"}