# کالسو (Calso) ✦

تقویم شمسی + مدیریت کارها، شخصی و لوکال — با سرور MCP برای اتصال به AI.

**🔗 صفحه ورود و نصب روی گوشی: [soroush83faraz.github.io/calso](https://soroush83faraz.github.io/calso/)**

دو نسخه دارد:
- **نسخه آفلاین (PWA)** — [soroush83faraz.github.io/calso/app](https://soroush83faraz.github.io/calso/app/): مستقیم از گیت‌هاب اجرا می‌شود، دیتا در خود دستگاه (IndexedDB)، بدون اینترنت هم کار می‌کند، از کروم قابل نصب روی گوشی. سورس بک‌اند مرورگری: `web/src/local/`
- **نسخه لوکال** — سرور Node + SQLite روی کامپیوتر خودت با MCP و نوتیف ویندوز (پایین‌تر)

- **Todo** به سبک Microsoft To Do: روز من + پیشنهادها، مهم، لیست‌ها با رنگ/ایموجی، گروه‌بندی، زیرتسک (Steps)، یادداشت، ضمیمه فایل، ددلاین/یادآوری/تکرار (شمسی!)، مرتب‌سازی و درگ‌اند‌دراپ، جستجو، انجام‌شده‌ها، دارک مود
- **تقویم**: شمسی + میلادی، مناسبت‌ها و تعطیلات رسمی ایران، رویدادها، سوییچ شمسی/میلادی، خروجی PDF ماهانه، تبدیل تاریخ، محاسبه سن، فاصله دو تاریخ، ساعت جهانی، قطب‌نما (روی گوشی)
- **نوتیفیکیشن**: توست ویندوز + پوش گوشی از طریق ntfy
- **MCP**: ۱۷ ابزار برای اینکه AI تسک بسازد، برنامه‌ات را بخواند و روزت را برنامه‌ریزی کند

## اجرا

```bash
# بار اول (نصب وابستگی‌ها + بیلد رابط):
npm run setup

# هر بار:
npm start          # یا دابل‌کلیک روی start-calso.bat
```

بعد باز کن: **http://localhost:4820**
از گوشی (همان وای‌فای): آدرس IP سیستم را که موقع اجرا چاپ می‌شود باز کن، مثلا `http://192.168.1.5:4820`

### نصب روی گوشی (مثل یک اپ)

اپ را در کروم گوشی باز کن → منوی ⋮ → **Add to Home screen**. آیکون کالسو به صفحه اصلی اضافه می‌شود.
راهنمای کامل: [صفحه ورود](https://soroush83faraz.github.io/calso/)

### اجرای خودکار با روشن شدن ویندوز (اختیاری)

`Win+R` → بنویس `shell:startup` → Enter → یک Shortcut از `start-calso.bat` داخل آن پوشه بگذار.

## اتصال به AI (MCP)

```bash
claude mcp add calso -- node "C:\Users\Lenovo\projects\calso\mcp\server.js"
```

بعد در Claude Code می‌توانی بگویی:
- «فردا ساعت ۵ یادم بنداز برم خرید»
- «برنامه این هفته‌ام چیه؟»
- «روزم رو برنامه‌ریزی کن»
- «تسک‌های مهم عقب‌افتاده‌ام رو بذار توی روز من»

## نوتیف گوشی (ntfy)

1. اپ **ntfy** را نصب کن (گوگل‌پلی یا F-Droid)
2. ساده‌ترین راه: در تنظیمات کالسو، سرور را `https://ntfy.sh` و تاپیک را یک اسم یکتا بگذار (مثل `calso-soroush-x7k2`) و در اپ ntfy همان تاپیک را Subscribe کن
3. بدون اینترنت/برای وای‌فای خانه: [باینری ویندوز ntfy](https://github.com/binwiederhier/ntfy/releases) را دانلود و با `ntfy serve --listen-http :8090` اجرا کن؛ در کالسو سرور را `http://IP-سیستم:8090` بگذار و در اپ گوشی هم Default server را همین آدرس بده
4. دکمه «تست نوتیف گوشی» در تنظیمات را بزن

## ساختار

```
server/   Express API + SQLite + زمان‌بند یادآوری + نوتیف
mcp/      سرور MCP (stdio) — همان دیتابیس
web/      رابط React (RTL، وزیرمتن، تم روشن/تیره)
server/data/events.json   مناسبت‌های ایران (از پروژه متن‌باز persian-calendar)
```

دیتای تو فقط در `server/data/calso.db` روی همین سیستم است — هیچ‌چیز جایی آپلود نمی‌شود.