feat: basic firmware registry

docs/ARCHITECTURE.md

@@ -0,0 +1,85 @@
+# Architecture
+
+## Overview
+
+The refactored code follows a clean architecture pattern with clear separation of concerns:
+
+### 1. **Models** (`internal/models/`)
+- Contains all data structures and types
+- `FirmwareMetadata`, `FirmwareRecord`, `GroupedFirmware`, etc.
+- Pure data structures with JSON tags
+
+### 2. **Config** (`internal/config/`)
+- Configuration management
+- Environment variable handling
+- Default values and validation
+
+### 3. **Database** (`internal/database/`)
+- Database connection management
+- Table creation and schema management
+- Connection lifecycle handling
+
+### 4. **Repository** (`internal/repository/`)
+- Data access layer
+- Database operations (CRUD)
+- SQL query management
+- Data mapping between database and models
+
+### 5. **Storage** (`internal/storage/`)
+- File system operations
+- Firmware binary storage
+- File path management
+- File existence checks
+
+### 6. **Service** (`internal/service/`)
+- Business logic layer
+- Orchestrates repository and storage operations
+- Data validation and processing
+- Version comparison logic
+
+### 7. **Handlers** (`internal/handlers/`)
+- HTTP request handling
+- Request/response processing
+- Error handling and status codes
+- Input validation
+
+### 8. **App** (`internal/app/`)
+- Application initialization
+- Dependency injection
+- Route setup
+- Server configuration
+
+### 9. **Main** (`main.go`)
+- Entry point
+- Minimal and focused
+- Error handling and graceful shutdown
+
+## Environment Variables
+
+- `PORT`: Server port (default: 3002)
+- `DB_PATH`: Database file path (default: ./registry.db)
+- `REGISTRY_PATH`: Firmware storage directory (default: registry)
+- `MAX_UPLOAD_SIZE`: Maximum upload size in bytes (default: 32MB)
+
+## API Endpoints
+
+All API endpoints remain the same:
+
+- `POST /firmware` - Upload firmware
+- `GET /firmware` - List firmware (with optional filters)
+- `GET /firmware/{name}/{version}` - Download firmware
+- `PUT /firmware/{name}/{version}` - Update firmware metadata
+- `GET /health` - Health check
+
+## Testing
+
+```bash
+# Run all tests
+go test ./...
+
+# Run tests with coverage
+go test -cover ./...
+
+# Run specific test
+go test -run TestStoreFirmwareMetadata
+```