# House Rules Page & Enforcement System — Implementation Notes

This document provides details on the architectural design, database structures, security protocols, and compliance frameworks implemented for the Kevron Suites and Apartments **House Rules Page and Enforcement System**.

---

## 1. System Goals & Governance
* **URL Endpoints**: `/house-rules`
* **Redirects**: `/rules`, `/guest-rules`, `/policies/house-rules` redirect permanently (301) to `/house-rules`.
* **Dynamic Governance**: The frontend is fully database-driven, pulling data from the `house_rules_policies` schema. Active settings like standard check-in/out times, quiet hours, and occupancy caps are managed in admin-controlled tables to avoid static, hardcoded values.
* **Wording Disclaimers**: Rules contents are drafted to represent "starter safe clauses" pending final legal advisor and corporate review before publication.

---

## 2. Relational Database Schema Mapping
We created 14 tables via the `2026_06_01_280000_create_house_rules_tables.php` migration:
1. `house_rules_policies`: Policy version headers (status: `draft`, `internal_review`, `legal_review`, `approved`, `published`, `archived`).
2. `house_rule_categories`: Categories for sorting rule cards (e.g. Guest Conduct, Noise, Smoking/Pets, Smart Access).
3. `house_rule_sections`: Modular HTML rule clauses.
4. `house_rule_acceptances`: Compliant acceptances audit trail (IP address, user-agent, checkbox labels, and timestamps).
5. System Rules Settings Tables: `guest_conduct_rules`, `visitor_rules`, `noise_rules`, `smoking_pet_rules`, `security_access_rules`, `damage_deposit_rules`, `corporate_stay_rules`, and `long_stay_rules`.
6. `rule_breach_reports`: Internal violating behaviors register (status: `reported`, `under_review`, `guest_contacted`, `resolved`, `escalated`, `closed`).
7. `enforcement_actions`: Security deposit deduction and warnings log approved by compliance authorities.

---

## 3. Front-End Design & Visual Standards
* **Typography**: Headlines Marcellus (Strictly capped at `Max 1.8rem`); body text Inter (capped at `Max 0.875rem`).
* **Symmetry**: Component cards use `border-radius: 0.1rem` with `box-shadow: rgba(0, 0, 0, 0.05) 0px 0px 0px 1px`. Buttons use `border-radius: 50px`.
* **Alternating Tones**: Section background colors alternate between Cloud White (`#FFFFFF`) and Soft Ice Blue (`#F4F8FF`).
* **Alpine.js TOC Sidebar**: Offers filter search, sticky layout, and Scroll Spy highlighting active sections in real-time.
* **CCTV Privacy Safeguard**: Terms explicitly disclaim interior bedroom/bathroom surveillance and restrict camera systems to common outdoor access routes.
* **Print layout**: Specific `@media print` directives hide navigational headers, footers, and floating Alpine sidebars for paper compliance copies.

---

## 4. Compliance Auditing & Log Trackers
* **Unified Audit Trail**: All rules drafting, breaches logging, and enforcement deduction approvals write entries to `audit_logs` leveraging `AuditLog::record(Auth::id(), 'action_key', 'description')`.
* **AJAX Logging**: Captures booking context checkbox actions securely.

---

## 5. Automated Verification Suites
* Tested with `php artisan test --filter=HouseRulesTest`.
* Asserts page loading (200), redirections (301), draft status shields (404), acceptance logs, breach logging, and enforcement action transactions.