Final cleanup: Professional README, organized automation suite, and removal of temporary scripts

Author: Tcode-Motion

README.md

@@ -1,87 +1,108 @@
-# 🖥️ Computer Parts Map — Version 2.0 🚀
+# ⚡ Computer Parts Map (CPMap) — Version 2.0 🚀
 
-> The ultimate interactive, research-level web encyclopedia for computer hardware and software. Explore everything from nano-transistors to global servers.
+[![Live Site](https://img.shields.io/badge/Live-Encyclopedia-brightgreen?style=for-the-badge&logo=google-chrome)](https://tcode-motion.github.io/computer-part-map/)
+[![Version](https://img.shields.io/badge/Version-2.0%20Premium-blue?style=for-the-badge)](https://github.com/Tcode-Motion/computer-part-map)
+[![License](https://img.shields.io/badge/License-MIT-orange?style=for-the-badge)](LICENSE)
+[![Tech](https://img.shields.io/badge/Tech-Pure%20Web-red?style=for-the-badge)](https://developer.mozilla.org/en-US/docs/Web/HTML)
 
-[![GitHub Pages](https://img.shields.io/badge/Live%20Demo-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://tcode-motion.github.io/computer-part-map/)
-[![GitHub Repo](https://img.shields.io/badge/Source%20Code-GitHub-black?style=for-the-badge&logo=github)](https://github.com/Tcode-Motion/computer-part-map/)
-[![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge&logo=html5&logoColor=white)](https://developer.mozilla.org/en-US/docs/Web/HTML)
-[![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge&logo=css3&logoColor=white)](https://developer.mozilla.org/en-US/docs/Web/CSS)
-[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
+> **The world's most detailed interactive encyclopedia for computer hardware and software.**  
+> Designed for students, engineers, and researchers to bridge the gap between basic guides and academic papers.
 
 ---
 
-## 🌐 Live Access
+## 📖 Project Vision
 
-| Resource | URL |
-|---|---|
-| 🔴 **Live Website** | [https://tcode-motion.github.io/computer-part-map/](https://tcode-motion.github.io/computer-part-map/) |
-| 📁 **GitHub Repository** | [https://github.com/Tcode-Motion/computer-part-map/](https://github.com/Tcode-Motion/computer-part-map/) |
+**CPMap** is more than just a list of parts. It is a **Research-Grade Educational Platform**. While Version 1.0 focused on basic hardware definitions, **Version 2.0 (Premium)** transforms the site into a high-density knowledge base with automated media ingestion, academic referencing, and advanced computing sections.
+
+### 🔬 What's New in Version 2.0?
+*   **Academic Integration**: Every page features a "Research Hub" with direct query links to **Google Scholar** and **IEEE Xplore**.
+*   **Modern Paradigms**: Dedicated deep-dives into **NPU (AI)**, **Quantum Computing**, and **SBC (Raspberry Pi)** architecture.
+*   **Data Enrichment**: Expanded to **70+ total pages**, including 30+ detailed technical sub-pages.
+*   **Interactive Search**: Migrated from basic filters to a full-text inverted index search powered by **Lunr.js**.
+*   **Automation Suite**: Integrated Python tools to fetch public-domain media from NASA and Wikimedia automatically.
 
 ---
 
-## 📖 About the Project
+## ✨ Premium Features
+
+### 🧭 Advanced Navigation
+A **Mega-Dropdown Navbar** categorizes the entire computing landscape:
+*   **Hardware**: Core (CPU/GPU/NPU), Input (Webcam/Touchpad), and Output/Storage.
+*   **Software**: Comprehensive guides for Windows, Linux, macOS, Android, and iOS.
+*   **Computing**: Timeline of History, Server Infrastructure, and Future Tech.
 
-**Computer Parts Map** is an open-source educational library designed to bridge the gap between "basic hardware guides" and "complex engineering papers." It provides a structured, interactive journey through every layer of modern computing.
+### 🖼️ Automated Visual Galleries
+Every component page includes a high-resolution gallery of technical diagrams and real-world screenshots, sourced automatically from open libraries like **Wikimedia Commons** and **NASA**.
 
-### What makes Version 2.0 different?
-- **Research-Level Depth**: Every page features an academic "Deep Dive" section designed to help students and enthusiasts write their own research papers.
-- **Academic Integration**: Direct links to **Google Scholar** and **IEEE Xplore** for every component.
-- **Embedded Lectures**: Intelligent YouTube integration that surfaces CS university lectures relevant to each topic.
-- **Modern Hardware**: New dedicated guides for **NPUs (AI Processors)**, **Quantum Computing**, and **Raspberry Pi Architecture**.
+### 🎥 Embedded University Lectures
+Instead of broken video links, CPMap dynamically surfaces university-level CS lectures and engineering demonstrations directly related to the topic being studied.
+
+### 🌙 Premium UI/UX
+*   **Glassmorphism Navbar**: Sticky, blurred glass effect for modern aesthetics.
+*   **Stats Counter**: Animated counters on the homepage showing the library's growth.
+*   **Pure Dark Mode**: A custom-engineered dark theme optimized for long study sessions.
 
 ---
 
-## ✨ Features
+## 🗂️ Knowledge Architecture
 
-- 📚 **35+ Detailed Guides** — Comprehensive technical specs for hardware and software.
-- 🧭 **Premium Mega Navbar** — Reorganized category-based navigation (Core, Input, Output, Software, Computing).
-- 🔬 **Research Section** — Auto-generated academic resource hubs on every page.
-- 🌓 **Dynamic Dark Mode** — Persistent, modern dark-mode aesthetic.
-- ⚡ **Anime.js Animations** — Smooth transitions, statistics counters, and interactive loaders.
-- 🔍 **Global Search** — Real-time search engine to find any guide instantly.
-- 📱 **Mobile Optimized** — Fully responsive design for learning on the go.
+| Category | High-Level Topics | Research Sub-pages |
+|:---|:---|:---|
+| **Core Hardware** | CPU, GPU, NPU, RAM, Motherboard | Architecture, Benchmarks, Logic |
+| **Mobile & OS** | Android, iOS, Windows, Linux, macOS | Kernels, NT Architecture, Distros |
+| **Networking** | Router, NIC, WiFi-7, Server Infrastructure | Protocols, Signal Physics |
+| **Storage** | SSD, HDD, NVMe, Optical/Laser | Flash Physics, Laser Tech |
+| **Future Tech** | Quantum Computing, Neural Engines | Qubits, Tensor Math, SBCs |
 
 ---
 
-## 🔬 Research & Study Capability
+## 🛠️ Tech Stack & Automation
 
-This project is built to be more than just a list of parts. It is a **Research Springboard**. By studying the data-rich paragraphs, spec tables, and academic links provided on every page, anyone can:
-1.  Understand the underlying physics of transistors and qubits.
-2.  Analyze the architectural differences between Scalar, Vector, and Matrix processing.
-3.  Gather sources for independent academic engineering papers.
-4.  Watch university-level demonstrations directly within the interface.
+### Frontend
+*   **Core**: Semantic HTML5, Modular CSS3 (Custom Design System).
+*   **Logic**: Vanilla JavaScript (ES6+).
+*   **Search**: [Lunr.js](https://lunrjs.com/) for site-wide full-text indexing.
+*   **Animations**: [Anime.js](https://animejs.com/) for high-end UI feedback.
+
+### Automation (The Ingest Suite)
+Located in `/tools` and `/scripts`, these Python tools maintain the library's depth:
+*   `cpmap_ingest.py`: Idempotent asset downloader (NASA/YouTube).
+*   `build_search_index.py`: Rebuilds the Lunr index across all 70+ pages.
+*   `generate_detail_pages.py`: Uses Jinja2 templates to create technical sub-pages from JSON datasets.
 
 ---
 
-## 🗂️ Knowledge Architecture
+## 🚀 Deployment & Local Setup
 
-| Category | Topics |
-|---|---|
-| ⚙️ **Core Hardware** | CPU, GPU, **NPU (AI)**, RAM, Motherboard, PSU, Cooling |
-| ⌨️ **Input Devices** | Keyboard, Mouse, Webcam, Microphone, Touchpad, Scanner |
-| 🖥️ **Output & Storage** | Monitor, Printer, Projector, SSD, HDD, Optical Drives |
-| 💻 **Software & OS** | Windows, Linux, macOS, OS Architecture, Software Types |
-| ⚛️ **Modern Computing** | **Quantum Computing**, **Raspberry Pi**, Servers, Networking |
+### 1. Hard Refresh (Live Site)
+If you are visiting the [Live Site](https://tcode-motion.github.io/computer-part-map/) and see old content, please perform a **Hard Refresh**:
+*   **Windows**: `Ctrl + F5`
+*   **Mac**: `Cmd + Shift + R`
 
----
+### 2. Local Development
+```bash
+# Clone the repo
+git clone https://github.com/Tcode-Motion/computer-part-map.git
 
-## 🛠️ Tech Stack
+# Install Ingest Tools dependencies
+pip install -r tools/requirements.txt
 
-- **Pure HTML5 & CSS3**: Custom design system without heavy frameworks.
-- **Vanilla JavaScript**: Modular layout injection and dynamic section generation.
-- **Anime.js**: Powering the high-end UI animations and stat-counters.
-- **Academic APIs**: Dynamic linking to scholarly databases.
+# Run local server
+python -m http.server 8000
+```
 
 ---
 
 ## 👨‍💻 Developed By
 
-**Tcode Motion**
-- GitHub: [@Tcode-Motion](https://github.com/Tcode-Motion)
-- Website: [Made by Tcode Motion](https://tcode-motion.github.io/computer-part-map/)
+**Tcode Motion**  
+*Building the future of open-source computer education.*
+
+*   **GitHub**: [@Tcode-Motion](https://github.com/Tcode-Motion)
+*   **Live Library**: [Computer Parts Map](https://tcode-motion.github.io/computer-part-map/)
 
 ---
 
 <div align="center">
-  <sub>Built for students, engineers, and the curious. Open-source under the MIT mindset.</sub>
+  <sub>CPMap is an Open Source project. "Truth through Data." — Made by Tcode Motion.</sub>
 </div>