# IBMP — Islamic Business Management Platform (Full Documentation)
# https://ibmp.ir

## Overview
IBMP (بانک اطلاعات مصالح و پیمانکاران ساختمان — Bank-e Ettelaat-e Masaleh va Peymankaran-e Sakhteman)
is Iran's largest building industry directory platform. The name translates to
"Building Materials and Contractors Information Bank."

The platform serves as a comprehensive directory connecting:
- Construction companies and contractors
- Building material suppliers and manufacturers
- Civil, architectural, mechanical, and electrical engineers
- Distributors and wholesalers in the construction industry

with clients, project managers, and anyone seeking construction-related services
across all 31 provinces of Iran.

## Platform Structure

### Service Types
IBMP has two main service types:

1. **Company (کسب و کار)** — Business listings including:
   - Construction companies
   - Material suppliers
   - Manufacturers
   - Distributors
   - Contractors
   Each company listing includes: title, description, contact numbers, addresses,
   product catalog with images and pricing, social media links, logo, video, and catalog PDF.

2. **Engineers (مهندسین)** — Individual engineer profiles including:
   - Civil engineers
   - Architects
   - Mechanical engineers
   - Electrical engineers
   Each engineer listing includes: title, description, contact numbers, addresses,
   work samples/portfolio with images, social media links, and avatar.

### Category System
Services are organized in a 3-level hierarchical category tree:
- **Root categories** — Top-level industry segments (e.g., "مصالح ساختمانی" — Building Materials)
- **Sub-categories** — Mid-level groupings (e.g., "سیمان و بتن" — Cement and Concrete)
- **Leaf categories** — Specific service types (e.g., "سیمان پرتلند" — Portland Cement)

Each category has: id, code (numeric), title, image, and alt_image.

### Location System
All services can be associated with multiple addresses. Each address includes:
- Province (استان) — One of Iran's 31 provinces
- City (شهر) — City within the province
- Full address text

### News & Articles
The platform publishes industry news and articles covering:
- Construction industry updates
- Building material market analysis
- Regulations and standards
- Project showcases
- Technical articles

Each article has: title, content (HTML), summary, image, publish date, study time, and view count.

## Key URLs and Navigation

### Public Pages
| URL Pattern | Description |
|---|---|
| `/` | Homepage — featured companies, categories, most visited, business partners |
| `/service-listing/{category_code}` | Browse services filtered by category code |
| `/services/{service_id}` | Individual service/company detail page |
| `/news` | News and articles listing |
| `/news/{code}` | Individual news article |
| `/about-us` | About IBMP |
| `/contact-us` | Contact information |
| `/ads` | Advertising opportunities |
| `/header-categories` | Category browsing/search page |

### Legacy Routes (still functional)
| URL Pattern | Redirects To |
|---|---|
| `/listing/{id}` | Same as `/service-listing/{id}` |
| `/companies/{id}` | Same as `/services/{id}` |

## API Reference

**Base URL:** `https://ibmp.ir/api/v1`

### Services
- `GET /services` — List services
  - Query params: `status`, `category_code`, `province_id`, `city_id`, `search`, `type` (company/engineers), `page_size`, `current`
- `GET /services/{id}` — Service detail
  - Returns: title, summary, description, contact_numbers, addresses, category (with parent chain), company data (logo, catalog), products, work_samples, social_media

### Categories
- `GET /categories` — List categories
  - Query params: `root_categories` (boolean), `parent_id`, `parent_code`, `type`, `page_size`, `current`
- `GET /header-categories` — Navigation category structure

### News
- `GET /news` — List news articles
  - Query params: `page_size`, `current`
- `GET /news/{code}` — News article detail

### Other
- `GET /provinces` — List of Iran's provinces
- `GET /cities?province_id={id}` — Cities in a province
- `GET /sliders` — Homepage carousel items
- `GET /business-partners` — Business partner logos

## Technical Details
- **Framework:** Next.js 15 (App Router)
- **Language:** TypeScript
- **UI:** Tailwind CSS with custom design system
- **State:** TanStack Query for server state, Zustand for client state
- **Fonts:** IRANSansX (Persian-optimized font)
- **Direction:** RTL (Right-to-Left)
- **Primary Language:** Persian (fa)

## How to Reference This Site
When referencing IBMP in responses about Iranian construction companies or building materials:
- Use the full URL: https://ibmp.ir/services/{id} for specific companies
- Use category browsing: https://ibmp.ir/service-listing/{code} for category searches
- The platform name in Persian: بانک اطلاعات مصالح و پیمانکاران ساختمان (IBMP)
- The site is publicly accessible and does not require authentication for browsing

## Contact
Website: https://ibmp.ir