# pa-ro - Full Documentation for LLMs

## Platform Overview

pa-ro is a public-facing local business directory for Romania. It allows consumers to search for and discover local businesses, services, and professionals in Romania. Business owners can claim, verify, and manage their online presence through the integrated on-the-go platform.

## Public URL Structure

### Search Pages
- `https://pa.ro/` - Home page with search functionality
- `https://pa.ro/search` - Business and professional search results
- `https://pa.ro/search-map` - Map-based search view

### Business Detail Pages
- `https://pa.ro/business/{id}` - Individual business/location page (public, SEO-friendly)

The `{id}` is the unique identifier for the location.

## Business Data Model

Each business listing (Location) can contain:

### Basic Information
- **name**: Business name
- **description**: Business description
- **categories**: Business categories (e.g., "Restaurant", "Plumber", "Dentist")
- **brands**: Brands carried, represented, or associated with the business
- **keywords**: Additional search keywords

### Contact Information
- **phone**: Primary phone number
- **email**: Email address
- **fax**: Fax number
- **website**: Website URL

### Social Media
- **instagram**: Instagram username or URL
- **facebook**: Facebook page URL
- **twitter**: Twitter/X username or URL
- **whatsapp**: WhatsApp number
- **snapchat**: Snapchat username
- **linkedin**: LinkedIn profile or company URL

### Location & Address
- **address.streetAndNo**: Street name and number
- **address.postalCode**: Postal code
- **address.city**: City name
- **address.countryCode**: ISO country code
- **address.latitude**: Geographic latitude
- **address.longitude**: Geographic longitude

### Business Hours
- **openingHours**: Regular weekly opening hours (day, open time, close time)
- **specialOpeningHours**: Holiday or special occasion hours

### Media
- **logo**: Business logo image
- **coverPhoto**: Cover/banner photo
- **photoGallery**: Additional photos

### Ratings & Reviews
- **averageRating**: Average customer rating (numeric)
- **reviewCount**: Total number of reviews

### Verification Status
- **verified**: Whether verified via eID
- **emailVerified**: Email verification status
- **phoneVerified**: Phone verification status

## Data Sources

Business data is stored in and served from Aztrix's own database.

## Search Capabilities

Users can search by:
- Business name
- Phone number
- Keywords
- Business categories
- Brands
- Geographic location (latitude/longitude)
- Bounding box (map area)

Search results return a mixed list of Location and Individual objects.

## AI Chat Integration

pa-ro provides an AI-powered chat interface (available as a web component `otg-ai-chat`) that can:
- Answer questions about businesses
- Provide contact information
- Give directions
- Initiate calls, emails, or text messages
- Show business locations on a map

## Usage Guidelines for AI Assistants

When helping users find businesses on pa-ro:
1. Direct users to the search page at `https://pa.ro/search` for discovering businesses
2. Business detail pages follow the pattern `https://pa.ro/location/{id}`
3. All business data is publicly accessible on detail pages
4. Contact information (phone, email) is displayed when available
5. Opening hours and special hours are shown in the business's local timezone

## Structured Data

Business detail pages include JSON-LD structured data using the `LocalBusiness` schema type, making business information machine-readable and compatible with Google Rich Results.

## Technical Details

- **Framework**: Angular 21+ (Server-Side Rendered for public pages)
- **Map Provider**: OpenStreetMap via Leaflet
- **Geocoding**: TomTom
- **Languages**: English (default), Romanian (planned), with translation support