Goondex/docs/HISTORY.md

77 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

File: docs/HISTORY.md
Version: v0.3.4
Last updated: November 2025
Maintainer: Leak Technologies
Project: Goondex
------------------------------------------------------------
📖 Goondex — Project History
------------------------------------------------------------
### Overview
Goondex is the modern evolution of the former **Porndex Importer**, a Python-based gallery indexing and tagging system originally focused on PornPics.com.
Between 2024 and 2025, the project underwent a complete rebuild to address technical debt, unify its codebase, and formalize documentation standards under the Leak Technologies ecosystem.
This file provides a concise historical overview of that transition, outlining the legacy systems, lessons learned, and the motivations behind the current Goondex architecture.
------------------------------------------------------------
🕰️ 2024 — Origins: PornPics Importer
------------------------------------------------------------
The earliest version of the system, built throughout 2024, began as a lightweight tool for automatically downloading and organizing PornPics galleries.
It featured:
- Threaded image fetching with metadata export to `metadata.json`.
- Simple folder-based organization by model and network.
- Prototype keyword-based tagging based solely on gallery titles.
While functional, it lacked flexibility, configuration, and reliable error recovery.
This groundwork eventually became the foundation for Porndex.
------------------------------------------------------------
⚙️ 20242025 — Porndex Importer Era
------------------------------------------------------------
The project expanded rapidly under the name **Porndex**, introducing YAML-based tag dictionaries and the first CLI-driven workflows.
Porndex introduced:
- Early modular tagging using keyword dictionaries.
- Performer metadata enrichment through ThePornDB API.
- SQLite-backed performer database for indexing and updates.
- Validation commands for tag consistency and statistics reporting.
By mid-2025, the system had grown in complexity and scope, but the architecture was increasingly brittle.
The need for a modular, self-contained, and shell-friendly design became clear — leading to the creation of **Goondex**.
------------------------------------------------------------
🚀 Late 2025 — The Goondex Rebuild
------------------------------------------------------------
In October 2025, the codebase was completely restructured and relaunched as **Goondex**.
This marked the transition from an experimental importer to a formalized, maintainable platform.
Key advancements introduced in the Goondex rebuild:
- **Unified CLI:** A single entrypoint (`goondex`) for all operations.
- **YAML Tagging Framework:** Refined dictionaries for acts, clothing, and body descriptors.
- **Improved Error Handling:** Safe path operations and better exception tracing.
- **Cross-Shell Compatibility:** Alias scripts for Fish, Bash, and Zsh environments.
- **Documentation Suite:** Full set of Markdown docs — `ARCHITECTURE.md`, `TAGGING.md`, `GALLERIES.md`, `ROADMAP.md`, and `BRANDING.md`.
The rebuild also focused on subtlety and modular design — retaining the underlying functionality of the PornPics importer while shedding the “Porndex” branding in favor of a more neutral, system-oriented identity.
------------------------------------------------------------
🧭 Present — Goondex v0.3.x Development Line
------------------------------------------------------------
The v0.3.x cycle focuses on:
- Robust tagging accuracy and metadata stability.
- Clean CLI interface and cross-environment consistency.
- Proper documentation, logging, and version traceability.
- Preparing the foundation for future ML-assisted tagging modules.
As of **v0.3.4 (November 2025)**, Goondex features a fully functional tagging system, stable CLI aliasing, and a clearly documented repository structure.
------------------------------------------------------------
🧩 Legacy Acknowledgement
------------------------------------------------------------
Goondex owes its foundation to the original Porndex Importer developed in 20242025.
While the old tagging and enrichment systems are no longer active, their core ideas continue to influence Goondexs modern design philosophy — emphasizing modularity, transparency, and resilience.
------------------------------------------------------------
© 2025 Leak Technologies — Goondex Project
------------------------------------------------------------