طراحی
این صفحه شاخصِ جهتِ طراحیِ تأییدشدهٔ تقویمم است. چهچیزی اینجا normative است، چهچیزی گزارشِ پیادهسازی و چهچیزی فقط دموی تعاملی — تعریفش این است:
| اصطلاح | معنا | مرجع |
|---|---|---|
| هدف (Target) | چیزی که تأیید شده و مبنای تصمیمهای جدید است. لزوماً پیادهسازی نشده. | همین مستندات (این بخش و ui/*) |
| پیادهشده (Implemented) | چیزی که واقعاً در کد production وب/موبایل زندگی میکند. | کد پلتفرم؛ شکافها در وضعیت پذیرش |
| پروتوتایپ (Prototype) | دموی HTML تعاملی که هدف را نشان میدهد؛ مرجع نگاه است، مرجع کد نیست. | /prototypes/ |
| آرشیو (Archive) | کار تاریخی؛ هیچوقت ملاک تصمیم نیست. | ui-design/history، ui-design/explorations |
سه قاعدهٔ مرز:
- Docusaurus مالکِ جهتِ normative است — همین سایت، نه پروتوتایپها و نه بریفهای قدیمی.
- کد پلتفرم مالکِ حقیقتِ پیادهسازی است — آنچه در
apps/calendar-webوapps/mobileاجرا میشود، «وضعیت امروز» است؛ چیزی که اینجا «هدف» گفتیم ممکن است هنوز آنجا نباشد. - پروتوتایپها دمونستریشناند — نمایشِ رفتار هدف روی دادهٔ ساختگی؛ production
هیچ چیزی از
ui-design/ایمپورت نمیکند و متغیرهای CSS پروتوتایپ توکن production نیستند.
فاصلهٔ هدف تا پیادهسازی، ردیفبهردیف در وضعیت پذیرش طراحی ثبت میشود — تنها ماتریس دستیِ پذیرش.
مبانی طراحی
نسخهٔ تعاملی — ۷ بخش:
| بخش | لینک |
|---|---|
| رنگها — برند، سطوح ۵پلهای، معنایی، پالت ۸رنگی تقویمها | f-color |
| تایپوگرافی + قواعد ارقام فارسی | f-type |
| فاصله و شعاع گوشه | f-space |
| سایه و عمق | f-elevation |
| آیکونوگرافی | f-icons |
| حرکت (motion) | f-motion |
| جهت و تقویم جلالی — RTL اصیل، شبکه هفته، تعطیلات، API موتور جلالی | f-direction |
هدف، آبیِ واحدِ #2563EB است (Foundations → رنگها).
وب و موبایل هر دو توکنهای MD3 را از همین seed و از یک منبع واحد تولید میکنند
(packages/design-tokens)؛ primary روشن هر دو هنوز #004AC6 است — جزئیات و
مرز بعدی در وضعیت پذیرش.
کامپوننتها
۱۷ کامپوننت در ۵ گروه؛ فهرستِ کامل و مرتب، نوار کناری «کامپوننتها» است و هر صفحه قرارداد کاملِ ۱۲بخشی دارد. کتابخانهٔ تعاملی کامل همه را کنار هم نشان میدهد:
| گروه | کامپوننتها |
|---|---|
| اکشنها (group-actions) | دکمه · دکمه آیکونی · FAB |
| ورودیها (group-inputs) | فیلد ورودی · جعبههای OTP · انتخابگر تاریخ و ساعت · چکباکس گرد · سوییچ |
| ناوبری و انتخاب (group-navsel) | چیپ · تب قرصی · نشان · منوی پاپآور |
| لایهها (group-layers) | دیالوگ و برگه پایین · بنر · توست |
| دادهٔ تقویم (group-caldata) | شبکه ماه جلالی (ماهِ کوچک) · چیپ رویداد و ردیف وظیفه |
الگوها
مستند کامل — ۱۰ الگو:
کلاسهای پنجره و ناوبری واکنشگرا · پیشنمایش سپس ویرایش · دیالوگها/برگهها/منوها · انتخاب تاریخ جلالی · فرمها · استیتهای داده · همگامسازی و تعارض · جستجو · حالت تاریک · دسترسپذیری و نوشتار رابط
مرور کلی سیستم — اصول، ساختار مستندات، نقشهٔ توکنها
صفحههای محصول (پروتوتایپهای تعاملی)
| صفحه | لینک | داخلش |
|---|---|---|
| تقویم کامل (روز/هفته/ماه/برنامه) | calendar | دیالوگهای رویداد جدید، تقویم جدید، لینکهای رزرو، تداخلهای همگامسازی، حذف تقویم، وظیفهٔ جدید |
| ورود دومرحلهای (OTP) | login | — |
| وظیفهها | tasks | (نمای وظیفه داخل تقویم: calendar.html?view=tasks) |
برند و لوگو
مستند کامل هویت بصری — سه مسیر کاوش شد (خورشیدِ صفحه، نقطهٔ امروز، تیکِ صفحه) و مسیر منتخب: «نقطهٔ امروز» — با قواعد کاربرد (فضای ایمن، حداقل اندازهها، نسخههای رنگی، ممنوعیتها، آیکون اپ) و پرامپتهای تولید.
نام محصول: در متن فارسی تقویمم؛ در متن انگلیسی (سایت /en، Swagger)
Taghvimam.
وضعیت کد در برابر طراحی
توکنهای زندهٔ وب: apps/calendar-web/src/styles/tokens.css (MD3)؛ تم موبایل:
apps/mobile/core/design (FaTheme). وضعیتِ تکتک پایهها و قابلیتها — هدف، وب،
اندروید، پروتوتایپ و شاهد مخزن — در وضعیت پذیرش طراحی است.
آرشیو (کاوشها و تاریخچهٔ نسخهها) فقط repo-only است و هیچوقت normative نیست:
explorations/
و history/
(شامل بریف آرشیوشدهٔ
DESIGN_BRIEF-2026-09.md).