https://github.com/shama-llama/semantic-web-kms
Semantic-based explicit knowledge management system for the domain of web development
https://github.com/shama-llama/semantic-web-kms
computer-science cosc-6232 semantic-web
Last synced: 11 months ago
JSON representation
Semantic-based explicit knowledge management system for the domain of web development
- Host: GitHub
- URL: https://github.com/shama-llama/semantic-web-kms
- Owner: shama-llama
- License: mit
- Created: 2025-06-24T16:34:06.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-13T21:16:12.000Z (11 months ago)
- Last Synced: 2025-07-13T22:23:18.148Z (11 months ago)
- Topics: computer-science, cosc-6232, semantic-web
- Language: Python
- Homepage: https://semantic-web-kms.vercel.app
- Size: 878 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Semantic Web KMS
[](https://www.python.org/)
[](https://nodejs.org/)
[](https://github.com/shama-llama/semantic-web-kms/actions/workflows/build.yml)
[](LICENSE)
**Semantic Web KMS** is a modular platform for extracting, semantically annotating, and managing software knowledge. It uses the [Web Development Ontology (WDO)](https://web-development-ontology.netlify.app/), supports multi-language code and documentation extraction, and provides a Next portal for search, analytics, and knowledge graph visualization.
## Features
- Ontology-driven semantic annotation
- Multi-language code and documentation extraction
- Knowledge graph and SPARQL querying (AllegroGraph)
- Interactive portal: dashboard, search, graph visualization
- Extensible pipeline and modular architecture
## Architecture
**Semantic Web KMS** is organized into modular components, each responsible for a distinct part of the knowledge management pipeline:
- **Extraction**: Extracts code, documentation, and metadata from repositories.
- **Annotation**: Semantically annotates extracted artifacts using ontologies.
- **Knowledge Graph**: Manages and queries semantic data (RDF, SPARQL, AllegroGraph).
- **Portal**: Provides a Next.js-based web interface for search, analytics, and visualization.
```mermaid
flowchart TD
%% Style Definitions for a Versatile, Light/Dark Mode Compatible Theme
%% Palette: Blue, Green, Purple
%% Backend Containers (Darker Blue)
classDef backend-container fill:#1e40af,stroke:#60a5fa,color:#eff6ff,stroke-width:2px;
%% Backend Inner Nodes (Lighter Blue)
classDef backend-inner fill:#1d4ed8,stroke:#93c5fd,color:#eff6ff,stroke-width:2px;
%% Frontend Containers (Darker Green)
classDef frontend-container fill:#047857,stroke:#34d399,color:#f0fdf4,stroke-width:2px;
%% Frontend Inner Nodes (Lighter Green)
classDef frontend-inner fill:#059669,stroke:#6ee7b7,color:#f0fdf4,stroke-width:2px;
%% Ontology Containers (Darker Purple)
classDef ontology-container fill:#5b21b6,stroke:#a78bfa,color:#f5f3ff,stroke-width:2px;
%% Ontology Inner Nodes (Lighter Purple)
classDef ontology-inner fill:#6d28d9,stroke:#c4b5fd,color:#f5f3ff,stroke-width:2px;
%% External Node Style (Neutral Gray)
classDef external fill:#4b5563,stroke:#9ca3af,color:#f3f4f6,stroke-width:2px;
%% A single, default link style is more robust
linkStyle default stroke:#38bdf8,stroke-width:2px;
%% Define All Modules First
%% External Actor & Inputs
user([User])
repo[(Code Repository)]
%% Central Pipeline Modules
subgraph Portal["Portal (Next.js)"]
direction TB
upload[Upload UI]
dashboard[Dashboard & Analytics]
search[Semantic Search]
graphviz[Graph Visualization]
end
subgraph API["API Server"]
api_server[FastAPI Server]
end
subgraph Extraction["Extraction Module"]
direction TB
ext_main[Main Extractor]
ext_main --> ext_code[Code Extractor] & ext_doc[Doc Extractor] & ext_git[Git Extractor] & ext_content[Content Extractor]
end
subgraph Annotation["Annotation Module"]
direction TB
annotator[Semantic Annotator]
sim_calc[Similarity Calculator]
postproc[Postprocessing]
annotator --> sim_calc --> postproc
end
subgraph KnowledgeGraph["Knowledge Graph Core"]
direction TB
graph_manager[Graph Manager]
namespaces[Namespaces]
triplestore_api[Triplestore API]
graph_manager --> namespaces & triplestore_api
end
%% Supporting Side Modules
allegrograph[(AllegroGraph
Triplestore)]
subgraph Ontology["Ontology Module"]
direction TB
ontology_cache[Ontology Cache]
wdo[WDO] & bfo[BFO] & dcterms[DCTERMS] --> ontology_cache
end
%% Define Connections for Symmetrical Layout
%% Main vertical spine
user --> Portal --> API --> Extraction --> Annotation --> KnowledgeGraph
%% Inputs from the left
repo -->|"Source code, docs, git"| Extraction
%% Supporting resources on the right
Annotation -->|"Links entities to ontology"| Ontology
KnowledgeGraph -->|"Ontology Lookups"| Ontology
triplestore_api <-->|"SPARQL Endpoint"| allegrograph
%% Feedback loop on the left. The <.-> syntax creates a dotted line automatically.
API <.->|"Queries & Manages KG"| KnowledgeGraph
%% Apply Styling
%% 1. Style external elements
class user,repo,allegrograph external;
%% 2. Style the INNER nodes
class upload,dashboard,search,graphviz frontend-inner;
class api_server,ext_main,ext_code,ext_doc,ext_git,ext_content,annotator,sim_calc,postproc,graph_manager,namespaces,triplestore_api backend-inner;
class ontology_cache,wdo,bfo,dcterms ontology-inner;
%% 3. Style the OUTER subgraph containers
class Portal frontend-container;
class API,Extraction,Annotation,KnowledgeGraph backend-container;
class Ontology ontology-container;
```
## License
This project is licensed under the terms of the [MIT License](LICENSE)