Okala

Whether the server is logged in to Okala (and as which phone, masked). Logged in = ok_search uses Okala's text search; guest = category matching. To log in: ok_login.

Brand ids for ok_compare (`brand_id`) and slugs. Okala publishes only a short list of featured brands; any other brand is looked up by its Latin slug (as in okala.com/brands/<slug>; ok_product returns brand_slug, ok_search returns the brands of its results with ids).

Category tree (id, slug, Persian name, children) of everything sold near a point, or in one store. Use to find the slug for ok_compare / ok_store_products when ok_search's guess is off, or to show what a store sells. Level-1 slugs (departments, e.g. 'dairy-products') work in ok_store_products.

Which open nearby store sells the same product cheapest: a category and/or brand from every store, grouped by product id, each store's price cheapest first; products sold by most stores come first. `stores` has each store's distance, earliest slot and fees (true cost = items + fees; the minimum order applies, see ok_store). At most 12 products per store: narrow with a deeper slug or brand_id.

Deal rows running now, with their end time (UTC) and top products (Toman, discount, store). Without store_id: the home-page rows across every open store that delivers to the point. With store_id: that store's rows plus its biggest discounts. Open a whole row with ok_offer(carousel_id).

Turn an address into coordinates (lat, lon) for every other tool, plus the street address of the best hit. Use first when the user gives an address or place name; then pass the chosen candidate's lat / lon to ok_stores, ok_search, ok_compare or ok_deals. Candidates can mix similar names: check `description`.

Log in to the user's Okala account, which unlocks Okala's real text search in ok_search (brands and product names, inside one store too). Optional: every other tool works as a guest. Only call this when the user asked to log in and gave THEIR OWN phone number. It sends an SMS code to that number (at most one every 2 minutes). If the client can show a form, the user types the code there and the login finishes in this call. Otherwise the reply says `code_sent`: ask the user for the code and call ok_login_verify. Nothing is ordered or changed in the account.

Finish a login started with ok_login: the code the user received by SMS. Saves the login on this machine (it refreshes itself); afterwards ok_search uses Okala's text search.

Delete the saved Okala login on this machine; the server continues as a guest.

Every product of one deal row (from ok_deals), Toman. Without store_id: across all open stores that deliver to the point, with each store's product count and price range; with store_id: that store only.

One product in one store: price and discount (Toman), stock, max per order, brand, category, images and description. `sold_here: false` = this store does not sell it (try ok_compare). The product id is the same in every store; the price and stock are per store.

Find products by text near a point (or in one store with store_id), best matches first, then cheapest (Toman). `mode`: "text" = Okala's own search (logged in; brands and product names too, up to 12 per store); "category" = guest fallback matching the query to nearby category names (a pure brand name may find nothing: pick a slug from ok_categories; store_id needs login, else use ok_store_products with name_contains). Use for "how much is X near me". Then: ok_compare (several stores, with fees), ok_product (one store).

One store as seen from the delivery point: whether it delivers there now, minimum order (Toman), rating, distance and location, the earliest slot, and every still-open delivery slot of the next days (Tehran local time). Use before recommending a store: the basket must reach `minimum_order`. Fees per order are in ok_stores; written reviews in ok_store_reviews.

A whole category of one store (the API returns all of it at once), sorted and optionally filtered by name, prices in Toman. `total` counts the matches before limit / offset. This is the way to search inside one store: pass a level-1 department slug (ok_categories with store_id, e.g. 'dairy-products') plus name_contains. Details of one product: ok_product.

Read customers' reviews of a store: 1-5 stars, comment, date and the reasons they ticked (liked: product variety, ...; disliked: expiry date problems, ...). Use as a quality check before recommending a store; LowestRate shows the complaints first. The average rating and rating count are in ok_stores / ok_store.

Okala stores that deliver to a point, in the site's order: id, type, rating, distance, earliest slot and the fees added to every order (service, packaging, delivery; Toman). Use after ok_locate. Pass store ids to ok_store (minimum order, slots), ok_store_products, ok_product and ok_deals; to compare one product across stores use ok_compare. `count` = matches before `limit`.