A production-ready knowledge crosswalk system bridging multiple classification schemes
Live Demo โข Documentation โข Architecture
ATLAS-X is an interactive knowledge organization system that unifies multiple academic classification schemes into a single browsable concept graph. It enables researchers, librarians, and scholars to explore 113 concepts across 11 major domains while seeing how each concept is represented across different international classification standards.
ATLAS-X provides a unified view of scholarly knowledge by:
- Integrating 5 classification schemes: Library of Congress (LCC), ISCED-F, OECD FOS, ACM CCS, and MeSH
- Organizing 113 concepts across 11 academic domains (Science, Technology, Health, Social Sciences, etc.)
- Mapping semantic relationships between concepts (broader, narrower, related)
- Enabling cross-scheme discovery: See how "Computer Science" appears in library, education, and computing classification systems
This is useful for cross-institutional cataloging, interdisciplinary research, and understanding how different organizations classify the same knowledge.
๏ฟฝ๏ธ Concept Browser ๐ Multi-Scheme Views ๐ Relationship Graph
Navigate 113 concepts by View LCC, ISCED-F, OECD Explore how concepts
domain (Science, Tech, FOS, ACM CCS, and MeSH connect: broader, narrower,
Health, Arts, etc.) codes for each concept and related links
Unlike traditional systems that force you into one classification hierarchy, ATLAS-X treats concepts as first-class citizens. Each concept exists independently and can be viewed through any classification lens.
See how "Data Science" is classified as LCC QA76.9.D338 (library), ISCED-F 0612 (education), and OECD FOS 1.2 (research funding)โall in one place.
Built with clean architecture principles, demonstrating professional code organization and separation of concerns in a real-world application.
Unlike traditional systems that force you into one classification hierarchy, ATLAS-X treats concepts as first-class citizens. Each concept exists independently and can be viewed through any classification lens.
The codebase itself is a teaching toolโevery layer (Domain, Data, Service, Presentation, Behavior) demonstrates separation of concerns principles in production code.
ATLAS-X includes "Separation of Concerns" as both a formal concept in the knowledge graph AND as the organizing principle behind the code structureโshowing how abstract principles become concrete practice.
|
|
|
Example: Software Architecture relates to:
|
ATLAS-X demonstrates Clean Architecture in production:
src/
โโโ ๐ฏ domain/ Pure business logic (no frameworks)
โ โโโ entities/ Classification, CrosswalkMapping
โ โโโ value-objects/ ClassificationCode, ConfidenceScore
โ โโโ repositories/ Repository interfaces
โ
โโโ ๐พ data/ Data access patterns
โ โโโ repositories/ Implementation of domain interfaces
โ
โโโ โ๏ธ services/ Business logic orchestration
โ โโโ use-cases/ FindCrosswalks, SearchClassifications
โ
โโโ ๐จ components/ UI components
โ โโโ ui/ shadcn/ui design system
โ โโโ presentation/ Business-specific components
โ
โโโ ๐ hooks/ React state management
โ โโโ [Custom hooks]
โ
โโโ ๐ฑ app/ Next.js App Router
โโโ page.tsx Main ATLAS-X browser (113 concepts)
Beyond its practical use as a classification crosswalk tool, ATLAS-X serves as:
- Educational Resource: Demonstrates how knowledge is organized across different systems
- Architecture Example: Shows clean architecture and separation of concerns in production code
- Domain Modeling: Illustrates how to model complex relationships in a knowledge graph
Notable concepts include "Separation of Concerns" (bridging library science and software engineering) and "Software Architecture" (showing how organizational principles apply to code).---
| Category | Technologies |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript 5.0 (Strict mode) |
| Styling | Tailwind CSS 3.4 + shadcn/ui |
| Database | PostgreSQL + Prisma ORM (planned) |
| Architecture | Clean Architecture / Hexagonal |
| Deployment | Vercel (Edge Runtime) |
Node.js 18+ | npm/yarn | Git# Clone the repository
git clone https://github.com/DeviScript/ATLAS-X.git
cd ATLAS-X
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Start development server
npm run devVisit http://localhost:3000 to see ATLAS-X in action.
npm run build
npm run start| Metric | Value |
|---|---|
| Concepts | 113 |
| Domains | 11 |
| Classification Schemes | 5 (LCC, ISCED-F, OECD FOS, ACM CCS, MeSH) |
| Semantic Relationships | 125+ |
| Lines of Code | ~3,000 (main app) |
| Type Safety | 100% TypeScript |
- Concept-based knowledge graph with 113 concepts
- Interactive 3-panel browser interface
- Universal search across all schemes
- Clean architecture implementation
- Production deployment on Vercel
- Extract reusable components from monolithic page
- Add Schema.org, Wikidata, OpenAlex schemes
- Implement confidence scoring for mappings
- Build mapping workbench UI
- Database integration (PostgreSQL + Prisma)
- REST API for programmatic access
- Provenance tracking (who, how, when)
- Export capabilities (JSON, RDF, CSV)
- User authentication and custom mappings
-
/aboutpage explaining ATLAS-X -
/docswith API documentation - Tutorial videos and guides
- Contributing guidelines expansion
|
Discover related concepts across classification systems. Find connections between disciplines that traditional taxonomies hide. |
Map institutional classification schemes to international standards. Understand equivalent codes across systems. |
Study a production-ready example of clean architecture with TypeScript, Next.js, and modern React patterns. |
|
Build knowledge graphs from structured taxonomies. Extract semantic relationships for ML training. |
Teach relationships between academic disciplines. Show students how knowledge is organized. |
Integrate multiple classification systems. Provide unified access to diverse catalogs. |
Comprehensive documentation available in /docs:
- Architecture Overview - System design and layers
- Data Sources - Classification scheme details
- Development Plan - Implementation roadmap
- Testing Strategy - QA approach
Contributions make open source amazing! Any contributions you make are greatly appreciated.
1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request- Follow TypeScript strict mode
- Maintain clean architecture boundaries
- Use repository pattern for data access
- Write tests for critical functionality
- Document complex logic
See .github/copilot-instructions.md for detailed guidelines.
ATLAS-X showcases how concepts span multiple classification systems:
Example: Computer Science
- LCC QA75-76.95 (Electronic computers)
- ISCED-F 0613 (Software development)
- OECD FOS 1.2 (Computer and information sciences)
- ACM CCS 10003120 (Computer systems organization)
This multi-scheme view helps researchers understand:
- How different institutions classify the same concept
- Relationships between concepts across domains
- Equivalent codes for cross-institutional cataloging
The codebase demonstrates clean architecture principles with layered separation (Domain โ Data โ Service โ Presentation), making it both a useful tool AND a learning resource for software design patterns.---
Distributed under the MIT License. See LICENSE for more information.
- Next.js - React framework for production
- shadcn/ui - Beautiful UI components
- Tailwind CSS - Utility-first CSS framework
- Lucide Icons - Beautiful icon set
- Classification data from public domain and open-access sources
Project Link: github.com/DeviScript/ATLAS-X
Live Demo: [Your Vercel URL]
Made with โค๏ธ by DeviScript