How etewiah/property_web_builder works
PropertyWebBuilder is a multi-tenant SaaS for creating and operating real-estate websites. The principal workflow is: a visitor arrives on a tenant domain, tenant resolution scopes the website, pages and listings are rendered, and search returns filtered property results. Site administrators then manage content, themes, listings, media, and reports; tenant administrators provision websites and subscriptions. The tree and README establish these capabilities, while sampled source most directly confirms routing, tenant isolation, page-part behavior, AI services, and ActiveStorage operations.
Main entry points: realty_asset.rb Property Listings · pages_controller.rb Public Websites · search_controller.rb Property Search · page_part_manager.rb Page Rendering
Components 29
Public Experience
- Public Websites
app/controllers/pwb/pages_controller.rb - Property Search
app/controllers/pwb/search_controller.rb - Public API
app/controllers/api_public/v1/properties_controller.rb
Content Management
- Page Rendering
app/services/pwb/page_part_manager.rb - Themes And Palettes
app/models/pwb/theme.rb - Content Editor
app/controllers/site_admin/pages_controller.rb - Site Administration
app/controllers/site_admin_controller.rb
Property Operations
- Property Listings
app/models/pwb/realty_asset.rb - Faceted Search
app/services/pwb/search_facets_service.rb - Listing Administration
app/controllers/site_admin/props_controller.rb - Imports And Feeds
app/services/pwb/property_bulk_import_service.rb
Platform Administration
- Tenant Resolution
app/controllers/concerns/subdomain_tenant.rb - Tenant Administration
app/controllers/tenant_admin_controller.rb - Website Provisioning
app/services/pwb/provisioning_service.rb - Subscriptions
app/services/pwb/subscription_service.rb - Authentication
app/services/pwb/firebase_auth_service.rb
Integrations
- Embeddable Widgets
app/controllers/widgets_controller.rb - AI Content Generation
app/services/ai/listing_description_generator.rb - CMA Reports
app/services/reports/cma_generator.rb - Tenant Analytics
app/services/pwb/analytics_service.rb - ActiveStorage Data
db/migrate/20251129181658_create_active_storage_tables.active_storage.rb - Storage Monitoring
app/controllers/site_admin/storage_stats_controller.rb - Blob Cleanup
app/jobs/cleanup_orphaned_blobs_job.rb
Other components
- Visitor
- Site Admin
- Tenant Admin
- External Website
- AI Provider
- Object Storage
Connections 33
- Visitor → Public Websites: browses site
- Public Websites → Tenant Resolution: resolves tenant
- Tenant Resolution → Property Listings: scopes listings
- Public Websites → Page Rendering: renders pages
- Page Rendering → Themes And Palettes: loads theme
- Page Rendering → Visitor: returns page
- Visitor → Property Search: searches listings
- Property Search → Faceted Search: builds facets
- Property Search → Property Listings: reads listings
- Property Search → Visitor: returns results
- Visitor → Public API: requests data
- Public API → Property Listings: reads properties
- Site Admin → Site Administration: opens admin
- Site Administration → Content Editor: manages content
- Content Editor → Page Rendering: updates page parts
- Site Admin → Listing Administration: manages listings
- Listing Administration → Property Listings: updates listings
- Listing Administration → Imports And Feeds: imports properties
- Tenant Admin → Tenant Administration: manages tenants
- Tenant Administration → Website Provisioning: provisions websites
- Tenant Administration → Subscriptions: manages subscriptions
- Public Websites → Authentication: authenticates users
- External Website → Embeddable Widgets: embeds listings
- Embeddable Widgets → Property Listings: reads listings
- Site Admin → AI Content Generation: requests copy
- AI Content Generation → AI Provider: generates content
- Site Admin → CMA Reports: requests report
- CMA Reports → Property Listings: finds comparables
- Public Websites → Tenant Analytics: tracks activity
- Site Admin → Storage Monitoring: checks storage
- Storage Monitoring → ActiveStorage Data: reads statistics
- Storage Monitoring → Blob Cleanup: queues cleanup
- ActiveStorage Data → Object Storage: stores blobs