How dcane4ever/eac-file-directory works
This is a Spring-based academic file directory: users discover and download approved materials, while contributors upload files for moderation and administrators manage the catalog and storage. The tree shows distinct browse, upload, access-control, collaboration, and maintenance capabilities; sampled service code confirms several integrations among them. The README is empty, and most controllers and domain services were not excerpted, so uncertain workflow links are marked dashed rather than presented as verified calls.
Main entry points: FileEntity.java File records · FileStorageService.java Stored files · BrowseController.java Browse and search · UploadController.java Upload workflow
Components 22
Accounts and governance
- Accounts
src/main/java/ph/edu/eac/filedirectory/user/AppUser.java - Authentication
src/main/java/ph/edu/eac/filedirectory/web/AuthController.java - Admin controls
src/main/java/ph/edu/eac/filedirectory/web/AdminController.java
File catalog
- Academic taxonomy
src/main/java/ph/edu/eac/filedirectory/taxonomy/Department.java - Browse and search
src/main/java/ph/edu/eac/filedirectory/web/BrowseController.java - File records
src/main/java/ph/edu/eac/filedirectory/file/FileEntity.java - Stored files
src/main/java/ph/edu/eac/filedirectory/file/FileStorageService.java - Upload workflow
src/main/java/ph/edu/eac/filedirectory/web/UploadController.java - File moderation
src/main/java/ph/edu/eac/filedirectory/web/AdminController.java - Reference extraction
src/main/java/ph/edu/eac/filedirectory/reference/ReferenceExtractionService.java - Author detection
src/main/java/ph/edu/eac/filedirectory/reference/AuthorDetectionService.java - Citations
src/main/java/ph/edu/eac/filedirectory/citation/CitationService.java - Office preview
src/main/java/ph/edu/eac/filedirectory/onlyoffice/OnlyOfficeService.java
Access and collaboration
- Access requests
src/main/java/ph/edu/eac/filedirectory/access/AccessRequestService.java - Private sharing
src/main/java/ph/edu/eac/filedirectory/share/PrivateShareService.java - Followed topics
src/main/java/ph/edu/eac/filedirectory/follow/FollowService.java - Notifications
src/main/java/ph/edu/eac/filedirectory/notification/NotificationService.java
Administration and tools
- Audit trail
src/main/java/ph/edu/eac/filedirectory/audit/AuditService.java - Storage maintenance
src/main/java/ph/edu/eac/filedirectory/maintenance/StorageMaintenanceService.java - Maintenance console
src/main/java/ph/edu/eac/filedirectory/web/StorageMaintenanceController.java - System settings
src/main/java/ph/edu/eac/filedirectory/settings/SystemSettingService.java
Other components
- Directory user
Connections 22
- Directory user → Browse and search: browses
- Directory user → Upload workflow: submits files
- Directory user → Authentication: signs in
- Browse and search → File records: queries catalog
- Browse and search → Academic taxonomy: filters by
- Upload workflow → Stored files: stores content
- Upload workflow → File records: creates record
- File moderation → File records: updates status
src/main/java/ph/edu/eac/filedirectory/web/AdminController.java - Access requests → Notifications: notifies users
src/main/java/ph/edu/eac/filedirectory/access/AccessRequestService.java - Access requests → Audit trail: records actions
src/main/java/ph/edu/eac/filedirectory/access/AccessRequestService.java - Private sharing → Notifications: notifies recipient
src/main/java/ph/edu/eac/filedirectory/share/PrivateShareService.java - Private sharing → Audit trail: records sharing
src/main/java/ph/edu/eac/filedirectory/share/PrivateShareService.java - Followed topics → Notifications: notifies followers
src/main/java/ph/edu/eac/filedirectory/follow/FollowService.java - Maintenance console → Storage maintenance: scans storage
src/main/java/ph/edu/eac/filedirectory/web/StorageMaintenanceController.java - Storage maintenance → Stored files: checks stored files
src/main/java/ph/edu/eac/filedirectory/maintenance/StorageMaintenanceService.java - Storage maintenance → File records: checks references
src/main/java/ph/edu/eac/filedirectory/maintenance/StorageMaintenanceService.java - Maintenance console → Audit trail: records cleanup
src/main/java/ph/edu/eac/filedirectory/web/StorageMaintenanceController.java - Reference extraction → Stored files: reads documents
src/main/java/ph/edu/eac/filedirectory/reference/ReferenceExtractionService.java - Author detection → Stored files: reads documents
src/main/java/ph/edu/eac/filedirectory/reference/AuthorDetectionService.java - Office preview → File records: uses file metadata
src/main/java/ph/edu/eac/filedirectory/onlyoffice/OnlyOfficeService.java - Admin controls → System settings: manages settings
- Authentication → Accounts: authenticates accounts