How colmexbdcv/colmex_hyrax works
This is a Rails-based institutional digital repository built on Hyrax, customized for Colmex. The principal workflow is repository users searching catalog records or submitting and managing works; the app also exposes bulk imports, dashboard exports, IIIF/media, and specialized statistics. Work creation and updates pass through Hyrax controller behavior and a configured actor stack. The tree documents substantial domain-specific work types, forms, and indexers, but sampled source does not establish most of their runtime links, so those connections are omitted. Dashed links indicate documented dependencies or incomplete wiring evidence.
Main entry points: application.rb Actor configuration · routes.rb HTTP routes · works_controller_behavior.rb Work actions · models Repository models
Components 26
Discovery
- Catalog search
app/controllers/catalog_controller.rb - Search builder
app/models/search_builder.rb - Collection search
app/search_builders/hyrax/collection_search_builder.rb - Solr index
Work Management
- Work actions
app/controllers/concerns/hyrax/works_controller_behavior.rb - Work controllers
app/controllers/hyrax - Work forms
app/forms/hyrax - Actor configuration
config/application.rb - Record change actor
app/actors/record_change_actor.rb - Handle actor
app/actors/handle_actor.rb - Update actor
app/actors/fix_update_actor.rb - File visibility actor
app/actors/update_file_set_visibility_actor.rb
Bulk Data Operations
- Import endpoints
app/controllers/imports_controller.rb - CSV parser
app/importers/colmex_csv_parser.rb - Import service
app/services/importer_service.rb - Dashboard exports
app/controllers/dashboard/exports_controller.rb - Export service
app/services/exporter_service.rb - Export jobs
app/jobs
Domain and Processing
- Repository models
app/models - Work indexers
app/indexers - File derivatives
app/services/hyrax/file_set_derivatives_service.rb
Other components
- Repository user
- HTTP routes
config/routes.rb - Fedora repository
- SQL database
- Redis
Connections 21
- Repository user → HTTP routes: requests
config/routes.rb - HTTP routes → Catalog search: routes search
config/routes.rb - HTTP routes → Import endpoints: routes imports
config/routes.rb - HTTP routes → Dashboard exports: routes exports
config/routes.rb - HTTP routes → Work controllers: mounts Hyrax
config/routes.rb - Work actions → Actor configuration: uses actor
- Actor configuration → Record change actor: inserts before
config/application.rb - Actor configuration → Handle actor: inserts before
config/application.rb - Actor configuration → Update actor: inserts after
config/application.rb - Actor configuration → File visibility actor: inserts after
config/application.rb - Catalog search → Solr index: searches
- Import endpoints → Import service: dispatches import
- Import service → CSV parser: parses CSV
- Dashboard exports → Export jobs: queues export
- Export service → Solr index: reads records
- Work actions → Fedora repository: persists works
- Work actions → Repository models: manages works
- Repository models → Work indexers: indexed by
- File derivatives → Fedora repository: serves derivatives
- Repository models → SQL database: stores metadata
- Export jobs → Redis: queued via