Realty

Bug-Fixing Guidance

• Check whether the issue originates in model scopes, API filtering, resource serialization, or page-level theming/state.
• For mixed listing-state bugs, verify public visibility rules and panel visibility rules separately.
• For map/location issues, verify coordinates, address normalization, and fallback behavior.
• For inquiry bugs, test guest vs authenticated flows and ownership visibility.

Refactor Guidance

• Refactor toward shared listing/detail primitives only when the semantics are genuinely shared.
• Avoid forcing ecommerce assumptions into realty pages.
• Preserve distinct handling for properties, developments, and agents even when the UI looks similar.

Testing Expectations

• Cover property browse/filter APIs, property detail, inquiry submission, saved searches, open house RSVP, compare behavior, and key location/map fallbacks.
• Add tests for public visibility, inquiry authorization, and realty panel scoping.
• On the frontend, test filters, detail rendering, inquiry forms, compare state, and saved-search interactions.

Documentation And PHASING Rules

• Update PHASING.md when realty discovery, inquiry, RSVP, compare, or development features materially move status.
• Mark a realty feature complete only when public flow, backend logic, and panel/admin support line up where expected.

Security And Data Isolation Cautions

• Preserve store/agent ownership boundaries in realty panel actions.
• Do not expose unpublished or cross-tenant inquiries.
• Sanitize any seller-managed rich text that renders on public listing pages.

Common Pitfalls

• Treating realty like ecommerce checkout flows
• Breaking development-to-property consistency
• Exposing suspended or unpublished listings through broad scopes
• Fixing listing detail visuals without checking inquiry, compare, and saved-search behavior

Common Files And Folders

• src/app/Models/Property.php
• src/app/Models/Development.php
• src/app/Http/Controllers/Api/V1/PropertyController.php
• src/app/Http/Resources/Api/V1
• src/app/Filament/Realty
• frontend/src/pages/realty
• frontend/src/api/properties.js
• frontend/src/api/inquiries.js