Sahibinden Clone – Classifieds & Marketplace Platform

clonesahibinden is a scalable classified ads platform where users can register, list items across multiple categories such as vehicles, real estate, goods, and jobs, interact via messaging, and manage their listings with support for premium ad features and role-based moderation. The platform offers advanced category management, powerful search and filtering, and a comprehensive admin and moderation dashboard.

This documentation is designed to be consumed by both humans and AI agents. It provides comprehensive information about the backend services, APIs, data models, and integration patterns.

Detailed Documentation Files

For comprehensive documentation, the following detailed files are available:

• llms-full.txt: Complete documentation including all service designs, data models, and API specifications in a single document with nested table of contents.

• llms-restapi.txt: REST API focused documentation containing all service REST API guides combined. Ideal for understanding HTTP endpoints, request/response formats, and integration patterns.

• llms-prompts.txt: Frontend development prompts for AI-assisted UI building. Contains detailed specifications for implementing frontend features with data models, API endpoints, and UI requirements.

Documentation Overview

Sahibinden Clone – Classifieds & Marketplace Platform

Version : 1.0.13

clonesahibinden is a scalable classified ads platform where users can register, list items across multiple categories such as vehicles, real estate, goods, and jobs, interact via messaging, and manage their listings with support for premium ad features and role-based moderation. The platform offers advanced category management, powerful search and filtering, and a comprehensive admin and moderation dashboard.

How to Use Project Documents

The Clonesahibinden project has been designed and generated using Mindbricks, a powerful microservice-based backend generation platform. All documentation is automatically produced by the Mindbricks Genesis Engine, based on the high-level architectural patterns defined by the user or inferred by AI.

This documentation set is intended for both AI agents and human developers—including frontend and backend engineers—who need precise and structured information about how to interact with the backend services of this project. Each document reflects the live architecture of the system, providing a reliable reference for API consumption, data models, authentication flows, and business logic.

By following this documentation, developers can seamlessly integrate with the backend, while AI agents can use it to reason about the service structure, make accurate decisions, or even generate compatible client-side code.

Accessing Project Services

Each service generated by Mindbricks is exposed via a dedicated REST API endpoint. Every service documentation set includes the base URL of that service along with the specific API paths for each available route.

Before consuming any API, developers or agents must understand the service URL structure and environment-specific endpoints.

Service Endpoint Structure

Environment	URL Pattern Example
Preview	https://clonesahibinden.prw.mindbricks.com/auth-api
Staging	https://clonesahibinden-stage.mindbricks.co/auth-api
Production	https://clonesahibinden.mindbricks.co/auth-api

Replace auth with the actual service name as lower case (e.g., order-api, bff-service, customermanagement-api etc.).

Environment Usage Notes

• Preview APIs become accessible after a project is previewed inside the Mindbricks platform. These are ideal for development and testing.
• Staging and Production APIs are only accessible after the project is deployed to cloud environments provisioned via Mindbricks.
• In some cases, the project owner may choose to deploy services on their own infrastructure. In such scenarios, the service base URLs will be custom and should be communicated manually by the project owner to developers or AI agents.

Frontend applications should be designed to easily switch between environments, allowing dynamic endpoint targeting for Preview, Staging, and Production.

Getting Started: Use the Auth Service First

Before interacting with other services in the Clonesahibinden project, AI agents and developers should begin by integrating with the Auth Service.

Mindbricks automatically generates a dedicated authentication microservice based on the project’s authentication definitions provided by the architect. This service provides the essential user and access management foundation for the project.

Agents should first utilize the Auth Service to:

• Register and authenticate users (login)
• Manage users, roles, and permissions
• Handle user groups (if defined)
• Support multi-tenancy logic (if configured)
• Perform Policy-Based Access Control (PBAC), if activated by the architect

Auth Service Documentation

Use the following resources to understand and integrate the Auth Service:

• REST API Guide – ideal for frontend and direct HTTP usage
  Auth REST API Guide

• Event Guide – helpful for event-driven or cross-service integrations
  Auth Event Guide

• Service Design Document – overall structure, patterns, and logic
  Auth Service Design

Note: For most frontend use cases, the REST API Guide will be the primary source. The Event Guide and Service Design documents are especially useful when integrating with other backend microservices or building systems that interact with the auth service indirectly.

Using the BFF (Backend-for-Frontend) Service

In Mindbricks, all backend services are designed with an advanced CQRS (Command Query Responsibility Segregation) architecture. Within this architecture, business services are responsible for managing their respective domains and ensuring the accuracy and freshness of domain data.

The BFF service complements these business services by providing a read-only aggregation and query layer tailored specifically for frontend and client-side applications.

Key Principles of the BFF Service

• Elasticsearch Replicas for Fast Queries:
  Each data object managed by a business service is automatically replicated as an Elasticsearch index, making it accessible for fast, frontend-oriented queries through the BFF.

• Cross-Service Data Aggregation:
  The BFF offers an aggregation layer capable of combining data across multiple services, enabling complex filters, searches, and unified views of related data.

• Read-Only by Design:
  The BFF service is strictly read-only. All create, update, or delete operations must be performed through the relevant business services, or via event-driven sagas if designed.

BFF Service Documentation

• REST API Guide – querying aggregated and indexed data
  BFF REST API Guide

• Event Guide – syncing strategies across replicas
  BFF Event Guide

• Service Design – aggregation patterns and index structures
  BFF Service Design

Tip: Use the BFF service as the main entry point for all frontend data queries. It simplifies access, reduces round-trips, and ensures that data is shaped appropriately for the UI layer.

Business Services Overview

The Sahibinden Clone – Classifieds & Marketplace Platform project consists of multiple business services, each responsible for managing a specific domain within the system. These services expose their own REST APIs and documentation sets, and are accessible based on the environment (Preview, Staging, Production).

Usage Guidance

Business services are primarily designed to:

• Handle the state and operations of domain data
• Offer Create, Update, Delete operations over owned entities
• Serve direct data queries (get, list) for their own objects when needed

For advanced query needs across multiple services or aggregated views, prefer using the BFF service.

Available Business Services

adminModeration Service

Description: Admin and moderation service for logging, approval/denial, banning, role/config management, and audit actions. Orchestrates administrative and moderation business APIs, ensures every critical action is logged for traceability, and enables moderator/admin workflows.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/adminmoderation-api
Staging	https://clonesahibinden-stage.mindbricks.co/adminmoderation-api
Production	https://clonesahibinden.mindbricks.co/adminmoderation-api

categoryLocation Service

Description: Manages the category and location hierarchies for listings. Provides CRUD with uniqueness enforcement, navigation endpoints for category/location trees, and supports efficient public browsing with heavy read optimization.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/categorylocation-api
Staging	https://clonesahibinden-stage.mindbricks.co/categorylocation-api
Production	https://clonesahibinden.mindbricks.co/categorylocation-api

conversation Service

Description: Manages user-to-user messaging threads tied to listings, with message storage, read/unread and moderation support.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/conversation-api
Staging	https://clonesahibinden-stage.mindbricks.co/conversation-api
Production	https://clonesahibinden.mindbricks.co/conversation-api

favorite Service

Description: Handles all user favorites for classified listings, including add/remove, listing user-specific collections, and providing favorited status for listings. Prevents duplicate favorites and maintains favorite counts on listings for optimal UX. Cascade-cleans favorites if user or listing is deleted.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/favorite-api
Staging	https://clonesahibinden-stage.mindbricks.co/favorite-api
Production	https://clonesahibinden.mindbricks.co/favorite-api

listing Service

Description: Manages classified listings, their lifecycle, premium features, status transitions, and provides filtering/search for marketplace ads. Integrates with users, categories, locations, and Stripe for premium ad upgrades. Enforces ad and user type business logic.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/listing-api
Staging	https://clonesahibinden-stage.mindbricks.co/listing-api
Production	https://clonesahibinden.mindbricks.co/listing-api

listingImage Service

Description: Manages uploading, linking, ordering, and storing all images attached to classified listings. Enforces image file format, size, count, and metadata standards; supports multi-resolution handling and per-listing image count limits.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/listingimage-api
Staging	https://clonesahibinden-stage.mindbricks.co/listingimage-api
Production	https://clonesahibinden.mindbricks.co/listingimage-api

payment Service

Description: Handles Stripe payment flow for one-time premium upgrades on classified listings. Creates and tracks payment transactions, manages Stripe Checkout session and webhooks, and notifies the listing service to update premium status. Exposes payment history endpoints for users and reconciliation for admin.

Documentation:

• REST API Guide
• Event Guide
• Service Design

Base URL Examples:

Environment	URL
Preview	https://clonesahibinden.prw.mindbricks.com/payment-api
Staging	https://clonesahibinden-stage.mindbricks.co/payment-api
Production	https://clonesahibinden.mindbricks.co/payment-api

Conclusion

This documentation set provides a comprehensive guide for understanding and consuming the Sahibinden Clone – Classifieds & Marketplace Platform backend, generated by the Mindbricks platform. It is structured to support both AI agents and human developers in navigating authentication, data access, service responsibilities, and system architecture.

To summarize:

• Start with the Auth Service to manage users, roles, sessions, and permissions.
• Use the BFF Service for optimized, read-only data queries and cross-service aggregation.
• Refer to the Business Services when you need to manage domain-specific data or perform direct CRUD operations.

Each service offers a complete set of documentation—REST API guides, event interface definitions, and design insights—to help you integrate efficiently and confidently.

Whether you are building a frontend application, configuring an automation agent, or simply exploring the architecture, this documentation is your primary reference for working with the backend of this project.

For environment-specific access, ensure you’re using the correct base URLs (Preview, Staging, Production), and coordinate with the project owner for any custom deployments.

Table of Contents

Getting Started

• Introduction: Sahibinden Clone – Classifieds & Marketplace Platform

Frontend Prompts

• Authentication Management: Authentication Management
• Verification Management: Verification Management
• Profile Management: Profile Management
• User Management: User Management
• MCP BFF Integration: MCP BFF Integration
• AdminModeration Service: AdminModeration Service
• CategoryLocation Service: CategoryLocation Service
• Conversation Service: Conversation Service
• Favorite Service: Favorite Service
• Listing Service: Listing Service
• Listing Service Listing Payment Flow: Listing Service Listing Payment Flow
• ListingImage Service: ListingImage Service
• Payment Service: Payment Service

AdminModeration Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• adminActionLog Design: Documentation

Business APIs

• createAdminActionLog API: Business API Design Specification - Create Adminactionlog
• getAdminActionLog API: Business API Design Specification - Get Adminactionlog
• listAdminActionLogs API: Business API Design Specification - List Adminactionlogs
• _fetchListAdminActionLog API: Business API Design Specification - _fetch Listadminactionlog

CategoryLocation Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• category Design: Documentation
• location Design: Documentation

Business APIs

• createCategory API: Business API Design Specification - Create Category
• createLocation API: Business API Design Specification - Create Location
• deleteCategory API: Business API Design Specification - Delete Category
• deleteLocation API: Business API Design Specification - Delete Location
• getCategory API: Business API Design Specification - Get Category
• getLocation API: Business API Design Specification - Get Location
• listCategories API: Business API Design Specification - List Categories
• listLocations API: Business API Design Specification - List Locations
• updateCategory API: Business API Design Specification - Update Category
• updateLocation API: Business API Design Specification - Update Location
• _fetchListCategory API: Business API Design Specification - _fetch Listcategory
• _fetchListLocation API: Business API Design Specification - _fetch Listlocation

Conversation Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• conversationMessage Design: Documentation
• conversationThread Design: Documentation

Business APIs

• createConversationMessage API: Business API Design Specification - Create Conversationmessage
• createConversationThread API: Business API Design Specification - Create Conversationthread
• deleteConversationMessage API: Business API Design Specification - Delete Conversationmessage
• getConversationMessage API: Business API Design Specification - Get Conversationmessage
• getConversationThread API: Business API Design Specification - Get Conversationthread
• listConversationMessages API: Business API Design Specification - List Conversationmessages
• listConversationThreads API: Business API Design Specification - List Conversationthreads
• markMessageAsRead API: Business API Design Specification - Mark Messageasread
• _fetchListConversationMessage API: Business API Design Specification - _fetch Listconversationmessage
• _fetchListConversationThread API: Business API Design Specification - _fetch Listconversationthread

Favorite Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• favorite Design: Documentation

Business APIs

• createFavorite API: Business API Design Specification - Create Favorite
• deleteFavorite API: Business API Design Specification - Delete Favorite
• getFavorite API: Business API Design Specification - Get Favorite
• listFavorites API: Business API Design Specification - List Favorites
• _fetchListFavorite API: Business API Design Specification - _fetch Listfavorite

Listing Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• listing Design: Documentation
• sys_listingPayment Design: Documentation
• sys_paymentCustomer Design: Documentation
• sys_paymentMethod Design: Documentation

Business APIs

• createListing API: Business API Design Specification - Create Listing
• deleteListing API: Business API Design Specification - Delete Listing
• expirePremiumsAndListings API: Business API Design Specification - Expire Premiumsandlistings
• getListing API: Business API Design Specification - Get Listing
• listListings API: Business API Design Specification - List Listings
• updateListing API: Business API Design Specification - Update Listing
• upgradeListingPremium API: Business API Design Specification - Upgrade Listingpremium
• getListingPayment API: Business API Design Specification - Get Listingpayment
• listListingPayments API: Business API Design Specification - List Listingpayments
• createListingPayment API: Business API Design Specification - Create Listingpayment
• updateListingPayment API: Business API Design Specification - Update Listingpayment
• deleteListingPayment API: Business API Design Specification - Delete Listingpayment
• getListingPaymentByOrderId API: Business API Design Specification - Get Listingpaymentbyorderid
• getListingPaymentByPaymentId API: Business API Design Specification - Get Listingpaymentbypaymentid
• startListingPayment API: Business API Design Specification - Start Listingpayment
• refreshListingPayment API: Business API Design Specification - Refresh Listingpayment
• callbackListingPayment API: Business API Design Specification - Callback Listingpayment
• getPaymentCustomerByUserId API: Business API Design Specification - Get Paymentcustomerbyuserid
• listPaymentCustomers API: Business API Design Specification - List Paymentcustomers
• listPaymentCustomerMethods API: Business API Design Specification - List Paymentcustomermethods
• _fetchListListing API: Business API Design Specification - _fetch Listlisting
• _fetchListSys_listingPayment API: Business API Design Specification - _fetch Listsys_listingpayment
• _fetchListSys_paymentCustomer API: Business API Design Specification - _fetch Listsys_paymentcustomer
• _fetchListSys_paymentMethod API: Business API Design Specification - _fetch Listsys_paymentmethod

ListingImage Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• listingImage Design: Documentation

Business APIs

• createListingImage API: Business API Design Specification - Create Listingimage
• deleteListingImage API: Business API Design Specification - Delete Listingimage
• getListingImage API: Business API Design Specification - Get Listingimage
• listListingImages API: Business API Design Specification - List Listingimages
• updateListingImage API: Business API Design Specification - Update Listingimage
• _fetchListListingImage API: Business API Design Specification - _fetch Listlistingimage

Payment Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• paymentTransaction Design: Documentation

Business APIs

• createPaymentTransaction API: Business API Design Specification - Create Paymenttransaction
• getPaymentTransaction API: Business API Design Specification - Get Paymenttransaction
• listPaymentTransactions API: Business API Design Specification - List Paymenttransactions
• stripeWebhookCallback API: Business API Design Specification - Stripe Webhookcallback
• _fetchListPaymentTransaction API: Business API Design Specification - _fetch Listpaymenttransaction

Auth Service

• Service Design: Service Design Specification
• REST API Guide: REST API GUIDE
• Event Guide: .

Data Objects

• user Design: Documentation

Business APIs

• getUser API: Business API Design Specification - Get User
• updateUser API: Business API Design Specification - Update User
• updateProfile API: Business API Design Specification - Update Profile
• createUser API: Business API Design Specification - Create User
• deleteUser API: Business API Design Specification - Delete User
• archiveProfile API: Business API Design Specification - Archive Profile
• listUsers API: Business API Design Specification - List Users
• searchUsers API: Business API Design Specification - Search Users
• updateUserRole API: Business API Design Specification - Update Userrole
• updateUserPassword API: Business API Design Specification - Update Userpassword
• updateUserPasswordByAdmin API: Business API Design Specification - Update Userpasswordbyadmin
• getBriefUser API: Business API Design Specification - Get Briefuser
• registerUser API: Business API Design Specification - Register User

Bff Service

• Service Design: —
• REST API Guide: Documentation
• Event Guide: Documentation

Notification Service

• Service Design: Provider-specific errors include stack traces
• REST API Guide: Documentation
• Event Guide: Documentation

LLM Documents

• Documentation Index: Documentation
• Complete Documentation: Documentation
• REST API Reference: Documentation
• Frontend Prompts: Documentation

API Endpoints Summary

clonesahibinden-adminmoderation-service Service

• POST /adminModeration-api/createAdminActionLog - createAdminActionLog
• POST /adminModeration-api/getAdminActionLog - getAdminActionLog
• POST /adminModeration-api/listAdminActionLogs - listAdminActionLogs
• POST /adminModeration-api/_fetchListAdminActionLog - _fetchListAdminActionLog

clonesahibinden-categorylocation-service Service

• POST /categoryLocation-api/createCategory - createCategory
• POST /categoryLocation-api/createLocation - createLocation
• POST /categoryLocation-api/deleteCategory - deleteCategory
• POST /categoryLocation-api/deleteLocation - deleteLocation
• POST /categoryLocation-api/getCategory - getCategory
• POST /categoryLocation-api/getLocation - getLocation
• POST /categoryLocation-api/listCategories - listCategories
• POST /categoryLocation-api/listLocations - listLocations
• POST /categoryLocation-api/updateCategory - updateCategory
• POST /categoryLocation-api/updateLocation - updateLocation
• POST /categoryLocation-api/_fetchListCategory - _fetchListCategory
• POST /categoryLocation-api/_fetchListLocation - _fetchListLocation

clonesahibinden-conversation-service Service

• POST /conversation-api/createConversationMessage - createConversationMessage
• POST /conversation-api/createConversationThread - createConversationThread
• POST /conversation-api/deleteConversationMessage - deleteConversationMessage
• POST /conversation-api/getConversationMessage - getConversationMessage
• POST /conversation-api/getConversationThread - getConversationThread
• POST /conversation-api/listConversationMessages - listConversationMessages
• POST /conversation-api/listConversationThreads - listConversationThreads
• POST /conversation-api/markMessageAsRead - markMessageAsRead
• POST /conversation-api/_fetchListConversationMessage - _fetchListConversationMessage
• POST /conversation-api/_fetchListConversationThread - _fetchListConversationThread

clonesahibinden-favorite-service Service

• POST /favorite-api/createFavorite - createFavorite
• POST /favorite-api/deleteFavorite - deleteFavorite
• POST /favorite-api/getFavorite - getFavorite
• POST /favorite-api/listFavorites - listFavorites
• POST /favorite-api/_fetchListFavorite - _fetchListFavorite

clonesahibinden-listing-service Service

• POST /listing-api/createListing - createListing
• POST /listing-api/deleteListing - deleteListing
• POST /listing-api/getListing - getListing
• POST /listing-api/listListings - listListings
• POST /listing-api/updateListing - updateListing
• POST /listing-api/upgradeListingPremium - upgradeListingPremium
• POST /listing-api/getListingPayment - getListingPayment
• POST /listing-api/listListingPayments - listListingPayments
• POST /listing-api/createListingPayment - createListingPayment
• POST /listing-api/updateListingPayment - updateListingPayment
• POST /listing-api/deleteListingPayment - deleteListingPayment
• POST /listing-api/getListingPaymentByOrderId - getListingPaymentByOrderId
• POST /listing-api/getListingPaymentByPaymentId - getListingPaymentByPaymentId
• POST /listing-api/startListingPayment - startListingPayment
• POST /listing-api/refreshListingPayment - refreshListingPayment
• POST /listing-api/callbackListingPayment - callbackListingPayment
• POST /listing-api/getPaymentCustomerByUserId - getPaymentCustomerByUserId
• POST /listing-api/listPaymentCustomers - listPaymentCustomers
• POST /listing-api/listPaymentCustomerMethods - listPaymentCustomerMethods
• POST /listing-api/_fetchListListing - _fetchListListing
• POST /listing-api/_fetchListSys_listingPayment - _fetchListSys_listingPayment
• POST /listing-api/_fetchListSys_paymentCustomer - _fetchListSys_paymentCustomer
• POST /listing-api/_fetchListSys_paymentMethod - _fetchListSys_paymentMethod

clonesahibinden-listingimage-service Service

• POST /listingImage-api/createListingImage - createListingImage
• POST /listingImage-api/deleteListingImage - deleteListingImage
• POST /listingImage-api/getListingImage - getListingImage
• POST /listingImage-api/listListingImages - listListingImages
• POST /listingImage-api/updateListingImage - updateListingImage
• POST /listingImage-api/_fetchListListingImage - _fetchListListingImage

clonesahibinden-payment-service Service

• POST /payment-api/createPaymentTransaction - createPaymentTransaction
• POST /payment-api/getPaymentTransaction - getPaymentTransaction
• POST /payment-api/listPaymentTransactions - listPaymentTransactions
• POST /payment-api/stripeWebhookCallback - stripeWebhookCallback
• POST /payment-api/_fetchListPaymentTransaction - _fetchListPaymentTransaction

clonesahibinden-auth-service Service

• POST /auth-api/getUser - getUser
• POST /auth-api/updateUser - updateUser
• POST /auth-api/updateProfile - updateProfile
• POST /auth-api/createUser - createUser
• POST /auth-api/deleteUser - deleteUser
• POST /auth-api/archiveProfile - archiveProfile
• POST /auth-api/listUsers - listUsers
• POST /auth-api/searchUsers - searchUsers
• POST /auth-api/updateUserRole - updateUserRole
• POST /auth-api/updateUserPassword - updateUserPassword
• POST /auth-api/updateUserPasswordByAdmin - updateUserPasswordByAdmin
• POST /auth-api/getBriefUser - getBriefUser
• POST /auth-api/registerUser - registerUser

Getting Started

1. Authentication: Start with the Auth Service to register and authenticate users
2. Data Queries: Use the BFF Service for optimized read-only data queries
3. Business Operations: Use individual business services for create/update/delete operations

Additional Resources

• Full documentation: …/intro.html
• Search: …/search.html

---

Generated by Mindbricks Genesis Engine