# Sustainability Page Implementation Notes

This document summarizes the architecture, design choices, database layout, administrative panels, and automated tests implemented for the public-facing **Sustainability Page** at `/sustainability`.

---

## 1. Factual & Measured Positioning

To protect the integrity of the **Kevron Suites and Apartments** brand and strictly avoid greenwashing or deceptive eco-claims:
- **Factual Status Tracking**: Current active sustainability metrics (like LED lighting and energy-conscious inverter split units/appliances) are verified with procurement invoices and manufacturer specs.
- **Clear Future Roadmaps**: Upcoming or under-review initiatives (such as hybrid solar backup grids, dual-flush aerators, and organized recycling separations) are explicitly badge-labeled as `PLANNED` and assigned target operational timeframes.
- **Measured Wording**: Avoided absolute claims like "100% carbon neutral", "zero-waste facility", or "fully sustainable". Applied measured qualifiers including "where available", "where installed", and "subject to management adoption".

---

## 2. Relational Database Schema

New database structures were successfully migrated:
- **`sustainability_categories`**: Mapped categories (Energy Efficiency, Responsible Utility Use, Modern Appliances, Guest Guidance, Future Plans) with name, slug, and vector icon markers.
- **`sustainability_features`**: Houses current active features with category mappings, benefits, claim levels (`factual`, `requires_evidence`), and verification specs.
- **`guest_sustainability_guidance`**: Actionable switch-off tips (lights, split air conditioners, secure tap closures) and leak reporting instructions.
- **`future_sustainability_plans`**: Tracks timeframed future targets with planned badge statuses.
- **`sustainability_evidence`**: Holds administrative logs of specification sheets or supplier invoices supporting active ecological claims.
- **`sustainability_media`**: Relates en-suite pictures to feature blocks.

---

## 3. High-Fidelity Design and Brand Compliance

The frontend conforms strictly to all design tokens defined by the Kevron Suites brand guidelines:
- **Typography Sizing Caps**: Heading layouts strictly utilize the luxury `Marcellus` font family, capped under `1.8rem` for H1 and lower than `1.625rem` (clamped to `1.5rem`) for secondary headings. Body/UI copy utilizes `Inter` and is capped at `0.875rem`.
- **Button Contours**: Standardized `50px` border-radius contours on all button elements with translateY animations and 3D progressive drop-shadow parameters.
- **Luxury Cards**: Option cards, landmark panels, and accordion FAQ blocks utilize `0.1rem` border-radius boundaries with a subtle `box-shadow` offset and ice-blue color deepening on hover.
- **Safety Area clear Notch overlay**: Employs `env(safe-area-inset-bottom)` within the bottom sticky mobile CTA bar to perfectly clear OS gestures on edge-to-edge screens.

---

## 4. Administrative Panels (Filament CRUD Resources)

Registered CRUD managers inside the `/admin` dashboard panel:
1. **Sustainability Category Manager**: CRUD for organizing active topics.
2. **Sustainability Feature Manager**: Controls feature descriptions, benefits, and evidence notes.
3. **Guest Sustainability Guidance Manager**: Configures switch-off guidelines and checklists.
4. **Future Sustainability Plan Manager**: Configures target roadmap timeframes and planned items.
5. **Sustainability Media Manager**: pivot controller for en-suite media assets.
6. **Sustainability Evidence Manager**: CRUD manager for logging specifications or manufacturer supplier invoices.

---

## 5. Automated Feature Tests

Implemented a comprehensive feature test inside `tests/Feature/SustainabilityPageTest.php`, asserting:
- Page loads successfully (200 status).
- Global headers and footers are preserved.
- Active features (LED lighting, energy-conscious appliances) are visible.
- Guest conservation guidelines and future plans are rendered with `PLANNED` badge indicators.
- Dynamic FAQs categories and accordions load.
- SEO canonical URL tags and polymorphic schema JSON-LD scripts are verified.