📑 3D Curve Weaving System — File Index

Navigazione rapida di tutti i file del sistema.

🎯 Quick Navigation

📂 Struttura Directory

plana93.github.io/
│
├── _sass/
│   └── _custom.scss ⭐ MODIFICATO
│       ├── Layer L0-L3 classes (linee 949-1115)
│       ├── Utility classes (linee 1117-1169)
│       └── Dark mode overrides (linee 1171-1193)
│
├── assets/
│   └── js/
│       └── curve-3d-weaving.js ⭐ NUOVO
│           ├── NegativeSpaceAnalyzer class
│           ├── OcclusionRenderer class
│           └── HoverEnhancer class
│
├── _includes/
│   └── curve-3d-example.html ⭐ NUOVO
│       └── Template completo 4 layer SVG
│
├── CURVE_3D_README.md ⭐ NUOVO
│   ├── Overview sistema
│   ├── Quick start
│   ├── Personalizzazione
│   └── Troubleshooting
│
├── CURVE_3D_WEAVING_SPEC.md ⭐ NUOVO
│   ├── Architettura layer
│   ├── Tecniche profondità 3D
│   ├── Clipping strategy
│   ├── Dark mode adaptation
│   └── Implementation checklist
│
├── CURVE_3D_VISUAL_GUIDE.md ⭐ NUOVO
│   ├── Diagrammi ASCII layer stack
│   ├── Tabelle comparazione proprietà
│   ├── Mappe clipping zones
│   ├── Gradient progression
│   └── Debug commands
│
├── CURVE_3D_TEST_MATRIX.md ⭐ NUOVO
│   ├── 18 categorie test
│   ├── 50+ test individuali
│   ├── Comandi console
│   └── Scoring system
│
├── CURVE_3D_CHANGELOG.md ⭐ NUOVO
│   ├── Version 2.0 changes
│   ├── Roadmap future
│   └── Contributing guidelines
│
├── CURVE_3D_SUMMARY.md ⭐ NUOVO
│   ├── Panoramica progetto
│   ├── Obiettivi raggiunti
│   ├── Metriche tecniche
│   └── Next steps
│
└── CURVE_3D_INDEX.md (questo file) ⭐ NUOVO
    └── Navigazione rapida file system

🎓 Percorso di Apprendimento Consigliato

1️⃣ Newbie (Mai visto il sistema)

CURVE_3D_README.md
    ↓
CURVE_3D_VISUAL_GUIDE.md (sezione "Layer Visual Hierarchy")
    ↓
_includes/curve-3d-example.html (guarda il codice)

2️⃣ Developer (Vuoi implementare)

CURVE_3D_README.md (Quick Start)
    ↓
_includes/curve-3d-example.html (copia template)
    ↓
_sass/_custom.scss (vedi classi disponibili)
    ↓
CURVE_3D_TEST_MATRIX.md (verifica funzionamento)

3️⃣ Advanced (Vuoi personalizzare)

CURVE_3D_WEAVING_SPEC.md (studia architettura)
    ↓
_sass/_custom.scss (modifica parametri layer)
    ↓
assets/js/curve-3d-weaving.js (abilita occlusione dinamica)
    ↓
CURVE_3D_VISUAL_GUIDE.md (reference rapido)

4️⃣ QA Tester (Vuoi testare)

CURVE_3D_TEST_MATRIX.md (esegui checklist completa)
    ↓
CURVE_3D_VISUAL_GUIDE.md (debug commands)
    ↓
CURVE_3D_CHANGELOG.md (verifica version features)

5️⃣ Architect (Vuoi estendere il sistema)

CURVE_3D_WEAVING_SPEC.md (comprendi tutto)
    ↓
CURVE_3D_CHANGELOG.md (roadmap future)
    ↓
_sass/_custom.scss + assets/js/*.js (codebase completa)

🔍 Quick Search Guide

Cerchi…

Come funziona il clipping?

→ CURVE_3D_WEAVING_SPEC.md — Sezione “Clipping Strategy”

Quali sono i parametri di ogni layer?

→ CURVE_3D_VISUAL_GUIDE.md — Tabella “Layer Properties Comparison”

Come faccio il test?

→ CURVE_3D_TEST_MATRIX.md — Inizio file

Come lo implemento nel mio sito?

→ CURVE_3D_README.md — Sezione “Quick Start”

Perché i colori sono così?

→ CURVE_3D_WEAVING_SPEC.md — Sezione “Color Palette”

Come cambio il percorso della curva?

→ CURVE_3D_README.md — Sezione “Personalizzazione”

Cosa fa il JavaScript?

→ CURVE_3D_WEAVING_SPEC.md — Sezione “Advanced Technique: Occlusione Dinamica”
→ assets/js/curve-3d-weaving.js — Codice commentato

Quali utility classes esistono?

→ CURVE_3D_README.md — Sezione “Utility Classes”
→ _sass/_custom.scss — Linee 1117-1169

Come funziona dark mode?

→ CURVE_3D_WEAVING_SPEC.md — Sezione “Dark Mode Adaptation”

Quali animazioni ci sono?

→ CURVE_3D_VISUAL_GUIDE.md — Sezione “Hover State Changes”
→ _sass/_custom.scss — Keyframes mp-curve-breathe, mp-curve-draw

📊 Statistiche File System

🏆 File Priorità

Se hai poco tempo, leggi SOLO questi 3 file:

1. CURVE_3D_README.md — Overview + Quick Start (5 min)
2. CURVE_3D_VISUAL_GUIDE.md — Diagrammi rapidi (3 min)
3. _includes/curve-3d-example.html — Copia/incolla codice (2 min)

Totale: 10 minuti per implementare il sistema base.

🔗 Link Esterni Utili

• SVG Path Reference: https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d
• CSS Filters: https://developer.mozilla.org/en-US/docs/Web/CSS/filter
• Clip-path Generator: https://bennettfeely.com/clippy/
• Cubic Bezier Tool: https://cubic-bezier.com/

📞 Support

Se hai domande sul sistema:

1. Controlla CURVE_3D_README.md — Sezione “Troubleshooting”
2. Esegui test in CURVE_3D_TEST_MATRIX.md — identifica problema
3. Consulta CURVE_3D_WEAVING_SPEC.md — approfondisci tecnica
4. Verifica CURVE_3D_CHANGELOG.md — potrebbe essere un known issue

🎨 Esempi Visivi (Future)

Potenziale aggiunta futura:

• CURVE_3D_GALLERY.md — Screenshots di implementazioni
• CURVE_3D_VIDEO_DEMO.mp4 — Screencast funzionamento
• CURVE_3D_PLAYGROUND.html — Editor interattivo parametri

📝 Maintenance

Quando modifichi il sistema:

1. Aggiorna _custom.scss → Stili
2. Aggiorna curve-3d-weaving.js (se cambi JS) → Logica
3. Aggiorna CURVE_3D_CHANGELOG.md → Versioning
4. Aggiorna CURVE_3D_WEAVING_SPEC.md (se architettura cambia) → Doc tecnica
5. Esegui CURVE_3D_TEST_MATRIX.md → QA
6. Commit con messaggio dettagliato → Git history

🗂️ File Tags (per ricerca)

CURVE_3D_README.md:
  tags: [overview, quick-start, beginner, setup]

CURVE_3D_WEAVING_SPEC.md:
  tags: [technical, architecture, deep-dive, reference]

CURVE_3D_VISUAL_GUIDE.md:
  tags: [visual, diagrams, quick-reference, tables]

CURVE_3D_TEST_MATRIX.md:
  tags: [testing, qa, validation, checklist]

CURVE_3D_CHANGELOG.md:
  tags: [versioning, history, roadmap, releases]

CURVE_3D_SUMMARY.md:
  tags: [overview, implementation, metrics, summary]

_sass/_custom.scss:
  tags: [css, styles, layer-system, animations]

assets/js/curve-3d-weaving.js:
  tags: [javascript, dynamic-occlusion, parallax, canvas]

_includes/curve-3d-example.html:
  tags: [html, template, svg, implementation]

CURVE_3D_INDEX.md:
  tags: [navigation, index, directory, structure]

🎯 Target Audience per File

Last Updated: 2026-04-18
Total Files: 10 (questo file incluso)
System Version: 2.0.0