Add comprehensive test suite for CSASAuthorize package

- Implemented integration tests for Application and Auth flow in ApplicationAuthFlowTest.php.
- Created NotificatorTest.php to validate Notificator class functionality.
- Added TokenInfoTest.php for testing TokenInfo UI component.
- Developed WebPageTest.php to ensure proper functionality of WebPage UI class.
- Established bootstrap.php for test environment initialization.
- Created TokenTest.php to validate Token class methods and behaviors.
- Added test-export-functionality.php to verify export feature compatibility.
- Implemented verify_tests.php for automated test class verification and coverage summary.

Author: Vitexus

CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.0] - 2024-09-29
+
+### Added
+
+#### Export Functionality
+- **NEW**: Export mode in `csas-access-token.php` tool via `--export` / `-x` option
+- Export application data in Developer Portal compatible JSON format
+- Support for exporting by application ID or UUID
+- File output or stdout output for piping to other tools
+- Complete bidirectional data flow: import + export capabilities
+- Comprehensive documentation in `docs/EXPORT_FUNCTIONALITY.md`
+
+#### Enhanced OAuth2 Error Handling  
+- Graceful handling of expired refresh tokens in `Token::refreshToken()`
+- New methods: `isRefreshTokenExpired()`, `needsRefresh()`, `getTokenStatus()`
+- Automatic redirect to re-authorization when refresh token expires
+- Proper exception handling for `IdentityProviderException`
+
+#### Developer Portal Import System
+- Web interface for importing Developer Portal data (`src/import.php`)
+- Command-line import tool (`import-from-portal` command) 
+- `DeveloperPortalImporter` class with validation and field mapping
+- Support for hierarchical and flat JSON formats
+- Integration into main UI with "Import from Developer Portal" link
+- Comprehensive documentation in `DEVELOPER_PORTAL_IMPORT.md`
+
+#### Comprehensive Test Suite
+- **NEW**: Complete PHPUnit test coverage for all SpojeNet classes
+- Unit tests: `ApplicationTest`, `AuthTest`, `NotificatorTest`, `TokenInfoTest`, `WebPageTest`
+- Integration test: `ApplicationAuthFlowTest` for complete OAuth2 workflow  
+- Mock-based testing for external API dependencies
+- Test documentation in `TEST_SUITE_DOCUMENTATION.md`
+
+### Changed
+
+#### Documentation Updates
+- Updated `README.md` with export functionality and bidirectional workflow
+- Enhanced command-line usage examples with export options
+- Updated man page (`debian/csas-access-token.1`) with new export option
+- Expanded `DEVELOPER_PORTAL_IMPORT.md` with export information
+- Added comprehensive export documentation
+
+#### Tool Enhancements
+- Extended `csas-access-token.php` with new command-line options
+- Updated help text and usage information
+- Better error messages and exit codes
+- Support for both numeric IDs and UUIDs in export mode
+
+### Technical Details
+
+#### Database Schema
+No changes to existing database schema. All new functionality works with existing tables:
+- `application` table: stores application data with sandbox/production environments
+- `token` table: stores OAuth2 tokens with refresh capabilities
+
+#### API Compatibility
+- Maintains backward compatibility with existing OAuth2 flows
+- All existing functionality preserved
+- New features are additive and optional
+
+#### Security Considerations
+- Export functionality includes sensitive client secrets and API keys
+- Proper validation and sanitization of import data
+- Clear security warnings in documentation
+- No exposure of sensitive data in logs or error messages
+
+#### Performance Impact
+- Export operations are lightweight database queries
+- Import operations include validation overhead but process quickly
+- Test suite runs efficiently with mock objects
+- No impact on existing token refresh performance
+
+## Previous Versions
+
+### Historical Note
+This project has been in development since June 2024. This changelog documents major enhancements added during development iterations in September 2024, focusing on:
+
+1. **OAuth2 Robustness**: Handling refresh token expiration gracefully
+2. **Data Portability**: Bidirectional import/export with Developer Portal format  
+3. **Test Coverage**: Comprehensive automated testing infrastructure
+4. **Documentation**: Complete usage and implementation documentation
+
+### Dependencies
+- PHP 8.4+ with OAuth2 and database support
+- League OAuth2 Client for CSAS API integration  
+- PHPUnit for testing infrastructure
+- Bootstrap 5 via Ease framework for UI components
+- MySQL/MariaDB or SQLite for data storage
+
+### Migration Notes
+- No database migrations required for new functionality
+- Existing applications and tokens continue working without changes
+- New export feature requires existing application data to be present
+- Import feature can be used immediately without any setup

DEVELOPER_PORTAL_IMPORT.md

@@ -0,0 +1,236 @@
+# CSAS Developer Portal Data Import
+
+## Přehled
+
+CSAS Authorize nyní podporuje **bidirectional** data flow s CSAS Developer Portal - jak import, tak export dat aplikací.
+
+### Import z Developer Portal
+Import dat aplikací z CSAS Developer Portal do CSAS Authorize eliminuje nutnost ručního opisování konfiguračních údajů.
+
+### Export do formátu Developer Portal
+Nový export umožňuje exportovat data z CSAS Authorize do formátu kompatibilního s Developer Portal pro zálohu, migraci nebo sdílení mezi instancemi.
+
+## Aktuální stav Developer Portal
+
+K datu 29. září 2025 **CSAS Developer Portal (https://developers.erstegroup.com/) neposkytuje automatizovaný export dat aplikací**. Proto jsme implementovali:
+1. **Import nástroj** pro ruční import dat ve formátu JSON 
+2. **Export nástroj** pro generování dat ve formátu kompatibilním s Developer Portal
+
+## Implementované nástroje
+
+### Export funkčnost
+
+**Umístění:** `libexec/csas-access-token.php` (rozšířeno o `--export` možnost)
+
+**Použití:**
+```bash
+# Export aplikace podle ID do stdout
+php libexec/csas-access-token.php --export=1
+
+# Export aplikace podle UUID do souboru  
+php libexec/csas-access-token.php --export=71004963-e3d4-471f-96fc-1aef79d17ec1 --output=backup.json
+
+# Export s krátkou volbou
+php libexec/csas-access-token.php -x 1 -o export.json
+```
+
+**Funkce:**
+- Export dat z CSAS Authorize do Developer Portal kompatibilního JSON formátu
+- Podpora exportu podle ID nebo UUID aplikace
+- Filtrování prázdných hodnot pro čistý JSON výstup
+- Výstup do souboru nebo stdout pro piping do jiných nástrojů
+- Úplná kompatibilita s import nástrojem
+
+### Import funkčnost
+
+**Umístění:** `src/SpojeNet/CSas/DeveloperPortalImporter.php`
+
+**Funkce:**
+- Import dat z JSON souboru
+- Import dat z JSON řetězce 
+- Mapování různých formátů dat z Developer Portal
+- Validace povinných polí
+- Automatické uložení do databáze
+
+### 2. Webové rozhraní pro import
+
+**Umístění:** `src/import.php`
+
+**Funkce:**
+- Formulář pro nahrání JSON souboru
+- Možnost vložení JSON dat přímo do textového pole
+- Zobrazení příkladu očekávaného formátu JSON
+- Průvodce manuálním exportem z Developer Portal
+
+### 3. Integrace do uživatelského rozhraní
+
+- Přidán odkaz "Import from Developer Portal" na hlavní stránku
+- Breadcrumb navigace pro snadný návrat
+- Automatické přesměrování na detail aplikace po úspěšném importu
+
+## Podporované formáty JSON
+
+### Hierarchická struktura (doporučená)
+
+```json
+{
+  "name": "Název aplikace",
+  "id": "application-uuid-from-portal", 
+  "logoUrl": "https://example.com/logo.png",
+  "email": "developer@example.com",
+  "sandbox": {
+    "clientId": "sandbox-client-uuid",
+    "clientSecret": "sandbox-client-secret", 
+    "apiKey": "sandbox-api-key-uuid",
+    "redirectUri": "https://myapp.example.com/sandbox/callback"
+  },
+  "production": {
+    "clientId": "production-client-uuid",
+    "clientSecret": "production-client-secret",
+    "apiKey": "production-api-key-uuid", 
+    "redirectUri": "https://myapp.example.com/production/callback"
+  }
+}
+```
+
+### Plochá struktura (alternativní)
+
+```json
+{
+  "name": "Název aplikace",
+  "uuid": "application-uuid",
+  "sandboxClientId": "sandbox-client-uuid",
+  "sandboxClientSecret": "sandbox-client-secret",
+  "sandboxApiKey": "sandbox-api-key",
+  "sandboxRedirectUri": "https://example.com/sandbox/callback",
+  "productionClientId": "production-client-uuid", 
+  "productionClientSecret": "production-client-secret",
+  "productionApiKey": "production-api-key",
+  "productionRedirectUri": "https://example.com/production/callback"
+}
+```
+
+## Mapování polí
+
+Importér automaticky mapuje různé názvy polí z Developer Portal:
+
+| Developer Portal | CSAS Authorize DB |
+|------------------|-------------------|
+| `name` / `applicationName` | `name` |
+| `id` / `applicationId` / `uuid` | `uuid` |
+| `logoUrl` / `logo` | `logo` |
+| `email` / `contactEmail` | `email` |
+| `sandbox.clientId` | `sandbox_client_id` |
+| `sandbox.clientSecret` | `sandbox_client_secret` |
+| `sandbox.apiKey` | `sandbox_api_key` |
+| `sandbox.redirectUri` | `sandbox_redirect_uri` |
+
+## Manuální postup exportu
+
+Protože Developer Portal nemá export funkci:
+
+1. **Přihlaste se do Developer Portal:** https://developers.erstegroup.com/portal/organizations/vitezslav-dvorak/applications
+2. **Otevřete detail aplikace** kterou chcete importovat
+3. **Zkopírujte následující údaje:**
+   - Název aplikace
+   - Application ID (UUID)
+   - Logo URL (pokud existuje)
+   - Sandbox Client ID
+   - Sandbox Client Secret  
+   - Sandbox API Key
+   - Production Client ID
+   - Production Client Secret
+   - Production API Key
+   - Redirect URI pro oba prostředí
+4. **Vytvořte JSON** podle výše uvedeného formátu
+5. **Použijte import formulář** v CSAS Authorize
+
+## Validace dat
+
+Importér ověřuje:
+
+- **Povinná pole:** `name` a `uuid` musí být vyplněny
+- **Alespoň jedno prostředí:** Sandbox NEBO production musí mít kompletní credentials (client_id a client_secret)
+- **Formát JSON:** Data musí být ve validním JSON formátu
+
+## Bezpečnostní upozornění
+
+⚠️ **Bezpečnost dat:**
+- Client secrets a API klíče jsou citlivé údaje
+- Importujte pouze z důvěryhodných zdrojů
+- Ujistěte se, že JSON soubory neuchovávate v nezabezpečených místech
+- Po importu si ověřte, že údaje jsou správné
+
+## Testování
+
+Vytvořena kompletní testovací sada v `tests/DeveloperPortalImporterTest.php` která pokrývá:
+
+- Import z JSON souboru a dat
+- Mapování různých formátů polí
+- Validaci povinných údajů
+- Zpracování chybových stavů
+- Bezpečnostní kontroly
+
+## Bidirectional workflow
+
+Nyní je možný úplný bidirectional workflow:
+
+```bash
+# 1. Export z jedné instance CSAS Authorize
+php libexec/csas-access-token.php --export=1 --output=backup.json
+
+# 2. Import do jiné instance (nebo stejné instance)
+# Import to another instance (or same instance)
+import-from-portal --file backup.json
+
+# 3. Nebo přes webové rozhraní
+# Nahrajte backup.json přes /import.php
+```
+
+### Použití pro zálohy a migrace
+
+```bash
+# Záloha všech aplikací (může být automatizováno)
+for app_id in $(php -r "/* získej seznam ID aplikací */"); do
+    php libexec/csas-access-token.php --export=$app_id --output="backup-$app_id.json"
+done
+
+# Obnovení ze zálohy
+for backup_file in backup-*.json; do
+    import-from-portal --file "$backup_file"
+done
+```
+
+## Doporučení pro CSAS
+
+**Navrhujeme CSAS aby do Developer Portal přidal:**
+
+1. **Export API** - programový přístup k datům aplikací
+2. **Export tlačítko** - možnost stažení JSON/CSV s daty aplikace
+3. **Webhook notifikace** - automatická synchronizace změn
+4. **Bulk export** - export všech aplikací najednou
+
+To by eliminovalo nutnost ručního kopírování a snížilo riziko chyb.
+
+## Použití
+
+### Z webového rozhraní:
+1. Přejděte na `import.php` 
+2. Nahrajte JSON soubor NEBO vložte JSON data
+3. Klikněte "Import Application"
+
+### Z kódu:
+```php
+$importer = new DeveloperPortalImporter();
+
+// Import z souboru
+$success = $importer->importFromJson('/path/to/export.json');
+
+// Import z pole
+$success = $importer->importFromArray($applicationData);
+
+// Získání importované aplikace
+$app = $importer->getApplication();
+```
+
+Toto řešení poskytuje flexibilní a bezpečný způsob importu dat z CSAS Developer Portal do CSAS Authorize aplikace.

Makefile

@@ -38,3 +38,18 @@ sysmigration: ## Run database migrations using system phinx
 .PHONY: newmigration
 newmigration: ## Prepare new Database Migration
 	read -p "Enter CamelCase migration name : " migname ; cd src ; ../vendor/bin/phinx create $$migname -c ../phinx-adapter.php ; cd ..
+
+usesqlite: ## Use SQLite database for tests
+	@echo "Updating .env to use a fresh SQLite database for tests..."
+	@sqlite_db="var/test_database.sqlite"
+	@rm -f "$$sqlite_db"
+	@touch "$$sqlite_db"
+	@if [ ! -f .env ]; then \
+		touch .env; \
+	fi
+	@sed -i.bak '/^DB_CONNECTION=/d;/^DB_DATABASE=/d;/^DB_USERNAME=/d;/^DB_PASSWORD=/d' .env
+	@echo "DB_CONNECTION=sqlite" >> .env
+	@echo "DB_DATABASE=$$sqlite_db" >> .env
+	@echo "DB_USERNAME=" >> .env
+	@echo "DB_PASSWORD=" >> .env
+	@echo "Successfully updated .env to use SQLite database: $$sqlite_db"