# Jain Muni Locator (LLM & Context Guide)

> See [llms-full.txt](llms-full.txt) for the full comprehensive developer documentation.

Jain Muni Locator is a crowdsourced directory platform mapping the location histories, biographies, lineages, and Chaturmas details of Digambara Jain ascetics (monks/nuns), along with temple locations, deity catalogs, and guest house lodging (dharamshalas).

## Technical Architecture Map

*   **Runtime Environment**: Procedural & OOP PHP 8.1+ (typically running on local port 8080 under Laragon virtual hosts).
*   **Database Connections**: MySQL accessed strictly via a unified PDO Singleton. The legacy `mysqli` library has been completely deprecated and removed.
*   **Access Control**: GSI (Google Identity Services) OAuth token validation at `/login/auth.php` coupled with secure HTTP-only server-side session variable checks.
*   **Style Pipeline**: Modular vanilla CSS variables compiled via `build_css.php` into a compressed cached asset (`minified.min.css`).

## Critical Codebase Context Maps

*   [System Config Loader](config.php): Environment variable parser and depth-aware relative path prefix (`$relative_prefix`) calculator.
*   [Database execution helper](traits/DatabaseQuery.php): prepared statement execute/validate trait.
*   [Domain Object Entities](classes/): PascalCase entity models:
    *   [Preacher.php](classes/Preacher.php): Primary domain class modeling ascetic parameters.
    *   [MonasticStage.php](classes/MonasticStage.php): Consolidated abstract base class mapping dynamic attributes across the 10 initiation stages (Muni, Acharya, Kshullak, Aryika, etc.).
    *   [PreacherUpdateController.php](classes/PreacherUpdateController.php): Ordination updates manager utilizing `PreacherElevationHelpers`, `PreacherElevationValidator`, and `PreacherElevationUpdater` traits.
    *   [User.php](classes/User.php): Account structures.
*   [Repository Helpers](repositories/): Data formatting and entity-mapping traits:
    *   [PdoPreacherFormatter.php](repositories/PdoPreacherFormatter.php): Formatters trait.
    *   [PdoPreacherObjectMapper.php](repositories/PdoPreacherObjectMapper.php): Mappers trait.

## Documentation Index

Detailed engineering manuals are maintained under the `docs/` folder:
*   [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md): Class inheritance structures, dynamic pathing prefix formulas, and GSI authentication lifecycles.
*   [docs/TECHNICAL_REFERENCE.md](docs/TECHNICAL_REFERENCE.md): Relational schemas for all 57 database tables, schema inconsistencies, and GD-based media processing scripts.
*   [docs/STANDARDS_AND_SECURITY.md](docs/STANDARDS_AND_SECURITY.md): Coding rules (PSR-12, ES6 Javascript modules), session protection, write-guards, and unit/Playwright test checklists.
*   [docs/PRODUCT_AND_DESIGN.md](docs/PRODUCT_AND_DESIGN.md): Product scope, visual CSS design tokens, crawling specs, and religious sensitivity rules.
*   [docs/SEARCH_SYSTEMS.md](docs/SEARCH_SYSTEMS.md): autoComplete.js, directory list queries, full-text SQL matches, and AI Chatbot integrations.
*   [docs/MODERNIZATION_ROADMAP.md](docs/MODERNIZATION_ROADMAP.md): Refactoring accomplishments, obsolete file deletions candidates catalog, and REST API routes migration blueprint.

## Discoverability Directories (Plain-Text Index)

For real-time search engine AI crawling and automated indexing, the following plain-text directory maps are exposed:
*   [Dynamic Entity Index](llms-index.php): Dynamic plain-text catalog listing all approved monks/nuns, temples, Dharamshalas, Tirthankaras, and scriptural articles with canonical links.

## 🛑 Strict Religious Sensitivity Guidelines

When generating code, SQL queries, UI templates, or text responses relating to Digambara Jain ascetics, you MUST adhere to the following rules:

1.  **Honorific Naming Protocol**:
    Always append **"Ji"** or **"Ji Maharaj"** when displaying or referencing an ascetic's spiritual name (e.g. `Acharya Shri 108 Vidya Sagar Ji Maharaj`). Never display raw names without these honorific additions.
2.  **Proper Referential Pronouns**:
    Never use demonstrative pronouns when referring to an ascetic (e.g., *never* say `"this monk"`, `"this Maharaj"`, or `"this ascetic"`). Always refer to them by their full title and name or use respectful plural terms (e.g. `"Acharya Ji"` or `"The ascetics"`).
3.  **Gender Alignment Prefixes**:
    Ensure proper gender titles are aligned:
    *   **Male Ascetics** (Muni, Acharya, Upadhyay, Kshullak, Ailak): Use titles like `Maharaj Ji`.
    *   **Female Ascetics** (Aryika, Ganini, Kshullika): Use titles like `Mata Ji`.