# EpicNabbo Catalogue v2 (Development 🛠️)

EpicNabbo Catalogue v2 is a heavily optimized evolution of our catalog system, specifically engineered for **Nitro v3** with 100% native support.

> 🔴 **CRITICAL WARNING: DEVELOPMENT ONLY**
> **DO NOT USE THIS IN A PRODUCTION ENVIRONMENT.** This system currently contains severe bugs that **can wipe your entire database**. It is strictly intended for local development and testing purposes only.

---

## 🚀 Key Improvements & Objectives

* **Massive 52k+ Furni Database:** An increase of over 21,000 items compared to the internal v1 prototype, optimized for high-performance indexing.
* **Native Nitro v3 Support:** Tailored to support all modern Nitro UI elements and packet structures.
* **High Quality Standards:** Re-engineered framework to eliminate the performance bottlenecks found during internal testing of the previous unreleased version.
* **100% Verified Layout:** Merging development data into a superior base ensures zero missing pages or broken assets.

---

## 📈 Version Compression & Comparison

| Feature | Version 1 (Internal Build) | Version 2 (New Overhaul) |
| :--- | :--- | :--- |
| **Status** | Unreleased / Discontinued | **Active Development** 🛠️ |
| **Public Availability** | Never Released (Internal Prototype) | **Dev Preview (Open Source)** |
| **Production Ready** | No | ❌ **ABSOLUTELY NOT (Wipe Risk)** |
| **Catalog Size** | ~31,000 Items (Projected) | **52,000+ Items (Massive Expansion)** 📦 |
| **Nitro v3 Support**| Partial / Experimental | **100% Full Native Support** |
| **Stability Level** | Poor / Flawed Queries | **Critical Bugs (High Risk Layout)** |
| **Query Performance** | Slow Loading Speed | **Blazing Fast Optimized Indexing** |
| **Layout Integrity** | Missing pages & broken links | **100% Complete Verified Structure** |
| **Development Cost** | Free (Internal Time) | **100% Free Community Project** ❤️ |
| **ETA** | — | **No ETA (Under Construction)** |

---

## 🐛 Bug Reporting & Current State

Please be aware that this framework currently has an **enormous amount of bugs**. We are committed to tracking down and resolving every single issue, but this process will take a significant amount of time. 

**Our Commitment & Rules:**
* **100% Quality:** We are working hard to ensure that absolutely everything will function **100% flawlessly** in the end. We won't stop until it's perfect.
* **100% Free:** This entire project is developed completely for free. We are putting in as much effort as we can for the community.
* **No ETA & No Nagging:** Because of the massive workload and the fact that we do this for free, it will take a long time. There is no ETA. Please do not nag or complain about progress—be respectful of our time.
* **Bug Reports:** If you find something broken, you may report it, but keep reports to a minimum for now. Expect many features to be broken or incomplete during this phase.

---

## ✨ Planned Nitro v3 Features

Once the stability phase is complete, this catalog will fully support:
* **Advanced Catalog Page Layouts:** Native rendering of all specialized Nitro UI tabs and styles.
* **Dynamic Search & Caching:** Fast indexing to handle the 52k+ items without delaying packet responses.
* **Front-end JSON Hooks:** Ready-to-go configurations for your Nitro client assets.

---

💬 Frequently Asked Questions (FAQ)
Q: Can I get a sneak peek or test it on my live hotel?

A: Absolutely not. As stated above, it contains critical database-wiping bugs. Testing should only be done on an isolated local development environment.

Q: Can I help with development or fixing bugs?

A: If you are an experienced developer who understands Nitro v3 packet structures and advanced SQL indexing, feel free to submit a Merge Request.

Q: When will it be finished?

A: There is no ETA. We work on this for free in our spare time. It will be finished when it's perfect.

🤝 Contributing
We welcome contributions from the community, provided they meet our standards:

Fork the repository.

Create a clean branch for your bugfix (bugfix/resolve-wipe-issue).

Test your SQL queries thoroughly on MySQL 8.0+ / MariaDB 10.5+.

Open a Merge Request with a detailed explanation of what your code fixes.

🛠️ Development Roadmap
[x] Analyze v1 bottlenecks and establish superior base framework.

[x] Merge v1 catalog data into the new clean database structure.

[/] Expand and index database to 52,000+ items (In Progress).

[ ] Critical Fix: Resolve database-wipe vulnerability.

[ ] Systematic bug hunting and framework stability overhaul (Long-term).

[ ] Final QA testing and structural integrity verification.

⚖️ Legal Disclaimer
This is an open-source development preview provided "as-is" without any warranty of any kind. By downloading and importing these files, you assume full responsibility for any data loss, database corruption, or system instability. We are not liable for any damages caused by improper implementation or unpatched development bugs.