# Implementation Tasks

## 1. Project Structure
- [x] 1.1 Scripts placed in project root directory

## 2. Environment Check Script
- [x] 2.1 Create `check-env.sh` with executable permissions
- [x] 2.2 Implement Python version check (3.10+)
- [x] 2.3 Implement Node.js and npm check
- [x] 2.4 Implement Docker availability check
- [x] 2.5 Implement virtual environment check (venv/)
- [x] 2.6 Implement .env file check with template guidance
- [x] 2.7 Implement port availability check (8000, 3000, 9000, 9001)
- [x] 2.8 Add colored output and clear error messages

## 3. Start Development Script
- [x] 3.1 Create `start-dev.sh` with executable permissions
- [x] 3.2 Call check-env.sh before starting services
- [x] 3.3 Start MinIO via docker-compose (with health check wait)
- [x] 3.4 Activate venv and start backend (uvicorn in background)
- [x] 3.5 Wait for backend to be healthy (curl localhost:8000/health or similar)
- [x] 3.6 Install frontend dependencies if node_modules missing
- [x] 3.7 Start frontend dev server (npm run dev in background)
- [x] 3.8 Display service URLs when all services are running
- [x] 3.9 Handle Ctrl+C to trigger graceful shutdown

## 4. Stop Development Script
- [x] 4.1 Create `stop-dev.sh` with executable permissions
- [x] 4.2 Stop frontend dev server
- [x] 4.3 Stop backend uvicorn process
- [x] 4.4 Stop MinIO docker container
- [x] 4.5 Display confirmation messages

## 5. Documentation
- [x] 5.1 Add usage instructions to scripts (--help flag)
- [x] 5.2 Update .env.example with any new required variables if needed

## Summary

**Completed:** All 18 tasks across 5 sections

### Scripts Created (in project root)
```
./check-env.sh    # Environment validation
./start-dev.sh    # Start all services
./stop-dev.sh     # Stop all services
```

### Service Ports
| Service  | Port | Description |
|----------|------|-------------|
| Backend  | 8000 | FastAPI server |
| Frontend | 3000 | Vite dev server |
| MinIO S3 | 9000 | Object storage API |
| MinIO UI | 9001 | Admin console |

### Usage

```bash
# Check environment prerequisites
./check-env.sh

# Start all services
./start-dev.sh

# Stop all services
./stop-dev.sh

# Start without MinIO (use external)
./start-dev.sh --no-minio

# Stop but keep MinIO running
./stop-dev.sh --keep-minio
```