feat(ui): implement premium gamified Concepts Map dashboard, unify design tokens, and enforce scoped CSS (#54)

Resolves #55

# gamified Concepts Map Dashboard, Architecture Cleanup, & CSS Unification

This Pull Request completes the gamified **Concepts Map** interactive experience and executes a strict visual and architectural clean-up of the **NexusReader SaaS** platform by consolidating styling around the centralized **Nexus Neon** design system, enforcing Native AOT-compliant scoped-CSS, and resolving style drift.

---

### 🚀 Key Implementations

#### 1. Gamified Interactive Concepts Map Dashboard
* **Dynamic Skill-Tree Visualizer:** Implemented a gamified node-based interactive tree that reads concept connections dynamically, rendering progress nodes, unlocked/locked states, and active visual connection lines.
* **Premium UX Details:** Integrated high-fidelity hover effects, detailed sidebar popovers showing unlocked stats/summaries, and smooth parallax backdrops.
* **Secure Multi-Tenant Gating:** Hardened data queries using explicit `TenantId` gating to ensure complete layout isolation between system tenants.

#### 2. Architecture & Service Optimization
* **Service Abstraction (`IConceptsMapService`):** Introduced a clean service interface decoupled from the UI layers.
* **Polyglot Fallback Implementations:**
  - **WasmConceptsMapService:** Implements efficient client-side fetching with error recovery/loading states.
  - **ServerConceptsMapService:** Handles deep database graph mapping, relationship resolution, and multi-tenant checks.
* **CQRS Integrity:** Enforced the CQRS Result Pattern by using `MediatR` handlers to fetch data structures instead of placing database queries in UI modules.

#### 3. Nexus Neon CSS Unification & Zero-Style-Tag Standards
* **Central Design Tokens:** Solidified typography (`Inter` / `Merriweather`), primary brand green hues (`var(--nexus-neon)` at `#00ff99`), and glow variables inside the global `app.css`.
* **Zero Inline Style Tags:** Standardized all dashboard modules by completely eliminating inline `<style>` blocks in favor of scoped `.razor.css` companion files.
* **Consolidated Buttons & Glass Panels:**
  - Standardized `.btn-nexus`, `.btn-nexus-primary`, and `.btn-nexus-secondary` throughout header/footer/card operations.
  - Removed duplicate `.glass-panel` background, blur, and support-declaration overrides, making components cleanly inherit standard global styles.
* **Eliminated Brand Splitting:** Resolved legacy purple-indigo user avatar and conversation bubble gradients inside the AI Intelligence Hub (`Intelligence.razor.css`), migrating them to premium glassmorphic surfaces (`rgba(255, 255, 255, 0.05)`) contrasting beautifully against the emerald green AI theme.

---

### 🧪 Verification & Build Gate Status

* **Successful Compilation Check:** Run `dotnet build NexusReader.slnx --no-restore` from the workspace root. Flawlessly succeeded with **zero compilation errors** (`Liczba błędów: 0`) under target `.NET 10`.
* **Verified Skills Synchrony:** The companion design guidelines skill (`nexus-ui-engine/SKILL.md`) has been fully updated to secure these layout and styling conventions for future dashboard features.

---------

Co-authored-by: Marek Jasiński <jasins.marek@gmail.com>
Reviewed-on: #54
Co-authored-by: Antigravity <antigravity@google.com>
Co-committed-by: Antigravity <antigravity@google.com>
This commit was merged in pull request #54.
This commit is contained in:
2026-05-26 17:46:56 +00:00
committed by Marek Jaisński
parent a0bf6c15f4
commit 72905aa119
34 changed files with 2560 additions and 1173 deletions
@@ -0,0 +1,235 @@
.concepts-map {
width: 100%;
max-height: 72vh;
overflow-y: auto;
padding: 1.5rem;
box-sizing: border-box;
}
/* Scrollbar Customization for modern aesthetic */
.concepts-map::-webkit-scrollbar {
width: 6px;
}
.concepts-map::-webkit-scrollbar-track {
background: rgba(255, 255, 255, 0.02);
}
.concepts-map::-webkit-scrollbar-thumb {
background: rgba(255, 255, 255, 0.1);
border-radius: 3px;
}
.concepts-map::-webkit-scrollbar-thumb:hover {
background: var(--nexus-neon);
}
.empty-map-state {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
padding: 3rem;
background: rgba(255, 255, 255, 0.02);
border: 1px dashed rgba(255, 255, 255, 0.08);
border-radius: 12px;
color: rgba(255, 255, 255, 0.4);
text-align: center;
}
.empty-map-state .dim-icon {
margin-bottom: 1rem;
color: rgba(255, 255, 255, 0.2);
}
.timeline-container {
display: flex;
flex-direction: column;
gap: 0;
position: relative;
padding-left: 0.5rem;
}
.timeline-step {
display: flex;
flex-direction: row;
gap: 1.5rem;
padding: 1rem;
border-radius: 12px;
border: 1px solid transparent;
cursor: pointer;
transition: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
margin-bottom: 0.5rem;
}
.timeline-step:hover {
background: rgba(255, 255, 255, 0.02);
transform: translateX(4px);
}
.timeline-step.unlocked:hover {
border-color: rgba(0, 255, 153, 0.15);
box-shadow: 0 4px 20px rgba(0, 255, 153, 0.05);
}
.timeline-step.selected {
background: rgba(0, 255, 153, 0.04);
border-color: var(--nexus-neon);
box-shadow: 0 0 15px var(--nexus-primary-glow);
}
.node-connector-wrapper {
display: flex;
flex-direction: column;
align-items: center;
width: 32px;
position: relative;
flex-shrink: 0;
}
.node-circle {
width: 32px;
height: 32px;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
position: relative;
z-index: 2;
transition: all 0.3s ease;
background: #0d0d0d;
}
.unlocked .node-circle {
border: 2px solid var(--nexus-neon);
color: var(--nexus-neon);
box-shadow: 0 0 10px var(--nexus-primary-glow);
}
.locked .node-circle {
border: 2px solid rgba(255, 255, 255, 0.1);
color: rgba(255, 255, 255, 0.2);
}
.node-glow {
position: absolute;
width: 100%;
height: 100%;
border-radius: 50%;
background: var(--nexus-neon);
opacity: 0.15;
filter: blur(4px);
z-index: -1;
animation: pulse-glow 2s infinite ease-in-out;
}
@keyframes pulse-glow {
0% { transform: scale(1); opacity: 0.15; }
50% { transform: scale(1.25); opacity: 0.3; }
100% { transform: scale(1); opacity: 0.15; }
}
.vertical-track {
width: 2px;
position: absolute;
top: 32px;
bottom: -18px; /* Extends to link to next node circle */
z-index: 1;
transition: all 0.3s ease;
}
.track-active {
background: linear-gradient(180deg, var(--nexus-neon), rgba(0, 255, 153, 0.2));
box-shadow: 0 0 6px var(--nexus-primary-glow);
}
.track-inactive {
background: rgba(255, 255, 255, 0.08);
}
.node-content {
flex-grow: 1;
background: rgba(255, 255, 255, 0.02);
border: 1px solid rgba(255, 255, 255, 0.04);
border-radius: 8px;
padding: 1rem;
display: flex;
flex-direction: column;
gap: 0.5rem;
transition: all 0.3s ease;
backdrop-filter: blur(4px);
}
.timeline-step.selected .node-content {
background: rgba(255, 255, 255, 0.03);
border-color: rgba(0, 255, 153, 0.2);
}
.node-header {
display: flex;
justify-content: space-between;
align-items: center;
}
.segment-tag {
font-family: 'Outfit', sans-serif;
font-size: 0.75rem;
font-weight: 600;
letter-spacing: 0.05em;
color: rgba(255, 255, 255, 0.4);
}
.unlocked .segment-tag {
color: var(--nexus-neon);
}
.badge {
font-size: 0.7rem;
padding: 0.2rem 0.5rem;
border-radius: 12px;
font-weight: 500;
}
.badge-unlocked {
background: rgba(0, 255, 153, 0.08);
color: var(--nexus-neon);
border: 1px solid rgba(0, 255, 153, 0.2);
}
.badge-locked {
background: rgba(255, 255, 255, 0.05);
color: rgba(255, 255, 255, 0.3);
border: 1px solid rgba(255, 255, 255, 0.03);
}
.node-title {
margin: 0;
font-size: 0.95rem;
font-weight: 600;
color: #fff;
transition: color 0.2s ease;
}
.timeline-step.unlocked:hover .node-title {
color: var(--nexus-neon);
}
.locked .node-title {
color: rgba(255, 255, 255, 0.4);
}
.node-desc {
margin: 0;
font-size: 0.8rem;
line-height: 1.4;
color: rgba(255, 255, 255, 0.5);
}
.locked .node-desc {
color: rgba(255, 255, 255, 0.3);
}
.check-icon {
color: var(--nexus-neon);
}
.lock-icon {
color: rgba(255, 255, 255, 0.2);
}