# Project Structure

## Overview
Filamenteka is organized with clear separation between frontend, API, and infrastructure code.

## Directory Structure

```
filamenteka/
├── app/                      # Next.js app directory
│   ├── page.tsx             # Main page
│   ├── layout.tsx           # Root layout
│   └── upadaj/              # Admin pages
│       ├── page.tsx         # Admin login
│       ├── dashboard/       # Filament management
│       └── colors/          # Color management
│
├── src/                     # Source code
│   ├── components/          # React components
│   │   ├── FilamentTableV2.tsx
│   │   ├── EnhancedFilters.tsx
│   │   ├── ColorSwatch.tsx
│   │   ├── InventoryBadge.tsx
│   │   └── MaterialBadge.tsx
│   ├── types/              # TypeScript types
│   │   ├── filament.ts
│   │   └── filament.v2.ts
│   ├── services/           # API services
│   │   └── api.ts
│   └── styles/             # Component styles
│       ├── index.css
│       └── select.css
│
├── api/                    # Node.js Express API
│   ├── server.js          # Express server
│   ├── migrate.js         # Database migration script
│   ├── package.json       # API dependencies
│   └── Dockerfile         # Docker configuration
│
├── database/              # Database schemas
│   └── schema.sql        # PostgreSQL schema
│
├── terraform/             # Infrastructure as Code
│   ├── main.tf           # Main configuration
│   ├── vpc.tf            # VPC and networking
│   ├── rds.tf            # PostgreSQL RDS
│   ├── ec2-api.tf        # EC2 for API server
│   ├── alb.tf            # Application Load Balancer
│   ├── ecr.tf            # Docker registry
│   ├── cloudflare-api.tf # Cloudflare DNS
│   └── variables.tf      # Variable definitions
│
├── scripts/               # Utility scripts
│   ├── security/         # Security checks
│   │   └── security-check.js
│   └── pre-commit.sh     # Git pre-commit hook
│
├── 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)

## Key Concepts

### Architecture
- **Frontend**: Next.js static site hosted on AWS Amplify
- **API**: Node.js Express server running on EC2
- **Database**: PostgreSQL on AWS RDS
- **HTTPS**: Application Load Balancer with ACM certificate

### Data Flow
1. Frontend (Next.js) → HTTPS API (ALB) → Express Server (EC2) → PostgreSQL (RDS)
2. Authentication via JWT tokens
3. Real-time database synchronization

### Infrastructure
- Managed via Terraform
- AWS services: RDS, EC2, ALB, VPC, ECR, Amplify
- Cloudflare for DNS management
- Docker for API containerization

## Development Workflow

1. **Local Development**
   ```bash
   npm run dev
   ```

2. **Deploy Infrastructure**
   ```bash
   cd terraform
   terraform apply
   ```

3. **Deploy API Updates**
   - API automatically pulls latest Docker image every 5 minutes
   - Or manually: SSH to EC2 and run deployment script

## Database Management

### Run Migrations
```bash
cd api
npm run migrate
```

### Connect to Database
```bash
psql postgresql://user:pass@rds-endpoint/filamenteka
```

## Security

- No hardcoded credentials
- JWT authentication for admin
- Environment-specific configurations
- Pre-commit security checks
- HTTPS everywhere
- VPC isolation for backend services