{"id":27064794,"url":"https://github.com/beastmp/msc-devops-bootcamp-frontend","last_synced_at":"2025-07-03T13:06:00.664Z","repository":{"id":283577672,"uuid":"948793131","full_name":"beastmp/msc-devops-bootcamp-frontend","owner":"beastmp","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-21T00:10:57.000Z","size":74,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T17:19:06.526Z","etag":null,"topics":["devops","project-devops-bootcamp","react"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/beastmp.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}},"created_at":"2025-03-15T01:12:11.000Z","updated_at":"2025-03-21T22:09:47.000Z","dependencies_parsed_at":"2025-03-22T01:32:02.313Z","dependency_job_id":null,"html_url":"https://github.com/beastmp/msc-devops-bootcamp-frontend","commit_stats":null,"previous_names":["beastmp/msc-devops-bootcamp-frontend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beastmp%2Fmsc-devops-bootcamp-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beastmp%2Fmsc-devops-bootcamp-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beastmp%2Fmsc-devops-bootcamp-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beastmp%2Fmsc-devops-bootcamp-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beastmp","download_url":"https://codeload.github.com/beastmp/msc-devops-bootcamp-frontend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beastmp%2Fmsc-devops-bootcamp-frontend/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":258352560,"owners_count":22687509,"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":["devops","project-devops-bootcamp","react"],"created_at":"2025-04-05T17:19:08.346Z","updated_at":"2025-07-03T13:06:00.651Z","avatar_url":"https://github.com/beastmp.png","language":"JavaScript","readme":"# DevOps Bootcamp - Frontend Application\n\nThis repository contains the frontend application for the CloudMart e-commerce platform, developed as part of the DevOps Bootcamp project. This React-based application provides a modern user interface for a complete online shopping experience with AI integration.\n\n## Features\n\n- Interactive product catalog with search functionality\n- Shopping cart with order placement\n- User profile management\n- Order history and tracking\n- Admin dashboard for product and order management\n- AI-powered customer support chat interface\n- Embedded AI assistant for product recommendations\n\n## Technology Stack\n\n- **Framework**: React 18 with Vite\n- **Routing**: React Router v6\n- **Styling**: TailwindCSS\n- **HTTP Client**: Axios\n- **UI Icons**: Lucide React\n- **Development**: ESLint, Vite dev server\n- **Containerization**: Docker/Kubernetes ready\n\n## Prerequisites\n\n- Node.js (v14.x or later)\n- npm (v6.x or later)\n- Git\n\n## Installation and Setup\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/beastmp/msc-devops-bootcamp-frontend.git\n   cd msc-devops-bootcamp-frontend\n   ```\n\n2. Install dependencies:\n   ```\n   npm install\n   ```\n\n3. Set up environment variables:\n   - Create or modify the `.env` file in the root directory\n   - Configure the API endpoint:\n     ```\n     VITE_API_BASE_URL=http://localhost:5000/api\n     ```\n\n4. Start the development server:\n   ```\n   npm run dev\n   ```\n\nThe application should now be running on [http://localhost:5173](http://localhost:5173).\n\n## Available Scripts\n\n- `npm run dev` - Runs the app in development mode with hot reloading\n- `npm run build` - Builds the app for production\n- `npm run lint` - Runs ESLint to check code quality\n- `npm run preview` - Previews the production build locally\n\n## Project Structure\n\n```\nsrc/\n├── components/           # UI components organized by feature\n│   ├── AboutPage/        # About page component\n│   ├── AdminPage/        # Admin product management interface\n│   ├── AIAssistant/      # Floating AI chat component\n│   ├── CartPage/         # Shopping cart interface\n│   ├── Footer/           # Site footer component\n│   ├── Header/           # Site header component\n│   ├── LoadingSpinner/   # Loading indicator\n│   ├── MainPage/         # Homepage with product catalog\n│   ├── OrdersPage/       # Admin order management\n│   ├── SupportPage/      # Customer support chat interface\n│   ├── UserOrdersPage/   # User's order history\n│   └── UserProfilePage/  # User profile management\n├── config/               # Application configuration\n│   └── axiosConfig.js    # API client configuration\n├── utils/                # Utility functions\n│   ├── cartUtils.js      # Shopping cart management\n│   └── userUtils.js      # User management\n├── App.jsx               # Main application component with routes\n└── main.jsx              # Application entry point\n```\n\n## Key Features\n\n### Product Catalog\n- Display of all available products\n- Product search functionality\n- Add to cart capability\n\n### Shopping Cart\n- View and manage items in cart\n- Update item quantities\n- Checkout process with order confirmation\n\n### User Management\n- User profile creation and editing\n- Order history viewing\n- Streamlined anonymous user experience\n\n### Admin Features\n- Product management (add, edit, delete)\n- Order management with status updates\n- Order details viewing\n\n### AI Integration\n- Floating AI assistant for customer inquiries\n- Support chat with conversation history\n- AI-powered product recommendations\n\n## API Integration\n\nThe frontend communicates with the backend API using Axios. The base URL is configured via environment variables:\n\n```javascript\nbaseURL: import.meta.env.VITE_API_BASE_URL || 'http://localhost:5000/api'\n```\n\n## Deployment\n\n### Docker and Kubernetes\n\nThe project includes Kubernetes deployment configuration in `cloudmart-frontend.yaml`:\n\n```bash\n# Build the Docker image\ndocker build -t cloudmart-frontend .\n\n# Apply the Kubernetes configuration\nkubectl apply -f cloudmart-frontend.yaml\n```\n\n### Environment Configuration\n\nFor production deployment, ensure the correct `VITE_API_BASE_URL` is set to the backend API endpoint.\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Related Repositories\n\n- [DevOps Bootcamp - Backend](https://github.com/beastmp/msc-devops-bootcamp-backend)\n- [DevOps Bootcamp - Infrastructure](https://github.com/beastmp/msc-devops-bootcamp-infrastructure)\n- [DevOps Bootcamp - Kubernetes](https://github.com/beastmp/msc-devops-bootcamp-kubernetes)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeastmp%2Fmsc-devops-bootcamp-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeastmp%2Fmsc-devops-bootcamp-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeastmp%2Fmsc-devops-bootcamp-frontend/lists"}