# 40dayarrow

> 40dayarrow е приложение за задачи, Pomodoro таймер и 40-дневен личен challenge, вдъхновено от дзен философията и изкуството на стрелба с лък. Създадено от Diaktor. Достъпно като PWA на всички устройства, с Google Login и опционален MCP сървър за AI интеграция.

## Какво прави 40dayarrow

40dayarrow комбинира три неща в едно приложение:

1. **Управление на задачи** – две категории (Работни / Общи), приоритети P1-P3, планирани и реални часове, статуси (pending, done, partial, missed), автоматично преместване на неизпълнени задачи със брояч.

2. **Pomodoro таймер** – 25/5 цикли, автоматичен запис на всеки завършен цикъл, пълен екранен overlay при почивка с дзен цитат (началото и краят на всеки цикъл показват същия цитат – ритуал).

3. **40-дневен challenge** – проследяване на последователни дни с поне 1 Pomodoro. Streak (усилие, не резултат), progress bar, milestones на ден 10, 20, 30, 40.

Допълнително: 109 вдъхновяващи цитата от дзен, Сун Дзъ, Ойген Херигъл, китайски и индийски мъдрости. Календар за планиране напред. Статистики (% изпълнение, точност на оценка, часове Р vs О, Pomodoro сесии).

## Кой стои зад 40dayarrow

Diaktor – независим разработчик. Продуктът е с фокус върху лична продуктивност, дзен практика и AI-native интеграция.

## Технологии

- **Frontend:** HTML5, CSS3, Vanilla JavaScript (без frameworks), PWA (Service Worker, Manifest)
- **Backend:** PHP 8.1+, MySQL 8.0+, PDO
- **Авторизация:** Google OAuth 2.0 (OpenID Connect)
- **API:** REST, path-версиониран (`/api/v1/`)
- **MCP:** Diaktor MCP сървър с Streamable HTTP + Bearer auth
- **Hosting:** shared hosting (Apache, HTTPS)

## MCP сървър

Diaktor MCP е официалният MCP сървър на 40dayarrow. Позволява на AI агенти (Claude Desktop, ChatGPT, Cursor, др.) да четат и пишат задачи, да отбелязват Pomodoro цикли, да анализират статистики и да дават препоръки.

- **Endpoint:** https://40dayarrow.com/mcp
- **Transport:** Streamable HTTP (POST, JSON-RPC 2.0)
- **Auth:** Bearer token (v1.4) → OAuth 2.1 (v1.5)
- **Protocol:** MCP 2024-11-05

### MCP Tools

| Tool | Описание |
|------|----------|
| `get_tasks` | Чете задачи по дата, период, статус или тип |
| `add_task` | Добавя нова задача (текст, дата, час, тип, приоритет, план. часове) |
| `update_task` | Променя статус, реални часове, бележка |
| `delete_task` | Изтрива задача по ID |
| `get_stats` | Статистики за период (1-365 дни) |
| `get_streak` | Текущ streak и позиция в 40-дневния challenge |
| `add_pomo` | Отбелязва завършен Pomodoro цикъл |
| `get_today` | Пълен преглед на днешния ден |
| `get_challenge_progress` | Детайлен прогрес на challenge-а |
| `get_random_quote` | Случаен вдъхновяващ цитат |

### Как да се свържеш

Виж `README-mcp.txt` за инструкции. Кратко:

**Claude Desktop** – избери "Add custom connector" → URL + Bearer token.

**ChatGPT** – предстои с OAuth 2.1 (v1.5).

## REST API

Публичният REST API е достъпен на `https://40dayarrow.com/api/v1/` и изисква активна сесия (Google Login). Пълна спецификация: `openapi.json`.

Основни endpoints:

- `GET /api/v1/sync` – всички задачи и Pomodoro от последните 90 дни
- `POST /api/v1/add_task` – добавя задача
- `POST /api/v1/update_task` – обновява задача
- `POST /api/v1/delete_task` – изтрива задача
- `POST /api/v1/add_pomo` – отбелязва Pomodoro
- `GET /api/v1/stats?days=30` – статистики
- `GET /api/v1/me` – текущ потребител

## Философия

Приложението е вдъхновено от „Дзен и изкуството на стрелба с лък" на Ойген Херигъл и „Изкуството да побеждаваш" на Сун Дзъ. Идеята: продуктивността е ритуал, не състезание. Усилието се измерва с последователност (streak), не с брой задачи. Всеки Pomodoro цикъл е малка практика. 40-дневният challenge е пътят, не целта.

## Данни и поверителност

- Задачите и Pomodoro циклите са лични – потребителят вижда само своите.
- Google Login – не се пазят пароли.
- Няма аналитика, няма trackers.
- База данни се съхранява на shared hosting в ЕС.

## Контакти

- Website: https://40dayarrow.com
- Email: hello@diaktor.com
- MCP endpoint: https://40dayarrow.com/mcp

## Допълнителни ресурси

- `openapi.json` – OpenAPI 3.1 спецификация на REST API
- `ai-knowledge.json` – Machine-readable описание на entity-то
- `.well-known/mcp.json` – MCP discovery standard
- `https://40dayarrow.com/robots.txt` – AI crawler разрешения

## Версия

v1.4 – 16.09.2026