Major restructure: Remove Confluence, add V2 data structure, organize for dev/prod
- 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>
This commit is contained in:
121
PROJECT_STRUCTURE.md
Normal file
121
PROJECT_STRUCTURE.md
Normal file
@@ -0,0 +1,121 @@
|
||||
# Project Structure
|
||||
|
||||
## Overview
|
||||
Filamenteka is organized with clear separation between environments, infrastructure, and application code.
|
||||
|
||||
## Directory Structure
|
||||
|
||||
```
|
||||
filamenteka/
|
||||
├── app/ # Next.js app directory
|
||||
│ ├── page.tsx # Main page
|
||||
│ ├── layout.tsx # Root layout
|
||||
│ ├── admin/ # Admin pages
|
||||
│ │ ├── page.tsx # Admin login
|
||||
│ │ └── dashboard/ # Admin dashboard
|
||||
│ └── globals.css # Global styles
|
||||
│
|
||||
├── src/ # Source code
|
||||
│ ├── components/ # React components
|
||||
│ │ ├── FilamentTable.tsx
|
||||
│ │ ├── FilamentForm.tsx
|
||||
│ │ └── ColorCell.tsx
|
||||
│ ├── types/ # TypeScript types
|
||||
│ │ └── filament.ts
|
||||
│ ├── data/ # Data and utilities
|
||||
│ │ └── bambuLabColors.ts
|
||||
│ └── styles/ # Component styles
|
||||
│ └── select.css
|
||||
│
|
||||
├── lambda/ # AWS Lambda functions
|
||||
│ ├── filaments/ # Filaments CRUD API
|
||||
│ │ ├── index.js
|
||||
│ │ └── package.json
|
||||
│ └── auth/ # Authentication API
|
||||
│ ├── index.js
|
||||
│ └── package.json
|
||||
│
|
||||
├── terraform/ # Infrastructure as Code
|
||||
│ ├── environments/ # Environment-specific configs
|
||||
│ │ ├── dev/
|
||||
│ │ └── prod/
|
||||
│ ├── main.tf # Main Terraform configuration
|
||||
│ ├── dynamodb.tf # DynamoDB tables
|
||||
│ ├── lambda.tf # Lambda functions
|
||||
│ ├── api_gateway.tf # API Gateway
|
||||
│ └── variables.tf # Variable definitions
|
||||
│
|
||||
├── scripts/ # Utility scripts
|
||||
│ ├── data-import/ # Data import tools
|
||||
│ │ ├── import-pdf-data.js
|
||||
│ │ └── clear-dynamo.js
|
||||
│ ├── security/ # Security checks
|
||||
│ │ └── security-check.js
|
||||
│ └── build/ # Build scripts
|
||||
│
|
||||
├── config/ # Configuration files
|
||||
│ └── environments.js # Environment configuration
|
||||
│
|
||||
└── public/ # Static assets
|
||||
```
|
||||
|
||||
## Environment Files
|
||||
|
||||
- `.env.development` - Development environment variables
|
||||
- `.env.production` - Production environment variables
|
||||
- `.env.local` - Local overrides (not committed)
|
||||
- `.env.development.local` - Local dev overrides (not committed)
|
||||
|
||||
## Key Concepts
|
||||
|
||||
### Environments
|
||||
- **Development**: Uses `dev` API Gateway stage and separate DynamoDB table
|
||||
- **Production**: Uses `production` API Gateway stage and main DynamoDB table
|
||||
|
||||
### Data Flow
|
||||
1. Frontend (Next.js) → API Gateway → Lambda Functions → DynamoDB
|
||||
2. Authentication via JWT tokens stored in localStorage
|
||||
3. Real-time data updates every 5 minutes
|
||||
|
||||
### Infrastructure
|
||||
- Managed via Terraform
|
||||
- Separate resources for dev/prod
|
||||
- AWS services: DynamoDB, Lambda, API Gateway, Amplify
|
||||
|
||||
## Development Workflow
|
||||
|
||||
1. **Local Development**
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
2. **Deploy to Dev**
|
||||
```bash
|
||||
cd terraform
|
||||
terraform apply -var-file=environments/dev/terraform.tfvars
|
||||
```
|
||||
|
||||
3. **Deploy to Production**
|
||||
```bash
|
||||
cd terraform
|
||||
terraform apply -var-file=environments/prod/terraform.tfvars
|
||||
```
|
||||
|
||||
## Data Management
|
||||
|
||||
### Import Data from PDF
|
||||
```bash
|
||||
node scripts/data-import/import-pdf-data.js
|
||||
```
|
||||
|
||||
### Clear DynamoDB Table
|
||||
```bash
|
||||
node scripts/data-import/clear-dynamo.js
|
||||
```
|
||||
|
||||
## Security
|
||||
|
||||
- No hardcoded credentials
|
||||
- JWT authentication for admin
|
||||
- Environment-specific configurations
|
||||
- Pre-commit security checks
|
||||
Reference in New Issue
Block a user