https://github.com/purple-stock/rails_qr_code_inventory_management
Purple Stock is a comprehensive inventory management system designed for businesses of all sizes. It provides a robust set of features for tracking inventory across multiple locations, managing stock movements, and generating detailed reports.
https://github.com/purple-stock/rails_qr_code_inventory_management
hotwire inventory-management qrcode rails ruby stimulusjs tailwind
Last synced: 2 months ago
JSON representation
Purple Stock is a comprehensive inventory management system designed for businesses of all sizes. It provides a robust set of features for tracking inventory across multiple locations, managing stock movements, and generating detailed reports.
- Host: GitHub
- URL: https://github.com/purple-stock/rails_qr_code_inventory_management
- Owner: Purple-Stock
- Created: 2025-03-23T13:05:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-30T23:56:04.000Z (over 1 year ago)
- Last Synced: 2025-03-31T00:20:43.420Z (over 1 year ago)
- Topics: hotwire, inventory-management, qrcode, rails, ruby, stimulusjs, tailwind
- Language: HTML
- Homepage: https://www.purplestock.com.br
- Size: 173 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Purple Stock - Inventory Management System
[](https://deepwiki.com/Purple-Stock/rails_qr_code_inventory_management)
Purple Stock is a comprehensive inventory management system designed for businesses of all sizes. It provides a robust set of features for tracking inventory across multiple locations, managing stock movements, and generating detailed reports.
## Core Features
### Item Management
- Create, edit, and delete items
- Assign categories and suppliers
- Generate unique QR codes for each item
- Track item history and movement
- Set minimum stock levels and reorder points
- Bulk import/export via CSV
### Stock Operations
- Stock-in: Record new inventory arrivals
- Stock-out: Track inventory departures
- Stock adjustment: Correct inventory levels
- Stock movement: Transfer items between locations
- QR code scanning for all stock operations
- Real-time stock level updates
### Location Management
- Create and manage multiple storage locations
- Track item quantities per location
- View location-specific inventory history
- Transfer items between locations
- Location-based stock reports
### QR Code Integration
- Generate QR codes for all inventory items
- Scan QR codes for quick item lookup
- Perform stock operations via QR scanning
- Mobile-friendly scanning interface
- Real-time validation during scanning
### Reporting & Analytics
- Dashboard with key metrics
- Stock level summaries
- Movement history reports
- Location-based analytics
- Value-based reporting
- Export reports to CSV
### Supplier Management
- Create and manage supplier profiles
- Track supplier-specific inventory
- Link items to suppliers
- Supplier contact information
### User Management
- Role-based access control
- User profiles with permissions
- Audit logs for all actions
- Multi-factor authentication
## Technologies Used
- Ruby on Rails
- PostgreSQL
- Tailwind CSS
- Chart.js
- QR Code Generator
## Installation Rails(commands to run the project)
1. Clone the repository
2. Install dependencies
3. Configure environment variables
4. Run the development server
## Contributing
1. Fork the repository
2. Create a new branch
3. Make your changes and commit them
4. Push to your fork
5. Create a pull request
## API
### Authentication
Include an `X-Api-Key` header with a valid token generated for a user.
### Endpoints
- `GET /api/v1/teams/:team_id/items` – list items
- `GET /api/v1/teams/:team_id/items/:id` – show an item
- `GET /api/v1/teams/:team_id/transactions` – list transactions
- `POST /api/v1/teams/:team_id/transactions` – create a transaction