geoblacklight_admin
⚠️ LEGACY PROJECT — NO MAINTAINER
Warning: The BTAA still uses this project in production, but we're planning to abandon this codebase and rebuild our internal OpenGeoMetadata Aardvark workflow tools using FastAPI and React. If you need an Aardvark workflow today, please review the OGM Metadata Studio
GeoBlacklight Admin is a GeoBlacklight plugin, built on Kithe, that provides a complex web-form for editing documents and an CSV-based import/export workflow for OpenGeoMetadata's Aardvark schema. GBL Admin is based on the Big Ten Academic Alliance's production workflow tool GEOMG.
Requirements
- Rails v7 (not v8)
- Blacklight v7 (not v8)
- GeoBlacklight v4 (not v5)
- @geoblacklight/frontend v4 (NPM package)
- Solr v8.4+
- PostgreSQL (not MySQL-based DBs)
- Redis (for Sidekiq)
- OpenGeoMetadata's Aardvark Schema
Installation
PostgreSQL
You need a PostgreSQL database to use this project.
- Homebrew: https://wiki.postgresql.org/wiki/Homebrew
- Docker: https://www.docker.com/blog/how-to-use-the-postgres-docker-official-image/
Install Template
1. Create your geoblacklight_admin_development PostgreSQL database
psql postgres
CREATE DATABASE geoblacklight_admin_development;2. Bootstrap a new GeoBlacklight + GBL Admin application using the template script:
rails _7.2.2_ new gbl_admin -m https://raw.githubusercontent.com/geobtaa/geoblacklight_admin/develop/template.rb
cd gbl_admin
bundle exec rake geoblacklight:serverYou have now generated the .internal_test_app and populated the Elements / FormElements tables for OMG Aardvark support.
View App in Browser
- Visit http://localhost:3000/admin
- Click on the "Sign in" link
- Enter email: admin@geoblacklight.org and password: 123456
- Click on the "GBL Admin" link
- Import some CSV data (test/fixtures/files/btaa_sample_records.csv)
Contributing
For Developer documentation see doc/developer.md
License
The gem is available as open source under the terms of the Apache 2.0 License.
TODOs / Roadmap
Send GBLADMIN JavaScript pack to NPM like BlacklightImprove test coverageFix CI test runnerDebug Rails 7.2 support (remove devise_invitable, see #915)Separate dct_references_s support into a separate modelImport/Export dct_references_s outside of the main document modelDistributions: Move import to background queueData Dictionary: Add support fordocument_data_dictionary- Gazetteer: Add GeoNames support
- Gazetteer: Add Who's On First support
- Gazetteer: Add Ollama support
- Gazetteer: Add BTAA spatial file support
- Migrate our GBL API controllers to just RSolr-based models
- DRY up Gem dependencies and Engine routing
- Remove any remaining GEOMG references
