# Syria House

> Syria House is a bilingual (Arabic and English) real-estate marketplace for discovering, buying, and selling property across Syria. Browse listings, search on a map, explore agency showrooms, and view construction and design services.

Syria House is published at https://app.syriahouse.net. Public pages use a locale prefix (`/ar` or `/en`); Arabic is the default. The site root `/` redirects to `/ar`. Listings are stored as "products" in the backend but are presented to visitors as properties and houses.

## Technical Architecture

- Built with **Symfony 7.4**, PHP 8.2+, Doctrine ORM, Twig, MariaDB, and **Lexik JWT Authentication**.
- Default locale is `ar`; only `en` and `ar` are supported. `/` redirects to `/{_locale}` with `_locale=ar`.
- Public site uses **RTL** Twig layouts; the authenticated admin control panel uses **LTR** layouts. Do not mix layout conventions.
- Core domain model uses **Product** for property listings (houses), not e-commerce SKUs. Listings support USD and SYP pricing, soft-delete, and sold state.
- Translatable entities (Category, Brand, City, Status, Feature, etc.) use **KnpLabs Doctrine Behaviors**. Read translated fields via the active locale, not the base column alone.
- Listing filters and pagination are centralized in shared repository logic — reuse the same patterns for web and API rather than duplicating queries.
- **Security**: `main` firewall = form login + CSRF for web; `api` firewall = stateless JWT. Roles include `ROLE_ADMIN`, `ROLE_AGENT`, `ROLE_PUBLISHER`, and `ROLE_USER`. Admin paths under `/admin` are role-gated.
- Product images are served from `/uploads/products/`. SEO meta tags and JSON-LD are rendered on public property and listing pages.
- Server-rendered Twig with progressive enhancement (AJAX partials); not a headless-only or SPA-first application.

## Main Pages

- [Home (Arabic)](https://app.syriahouse.net/ar): Featured property listings and category entry points; default landing page.
- [Home (English)](https://app.syriahouse.net/en): English-language home page with the same listing experience.
- [About Us](https://app.syriahouse.net/ar/about-us): Company background, mission, and platform overview.
- [Services](https://app.syriahouse.net/ar/services/): Construction, design, and related real-estate services offered by Syria House.
- [Projects](https://app.syriahouse.net/ar/projects): Portfolio of completed and in-progress real-estate projects.
- [Contact Us](https://app.syriahouse.net/ar/contact-us): Contact form for inquiries and support.
- [Privacy Policy](https://app.syriahouse.net/ar/privacy-policy): Data collection, usage, and privacy practices.
- [Terms of Use](https://app.syriahouse.net/ar/terms-of-use): Terms and conditions for using the platform.

## Property Listings & Search

- [Property Search (Grid)](https://app.syriahouse.net/ar/search/grid): Filterable grid view of available properties by city, price, features, and category.
- [Property Search (List)](https://app.syriahouse.net/ar/search/list): List view of search results with the same filters as the grid view.
- [Properties Search Page](https://app.syriahouse.net/ar/properties/search): Dedicated property search landing page.
- [Property Search Results](https://app.syriahouse.net/ar/properties): Search results endpoint driven by query parameters.
- [Map Search](https://app.syriahouse.net/ar/map/search): Interactive map for discovering properties by location.
- [Property Reels](https://app.syriahouse.net/ar/reels): Vertical, Instagram-style browsing experience for property photos and details.
- [Property Detail](https://app.syriahouse.net/ar/property/{code}): Individual listing page with photos, features, pricing, and agency contact (replace `{code}` with a listing code).
- [Favorites](https://app.syriahouse.net/ar/favorite): Saved properties for logged-in users.

## Real Estate Agencies

- [Agency Directory](https://app.syriahouse.net/ar/real-estate-agencies): Browse registered real-estate agencies and showrooms, filterable by name and city.
- [Agency Profile](https://app.syriahouse.net/ar/real-estate-agencies/{slug}): Agency showroom page with its active listings (replace `{slug}` with an agency slug).

## Services & Projects

- [Service Category](https://app.syriahouse.net/ar/services/category/{slug}): Services grouped by category (replace `{slug}` with a category slug).
- [Service Gallery](https://app.syriahouse.net/ar/services/service/{slug}/gallery): Photo gallery for a specific service.
- [Service Projects](https://app.syriahouse.net/ar/services/service/{slug}/projects): Projects associated with a specific service.
- [Project Detail](https://app.syriahouse.net/ar/project/{slug}): Individual project page with scope, photos, and related services.

## Account & Authentication

- [Log In](https://app.syriahouse.net/ar/login): User sign-in for favorites, profile, and listing management.
- [Register](https://app.syriahouse.net/ar/register): Create a new user account.
- [User Profile](https://app.syriahouse.net/ar/profile): View and edit account settings (requires login).
- [My Properties](https://app.syriahouse.net/ar/user/properties): Manage properties posted by the logged-in user.
- [Reset Password](https://app.syriahouse.net/ar/reset-password): Request a password-reset email.
- [Admin Login (Google)](https://app.syriahouse.net/cp/login_google): Google OAuth entry point for admin and agent accounts.

## REST API

JSON API for mobile clients and integrations. Authenticated endpoints require a JWT from `/api/login_check`.

- [API Health Check](https://app.syriahouse.net/api/test): Simple endpoint to verify API availability.
- [List Properties](https://app.syriahouse.net/api/houses): Paginated property listings with filter support.
- [Search Properties](https://app.syriahouse.net/api/search/houses): Search properties by query parameters.
- [Map Search](https://app.syriahouse.net/api/map/search/houses): Location-based property search for map views.
- [Map Properties](https://app.syriahouse.net/api/map/properties): Property markers and data for map rendering.
- [Property Detail (API)](https://app.syriahouse.net/api/house/{code}): Single property JSON by listing code.
- [List Agencies (API)](https://app.syriahouse.net/api/show-rooms): All real-estate agency showrooms.
- [Agency Detail (API)](https://app.syriahouse.net/api/show-room/{slug}): Single agency showroom with listings.
- [Site Settings (API)](https://app.syriahouse.net/api/settings): Public site configuration and metadata.
- [Categories (API)](https://app.syriahouse.net/api/categories): Property categories for filters and navigation.
- [Filters (API)](https://app.syriahouse.net/api/filters/{category_id}): Available filters for a given category.
- [JWT Login](https://app.syriahouse.net/api/login_check): Obtain a JWT access token (POST with email and password).

## Admin Panel

Authenticated area for agents, publishers, and administrators. Requires appropriate roles.

- [Admin Dashboard](https://app.syriahouse.net/admin/dashboard): Control panel home after admin login.
- [Manage Listings](https://app.syriahouse.net/admin/product): Create, edit, publish, and manage property listings.
- [Manage Agencies](https://app.syriahouse.net/admin/real-estate-agency): Admin CRUD for real-estate agency showrooms.
- [Site Settings](https://app.syriahouse.net/admin/site-settings): Global site configuration (admin only).

## SEO & Discovery

- [Sitemap (Arabic)](https://app.syriahouse.net/ar/sitemap.xml): Master XML sitemap index for Arabic pages.
- [Sitemap (English)](https://app.syriahouse.net/en/sitemap.xml): Master XML sitemap index for English pages.
- [Properties Sitemap](https://app.syriahouse.net/ar/sitemap-properties.xml): All indexable property listing URLs.
- [Pages Sitemap](https://app.syriahouse.net/ar/sitemap-pages.xml): Static and institutional page URLs.
- [Search Sitemap](https://app.syriahouse.net/ar/sitemap-search.xml): Search and filter landing URLs.
- [Robots.txt](https://app.syriahouse.net/robots.txt): Crawler access rules and sitemap references.

## Optional

- [Symfony 7.4 Documentation](https://symfony.com/doc/7.4/index.html): Framework reference for contributors.
- [Lexik JWT Authentication Bundle](https://github.com/lexik/LexikJWTAuthenticationBundle/blob/master/Resources/doc/index.rst): JWT setup and usage for the API.
- [KnpLabs Doctrine Behaviors — Translatable](https://github.com/KnpLabs/DoctrineBehaviors/blob/master/docs/translatable.md): Entity translation pattern used in the codebase.
- [Email Verification](https://app.syriahouse.net/verify/email): Account email verification callback.
- [English About Us](https://app.syriahouse.net/en/about-us): English version of the About page.
- [English Contact Us](https://app.syriahouse.net/en/contact-us): English version of the Contact page.