galaxyproject / galaxyproject/brc-analytics

Link from NCBI to BRC Analytics

Open
#783 6 comments 0 reactions 1 assignee Claimed by @d-callan View on GitHub
roadmap item
Dominant language
TypeScript
Stars
7
Forks
11
Avg merge
2d 12h
Merged PRs (30d)
16

Description

### Summary
NCBI and BRC Analytics are coordinating to improve cross-linking between their respective platforms.

### Current State
- **NCBI Assembly Pages** (e.g. [example](https://www.ncbi.nlm.nih.gov/datasets/genome/GCA_001008285.1/)) and **NCBI Organism Pages** (e.g. [example](https://www.ncbi.nlm.nih.gov/datasets/taxonomy/73230/)) currently provide assembly- and taxonomy-specific data from NCBI.
- **BRC Analytics** already links out to NCBI from its assembly pages, allowing users to easily navigate to the canonical NCBI records.

### Proposed Change
- **NCBI** has offered to add reciprocal links **from its assembly detail pages and organism pages back to BRC Analytics**.
- This would allow users browsing NCBI datasets to directly discover relevant resources and analytics available in BRC Analytics.

### Impact
- Improves discoverability of BRC Analytics resources from widely used NCBI entry points.
- Strengthens interoperability between NCBI and BRC Analytics.
- Provides researchers with a smoother navigation experience across both platforms.

### High-Level Tech Design

1. NCBI will periodically call BRC Analytics APIs to get the links to our [organism detail pages](https://brc-analytics.dev.clevercanary.com/data/organisms/73230) and our[ analyze pages](https://brc-analytics.dev.clevercanary.com/data/assemblies/GCA_001008285_1) for assemblies.
1. The API will be implemented by placing the JSON file at the appropriate path in the NextJS `public` folder during build time and serving the files statically from their path within public. For example, a file at `public/api/assets/myfile.json` will be available after build/export at `/api/assets/myfile.json`.
1. At build time or pre-build step, the assemblies.json and organisms.json files will be processed to extract the relevant information for linking to BRC.
1. Links will be available at /api/links/organism-links.json and /api/links/assembly-links.json
1. Exact file format and URL path TBD.

### Subtasks

- [ ] UI mocks for NCBI site for reciprocal linking
- [x] #782
- [ ] Download organism links API
- [ ] Organism page updates to add context to support arriving from an external site
- [ ] Analyze page updates to add context to support arriving from an external site
- [ ] Track inbound links from NCBI

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.