# مستندات فنی جامع و راهنمای کامل پلتفرم ابری لوکال می (LocalMe Full Documentation) > لوکال می پلتفرم ابری Backend-as-a-Service (BaaS) بومی ایران است که خدمات پایگاه داده رابطه ای با RLS، احراز هویت توکن محور JWT، توابع سرورلس لبه و تله متری را در مراکز داده تهران با تاخیر زیر ۳۰۰ میلی ثانیه و پایداری ۱۰۰٪ ارائه می دهد. ## ۱. ساختار دسترسی و کلیدهای API درخواست های ارسالی از کلاینت ها با هدرهای زیر تایید می شوند: - `x-api-key` / `X-Service-Key`: کلید تفکیک شده اختصاصی هر سرویس با الگوی `lm_[service]_[project]_[id]` - `Authorization: Bearer `: توکن اعتبارسنجی احراز هویت JWT کاربر - `Accept: application/json`: ساختار تبادل داده پیش فرض ## ۲. سرویس پایگاه داده رابطه ای (Database) - پایگاه داده رابطه ای ابری مدیریت شده با تفکیک داده اختصاصی برای هر پروژه - کوئری مستقیم JSON از فرانت اند و کلاینت های موبایل بدون نیاز به کدنویسی بک اند - امنیت در سطح سطر (Row-Level Security): تفکیک قطعی داده های هر کاربر و پروژه با سیاست های امنیتی - اندپوینت ها: - `GET https://localme.ir/_baas/v1/{project}/db/{table}`: دریافت رکوردهای جدول با فیلتر - `POST https://localme.ir/_baas/v1/{project}/db/{table}`: ایجاد رکورد جدید - `PATCH https://localme.ir/_baas/v1/{project}/db/{table}/{id}`: بروزرسانی سطر - `DELETE https://localme.ir/_baas/v1/{project}/db/{table}/{id}`: حذف رکورد ## ۳. سرویس احراز هویت (Auth & Users) - احراز هویت امن توکن محور JWT با نام کاربری/ایمیل و کلمه عبور با هش ایمن Argon2id - ثبت نام خودکار و مدیریت کاربران با سطوح دسترسی تفکیک شده - اندپوینت ها: - `POST https://localme.ir/_baas/v1/{project}/auth/signup`: ثبت نام کاربر جدید با ایمیل و کلمه عبور - `POST https://localme.ir/_baas/v1/{project}/auth/login`: ورود و صدور توکن نشست JWT - `POST https://localme.ir/_baas/v1/{project}/auth/users/{userId}/reset-password`: تغییر رمز عبور کاربر ## ۴. توابع بدون سرور لبه شبکه (Edge Functions) - اجرای کدهای تجاری جاوااسکریپت و تایپ اسکریپت در محیط سبک ایزوله با حافظه اختصاصی - زمان اجرای زیر ۵۰ میلی ثانیه و ارتباط مستقیم با دیتابیس پروژه - اندپوینت ها: - `POST https://localme.ir/_baas/v1/{project}/functions/{slug}/invoke`: اجرای تابع لبه ## ۵. تله متری و پایش پروژه (Telemetry & Observability) - پایش و ثبت لحظه ای زمان پاسخ، کدهای وضعیت، تاخیر کوئری ها و خطاهای درخواست ها - فیلترینگ کوئری های کند بالای ۲۰۰ میلی ثانیه و ثبت لاگ های ساختاریافته JSON - اندپوینت ها: - `GET https://localme.ir/_baas/v1/{project}/telemetry/logs`: دریافت لاگ های پروژه با فیلترهای تاخیر و وضعیت ## ۶. نمونه کد کلاینت (Flutter / Dart) ```dart // اتصال و خواندن اطلاعات در فلاتر final response = await http.get( Uri.parse('https://localme.ir/_baas/v1/my-app/db/tasks'), headers: { 'x-api-key': 'lm_database_myapp_xyz123', 'Authorization': 'Bearer ' + userToken, }, ); ``` ## ۷. نمونه کد کلاینت (React Native / Web TypeScript) ```typescript const res = await fetch('https://localme.ir/_baas/v1/my-app/db/tasks', { headers: { 'x-api-key': 'lm_database_myapp_xyz123', 'Authorization': `Bearer ${userToken}`, } }); const tasks = await res.json(); ```