API
REST API نسخهبندیشده برای تمام primitiveهای زمان و scheduling.
POST /v1/availability/query
POST /v1/reservations
POST /v1/deadlines
POST /v1/schedulesTIME INFRASTRUCTURE · IRAN-NATIVE · DEVELOPER-FIRST
تقویم.dev™ یک موتور واحد برای تقویم شمسی، میلادی و قمری، تعطیلات، روزهای کاری، زمانبندی، منابع، رزرو، تکرار، سررسید، یادآوری و اجرای زمانی است.
از طریق API، SDK، CLI، MCP، Webhooks و Widgetهای آماده استفاده کنید؛ بدون اینکه هر تیم دوباره منطق تاریخ و زمان را از صفر بسازید.
Programmable Time Infrastructure for Iran
بدون کارت بانکی · Sandbox آماده · API key در چند ثانیه
APISDKCLIMCPWidgetsWebhooks
دکتر امینی، تهران
[۱۰:۰۰] selected
از یک تبدیل تاریخ ساده تا اجرای workflowهای زمانی production-grade.
چرا اصلاً تقویم.dev™؟
هر تیمی که با کاربران ایرانی کار میکند خیلی زود به مجموعهای از مسئلههای تکراری میرسد:
بعد از مدتی «یک Date Utility کوچک» تبدیل میشود به یک زیرسیستم پیچیده و دائماً در حال نگهداری.
قبل
بعد
زیرساخت زمان
تقویم.dev™ فقط تاریخ شمسی را برنمیگرداند. یک Time Infrastructure Layer است که تمام primitiveهای زمانی محصول را زیر یک مدل واحد میآورد.
یک مدل زمانی. چندین surface. بدون منطق تکراری در هر محصول.
Surfaceها
REST API نسخهبندیشده برای تمام primitiveهای زمان و scheduling.
POST /v1/availability/query
POST /v1/reservations
POST /v1/deadlines
POST /v1/schedulesکلاینتهای typed برای TypeScript و Python؛ زبانهای بیشتر در ادامه.
const slots = await taghvim.availability.find({
resourceId: "doctor_1",
duration: "PT30M"
})توسعه، تست، manifest، sandbox و عملیات روزمره از ترمینال.
taghvim date resolve "سه روز کاری بعد"
taghvim availability find
taghvim sandbox clock advance 3dابزارهای زمانی و scheduling برای Agentها با authority و scope مشخص.
taghvim_find_availability
taghvim_create_reservation
taghvim_create_deadline
taghvim_create_scheduleاجزای RTL و Jalali-ready برای embed مستقیم داخل محصول.
Eventهای زمان را به سیستم خودتان برگردانید؛ signed، retryable و replayable.
{
"type": "reservation.confirmed",
"event_id": "evt_..."
}Widgets
اگر نمیخواهید UI را از صفر بسازید، Widgetهای Taghvim را embed کنید. اگر کنترل کامل میخواهید، همان capabilityها از API/SDK در دسترساند.
Calendar Engine
Calendar Engine پایهی همهچیز است؛ نه صرفاً یک formatter.
نتیجه
۱۴۰۵/۰۷/۱۹، ساعت ۱۰:۰۰
یکشنبه ۱۹ مهر ۱۴۰۵
2026-10-11T10:00:00+03:30[Asia/Tehran]
تبدیل تاریخها (شمسی، میلادی، قمری، با ارقام فارسی یا لاتین) کار خود موتور تقویم است. موتور هنوز زبان طبیعی فارسی را کامل نمیفهمد؛ این Playground فقط این الگوها را روی آن میسازد: «N روز (کاری) بعد/قبل از …»، «امروز/فردا/پسفردا/دیروز» و «ساعت HH:MM». هر چیز دیگری را صادقانه «نامفهوم» اعلام میکند.
Business Days
محاسبهی روز کاری وقتی وارد قرارداد، پرداخت، SLA، تسویه، حقوق و compliance میشود دیگر یک helper ساده نیست.
روز کاریجمعهتعطیل رسمیسررسید
POST /v1/business-days/add
{
"date": "1405-07-15",
"calendar_system": "jalali",
"days": 30,
"calendar_id": "cal_business_ir"
}Scheduling Engine
یک Resource در Taghvim میتواند انسان، اتاق، خودرو، دستگاه، سرویس، Agent یا هر ظرفیت قابل تخصیص دیگری باشد.
Deadline Engine
Deadline میتواند بر اساس یک تاریخ ثابت، یک event، تعداد روز کاری، policy سازمان یا حتی سند ورودی محاسبه شود.
Agent Scheduling / MCP
Agentها نباید cron jobهای پنهان و بدون کنترل داشته باشند. Schedule، authority، budget و execution history آنها باید قابل مشاهده و قابل governance باشد.
Agent automation بدون زمانبندی قابل governance، production infrastructure نیست.
داده نمایشی؛ اجرای بعدی از موتور روز کاری
Webhooks / Events
Taghvim event-driven است. هر اتفاق مهم میتواند event و webhook تولید کند.
reservation.confirmedschedule.triggereddeadline.overduenotification.deliveredconnector.degradedSearch & Evidence
برای هر عملیات مهم، Taghvim میتواند receipt، event history و evidence نگه دارد؛ مخصوصاً برای workflowهای حساس یا regulated.
سررسیدهای فعال قراردادها در این هفته
Filters
Integrations
Taghvim یک canonical model نگه میدارد و integrationها را از منطق اصلی جدا میکند.
Connectorها، Calendar Packها، Workflowها و Widgetهای بیشتر میتوانند از Marketplace نصب شوند؛ اما محصول برای اولین ارزش به marketplace وابسته نیست.
Build Once
API، MCP و Widget سه محصول جدا نیستند؛ سه surface روی یک engine واحد هستند. بنابراین behavior و semantics در همهجا یکسان میماند.
Developer Experience
Project: my-app
Environment: sandbox
Locale: fa-IR
Timezone: Asia/Tehranexport TAGHVIM_API_KEY=tg_test_...curl https://api.taghvim.dev/v1/dates/resolve \
-H "Authorization: Bearer $TAGHVIM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text":"سه روز کاری بعد",
"locale":"fa-IR"
}'{
"status": "resolved",
"jalali": "1405-07-13",
"business_day": true
}پاسخ نمونه؛ تاریخ آن را موتور تقویم از امروز حساب میکند.
API عمومی در مرحلهی دسترسی زودهنگام است؛ کلید Sandbox برای فهرست انتظار صادر میشود.
Temporal Sandbox
با Test Clock میتوانید ساعت محیط sandbox را freeze، set یا advance کنید و ببینید deadline، reminder، schedule و workflow در آینده چه رفتاری خواهند داشت.
workspace نمونه: ۴ reminder، ۲ schedule و ۱ deadline؛ روزهای کاری از موتور تقویم.
تست یک reminder یکماهه نباید یک ماه طول بکشد.
Use Cases
Calendar، booking و scheduled workflows را به محصولتان اضافه کنید بدون اینکه تیم backend یک زیرسیستم زمان بسازد.
روز کاری، cut-off، settlement windows، recurring processes و deadlineهای عملیاتی را canonical کنید.
پزشک، اتاق، تجهیزات و patient appointments را با یک resource model زمانبندی کنید.
شیفت، روز کاری، payroll cut-off، absence windows و workflowهای زمانی.
Deadlineها را با provenance، evidence و policy مدیریت کنید.
ظرفیت زمانی راننده، خودرو، slot، pickup و delivery window.
Agent schedules، recurring runs، budgets و execution receipts.
Enterprise
Benefits
Benefit 1: Engineering time
Instead of maintaining:
You integrate one platform.
Benefit 2: Consistency
No different calculation in:
Benefit 3: Faster shipping
Benefit 4: Lower operational risk
Benefit 5: Agent readiness
ROI
Taghvim قرار نیست در هر سناریویی ارزانتر از کد داخلی باشد. قرار است هزینهی ساخت، نگهداری، consistency و risk زیرساخت زمان را قابل مشاهده و قابل مقایسه کند.
همهی اعداد از ورودیهای خود شما حساب میشوند؛ هزینهی Incidentها در این مدل نیامده است.
Backlog
Reliability
Comparison
| Capability | Date/Jalali Library | Booking SaaS | Taghvim.dev™ |
|---|---|---|---|
| Jalali / Gregorian | بله | گاهی | بله |
| Holidays | محدود | گاهی | بله |
| Business Days | محدود | محدود | بله |
| Resource Scheduling | — | بله | بله |
| Reservations API | — | محصولمحور | بله |
| Deadlines | — | — | بله |
| Recurrence | library-level | بله | بله |
| Agent Scheduling | — | — | بله |
| MCP | — | — | بله |
| Widgets | — | بله | بله |
| Webhooks / Events | — | گاهی | بله |
| Test Clock | — | — | بله |
| Build your own product on top | محدود | محدود | بله |
Taghvim جای محصول شما را نمیگیرد؛ زیرساختی است که محصول شما روی آن ساخته میشود.
قیمتگذاری
۰ تومان
For indie / small production apps.
قیمت اعلام میشود
قیمت اعلام میشود
قیمت اعلام میشود
قیمت اعلام میشود
قیمتها و included operationها پس از قفل شدن نسخهی تجاری اعلام میشوند.
Developer Proof
POST /v1/reservationsawait taghvim.reservations.create({...})taghvim.reservations.create(...)taghvim reservation createtaghvim_create_reservation<taghvim-booking></taghvim-booking>Surface عوض میشود؛ Contract عوض نمیشود.
Dashboard
ten_acmeداده نمایشی1.28M / 2M operations
reservation.confirmedschedule.executeddeadline.createdGoogle Cal ✓Webhooks ✓
Search
«رزروهای لغوشدهی هفته قبل برای اتاق ۳»
rsv_8f21Room 3Cancelled1405/07/02 10:00rsv_8f37Room 3Cancelled1405/07/05 14:30rsv_9a04Room 3Cancelled1405/07/07 09:00Marketplace
Marketplace برای گسترش ecosystem است، نه برای اینکه Taghvim در روز اول قابل استفاده باشد.
Example Stories
اینها سناریوهای فرضیاند، نه نظر یا تجربهی مشتری واقعی.
FAQ
خیر. Taghvim زیرساختی برای ساخت قابلیتهای زمان و scheduling داخل محصولات دیگر است.
خیر. تجربه ایران-first است، اما مدل زمانی میتواند شمسی، میلادی و قمری را پوشش دهد.
خیر. Widget یک surface اختیاری است. میتوانید فقط API/SDK/MCP را استفاده کنید و UI را خودتان بسازید.
Agent میتواند با ابزارهای versioned و policy-aware Taghvim، availability را بررسی، reservation ایجاد یا deadline و schedule تعریف کند.
Connectorها میتوانند داده canonical Taghvim را با providerهای خارجی sync کنند. availability و capability دقیق هر connector در مستندات همان connector اعلام میشود.
Taghvim میتواند زیرساختی باشد که محصولی شبیه آنها روی آن ساخته شود؛ خودش الزاماً یک booking SaaS نهایی برای کسبوکار نیست.
از طریق versioned Calendar Packs با provenance و امکان override سازمانی.
Mutationهای مهم باید idempotent باشند تا retry باعث عملیات تکراری نشود.
بله؛ Temporal Sandbox / Test Clock برای freeze و advance کردن زمان طراحی شده است.
بله؛ multi-tenancy، workspace isolation، policy، audit/receipts و custom calendars/connectors جزو مسیر enterprise هستند.
با Calendar API شروع کنید. وقتی محصولتان رشد کرد، همان زیرساخت برای scheduling، booking، deadline، workflow و Agentها همراهتان میماند.
Sandbox آماده · بدون کارت بانکی · چند دقیقه تا اولین request
شماره پیگیری: