18110ab159
- Import real data from PDF (35 Bambu Lab filaments) - Remove all Confluence integration and dependencies - Implement new V2 data structure with proper inventory tracking - Add backwards compatibility for existing data - Create enhanced UI components (ColorSwatch, InventoryBadge, MaterialBadge) - Add advanced filtering with quick filters and multi-criteria search - Organize codebase for dev/prod environments - Update Lambda functions to support both V1/V2 formats - Add inventory summary dashboard - Clean up project structure and documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
128 lines
2.7 KiB
Markdown
128 lines
2.7 KiB
Markdown
# Filamenteka
|
|
|
|
A web application for tracking Bambu Lab filament inventory with automatic color coding.
|
|
|
|
## Features
|
|
|
|
- 🎨 **Automatic Color Coding** - Table rows are automatically colored based on filament colors
|
|
- 🔍 **Search & Filter** - Quick search across all filament properties
|
|
- 📊 **Sortable Columns** - Click headers to sort by any column
|
|
- 🌈 **Gradient Support** - Special handling for gradient filaments like Cotton Candy Cloud
|
|
- 📱 **Responsive Design** - Works on desktop and mobile devices
|
|
|
|
## Technology Stack
|
|
|
|
- **Frontend**: React + TypeScript + Tailwind CSS
|
|
- **Backend**: Next.js API routes
|
|
- **Infrastructure**: AWS Amplify (Frankfurt region)
|
|
- **IaC**: Terraform
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js 18+ and npm
|
|
- AWS Account
|
|
- Terraform 1.0+
|
|
- GitHub account
|
|
|
|
## Setup Instructions
|
|
|
|
### 1. Clone the Repository
|
|
|
|
```bash
|
|
git clone https://github.com/yourusername/filamenteka.git
|
|
cd filamenteka
|
|
```
|
|
|
|
### 2. Install Dependencies
|
|
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 3. Deploy with Terraform
|
|
|
|
```bash
|
|
cd terraform
|
|
cp terraform.tfvars.example terraform.tfvars
|
|
# Edit terraform.tfvars with your values
|
|
|
|
terraform init
|
|
terraform plan
|
|
terraform apply
|
|
```
|
|
|
|
## Local Development
|
|
|
|
```bash
|
|
# Run development server
|
|
npm run dev
|
|
```
|
|
|
|
Visit http://localhost:5173 to see the app.
|
|
|
|
## Table Format
|
|
|
|
The filament table should have these columns:
|
|
- **Brand** - Manufacturer (e.g., BambuLab)
|
|
- **Tip** - Material type (e.g., PLA, PETG, ABS)
|
|
- **Finish** - Finish type (e.g., Basic, Matte, Silk)
|
|
- **Boja** - Color name (e.g., Mistletoe Green, Hot Pink)
|
|
- **Refill** - Whether it's a refill spool
|
|
- **Vakum** - Vacuum sealed status
|
|
- **Otvoreno** - Opened status
|
|
- **Količina** - Quantity
|
|
- **Cena** - Price
|
|
|
|
## Color Mapping
|
|
|
|
The app includes mappings for common Bambu Lab colors:
|
|
- Basic colors: Red, Blue, Green, Yellow, etc.
|
|
- Special colors: Mistletoe Green, Indigo Purple, Hot Pink, etc.
|
|
- Gradient filaments: Cotton Candy Cloud
|
|
- Matte finishes: Scarlet Red, Marine Blue, etc.
|
|
|
|
Unknown colors default to light gray.
|
|
|
|
## Deployment
|
|
|
|
Push to the main branch to trigger automatic deployment:
|
|
|
|
```bash
|
|
git add .
|
|
git commit -m "Update filament colors"
|
|
git push origin main
|
|
```
|
|
|
|
Amplify will automatically build and deploy your changes.
|
|
|
|
## Adding New Colors
|
|
|
|
To add new color mappings, edit `src/data/bambuLabColors.ts`:
|
|
|
|
```typescript
|
|
export const bambuLabColors: Record<string, ColorMapping> = {
|
|
// ... existing colors
|
|
'New Color Name': { hex: '#HEXCODE' },
|
|
};
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Color Not Showing
|
|
- Check if the color name matches exactly
|
|
- Add the color mapping to `bambuLabColors.ts`
|
|
- Colors are case-insensitive but spelling must match
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Contributing
|
|
|
|
1. Fork the repository
|
|
2. Create a feature branch
|
|
3. Commit your changes
|
|
4. Push to the branch
|
|
5. Create a Pull Request
|
|
|