IAV-86/feat(common): add FileManagerServicePath for file manager service integration
This MR adds the FileManagerServicePath class to enable standardized inter-service communication with the iavia-file-manager-service, along with comprehensive technical documentation for the entire iavia-common package.
Changes
🆕 New Features
-
FileManagerServicePath class (
urlServiceConstant.Path)- Complete URL builder for all FileManager service endpoints
- Supports upload, download, metadata, delete, list, and access log operations
- Includes specialized Agent Family KB upload endpoint
- Implements safe URL parameter encoding
- Provides fluent API builder pattern for complex URLs
📚 Documentation
-
Technical Documentation for
iavia-commonpackage- Package architecture and structure
- Detailed usage rules and best practices
- Inter-service communication patterns
- Configuration examples via config-server
- Integration checklist for new services
- Examples of service implementations
Implementation Details
FileManagerServicePath Coverage
-
✅ Upload operations (single/multiple files) -
✅ Agent Family KB uploads -
✅ File download by UID -
✅ Metadata retrieval (single/batch) -
✅ File existence checks -
✅ URL generation (presigned/public) -
✅ Delete operations (single/bulk) -
✅ List operations (by usage type, uploader, folder) -
✅ File search by name -
✅ Access logs (file/user)
Closes IAV-86