Skip to content
BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
Intelligent To-Do Calendar
Intelligent To-Do Calendar
 
 
README.md
README.md
 
 

Repository files navigation

📅 Smart Calendar Planner

智能日历与待办规划 — Integrated Calendar, Todo & AI-Powered Scheduling

License: MIT Node.js >=18">https://img.shields.io/badge/node-%3E%3D18-green.svg"> React 18 Express Vite 6

A full-stack calendar and task management application built on the Eisenhower Priority Matrix. It offers both algorithm-based and LLM-powered intelligent scheduling to help you plan your time efficiently.

中文文档

✨ Features

📆 Multi-Calendar Management

  • Create, delete, and toggle multiple calendars with custom names & colors
  • Import iCal (.ics) files — auto-creates a dedicated calendar and batch-imports events
  • Full RRULE (RFC 5545) support for recurring events

✅ Todo Management (Eisenhower Matrix)

  • Automatic priority classification by urgency & importance (1–4 scale):
    • P1 Urgent & Important — Red
    • P2 Important — Orange
    • P3 Urgent — Blue
    • P4 Normal — Green
  • Status flow: Todo → Scheduled → Done
  • Deadline countdown with overdue highlighting
  • Estimated duration, description, and full metadata

🧠 Intelligent Scheduling

  • Algorithm Scheduler — Greedy strategy ordered by priority & deadline; avoids existing events; respects work hours (7:00–23:00); inserts 15-min breaks every 2 hours; 30-day planning horizon
  • LLM Scheduler — Supports OpenAI / DeepSeek / Ollama / LM Studio / custom providers; generates context-aware schedules via natural language
  • Smart Splitting — Tasks > 90 min are auto-split with breaks; labeled (1/N), (2/N), etc.; produces independent todo records when applied
  • Pre-schedule validation: time conflicts, late-night shifts, deadline violations
  • One-click apply — auto-marks todos as scheduled and displays on calendar
  • Customizable LLM prompt templates for fine-tuning scheduling strategy

🌙 Dark Mode

  • Light / Dark / System theme options
  • Full component-level dark mode support

🌍 Internationalization

  • Chinese / English switch
  • Calendar locale auto-adjusts with language

🖱️ Calendar Interactions

  • Drag to move events; drag edges to resize
  • Click empty area to quick-create an event
  • Scheduled todos shown with [Todo] prefix and custom color
  • Export weekly calendar to Excel (week view + event detail sheets)

🔒 Security

  • LLM API keys stored with AES-256-GCM encryption
  • API never returns key plaintext

🛠️ Tech Stack

Layer Technology
Frontend React 18 · TypeScript · Ant Design 5 · FullCalendar 6
Backend Express · TypeScript · sql.js (SQLite WASM)
Build Vite 6
LLM OpenAI / DeepSeek / Ollama

📋 Prerequisites

  • Node.js ≥ 18 (LTS recommended) — Download
  • OS: Windows (batch scripts provided); macOS / Linux work via CLI

🚀 Quick Start

Option 1: One-Click Scripts (Windows)

  1. Double-click install.bat to install dependencies
  2. Double-click start.bat to launch the app

start.bat auto-installs dependencies if node_modules is missing, starts backend & frontend, and opens the browser when ready.

Option 2: Command Line

# Clone the repository
git clone https://github.com/ADA-quart/Intelligent-To-Do-Calendar.git
cd Intelligent-To-Do-Calendar

# Install dependencies
npm install

# (Optional) Configure environment
cp .env.example .env

# Start dev servers
npm run dev:all

Open http://localhost:5173 in your browser.

📁 Project Structure

├── .env.example               # Environment variable template
├── index.html                 # Vite HTML entry
├── install.bat                # One-click install (Windows)
├── start.bat                  # One-click start (Windows)
├── uninstall.bat              # One-click uninstall (Windows)
├── package.json
├── vite.config.ts
├── tsconfig.json
├── server/
│   ├── index.ts               # Express server entry
│   ├── db/
│   │   ├── index.ts           # sql.js database wrapper
│   │   └── schema.sql         # Database schema
│   ├── llm/
│   │   ├── provider.ts        # LLM interface definition
│   │   ├── openai-compatible.ts # OpenAI / DeepSeek implementation
│   │   └── ollama.ts          # Ollama / LM Studio implementation
│   ├── routes/
│   │   ├── calendar.ts        # Calendar & event API + iCal import + Excel export
│   │   ├── todo.ts            # Todo API (auto priority)
│   │   ├── schedule.ts        # Schedule API + LLM config
│   │   └── settings.ts        # App settings API
│   ├── services/
│   │   ├── scheduler.ts       # Algorithm scheduling engine
│   │   ├── llm-scheduler.ts   # LLM scheduling engine
│   │   └── ical-parser.ts     # iCal file parser
│   └── utils/
│       ├── crypto.ts          # AES-256-GCM encryption utility
│       └── debug.ts           # Debug logger
├── src/
│   ├── main.tsx               # React entry
│   ├── App.tsx                # Root component (sidebar navigation)
│   ├── api/
│   │   └── client.ts          # Axios API client
│   ├── types/
│   │   └── index.ts           # TypeScript type definitions
│   ├── utils/
│   │   └── priority.ts        # Priority calculation
│   ├── contexts/
│   │   └── ThemeContext.tsx    # Theme management (light/dark/system)
│   ├── i18n/
│   │   ├── index.tsx          # i18n init
│   │   ├── zh.ts              # Chinese translations
│   │   └── en.ts              # English translations
│   └── components/
│       ├── CalendarView.tsx    # Calendar view
│       ├── TodoList.tsx        # Todo list
│       ├── TodoForm.tsx        # Todo form
│       ├── TodoSplitModal.tsx  # Todo split modal
│       ├── SchedulePanel.tsx   # Smart scheduling panel
│       ├── ImportModal.tsx     # iCal import modal
│       └── SettingsModal.tsx   # Settings (LLM/prompts/theme/language)

📡 API Reference

Health Check

Method Endpoint Description
GET /api/health Service health check

Calendar & Events /api/calendar

Method Endpoint Description
GET /calendars List all calendars
POST /calendars Create a calendar
DELETE /calendars/:id Delete a calendar and its events
GET /events List events (supports start/end range)
POST /events Create an event
PUT /events/:id Update an event
DELETE /events/:id Delete an event
POST /import Import iCal file
GET /export-week Export weekly calendar as Excel (.xlsx)

Todos /api/todos

Method Endpoint Description
GET / List todos (filter by status/priority)
POST / Create a todo (auto-calculates priority)
POST /:id/split Split a todo into time segments
PUT /:id Update a todo
DELETE /:id Delete a todo

Scheduling /api/schedule

Method Endpoint Description
POST /generate Generate a schedule (algorithm / llm)
POST /apply Apply a generated schedule
GET /llm-config Get LLM config (no API key)
POST /llm-config/test Test LLM connectivity
POST /llm-config Create LLM config
PUT /llm-config/:id/activate Activate a config
DELETE /llm-config/:id Delete a config
GET /prompt-template Get prompt template
PUT /prompt-template Update prompt template
POST /prompt-template/reset Reset to default template

⚙️ Configuration

Environment Variables

Copy .env.example to .env and customize:

cp .env.example .env
Variable Description Default
PORT Backend server port 3000
CRYPTO_SECRET API key encryption secret smart-calendar-default-secret-key

⚠️ Production: Always set a strong CRYPTO_SECRET. Never use the default value.

Ports

Service Port
Frontend (Vite dev server) 5173
Backend (Express API) 3000 (configurable via PORT)

Database

  • Engine: sql.js (SQLite WASM — no native compilation or system SQLite required)
  • File: data/calendar.db (auto-created on first run)
  • Auto-save: every 5 seconds + on shutdown
  • Write strategy: atomic (temp file + rename)

LLM Providers

Provider Default Model API Key Required
OpenAI gpt-4o-mini Yes
DeepSeek deepseek-chat Yes
Ollama llama3 No (local)
LM Studio — No (local)
Custom — Depends

🏭 Production Deployment

npm run build   # Build frontend to dist/
npm start       # Start server (serves both API and static files)

In production, Express automatically serves the dist/ directory — a single process on port 3000 provides the complete application.

📜 NPM Scripts

Command Description
npm run dev Start frontend dev server (Vite)
npm run dev:server Start backend dev server (tsx watch)
npm run dev:all Start both frontend & backend concurrently
npm run build Build frontend for production
npm start Start production server

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

中文说明

一款集成日历管理、待办规划与智能调度的全栈应用。基于 Eisenhower 四象限优先级矩阵，提供算法自动排程与 LLM 智能排程两种模式，帮助你高效规划时间。

主要功能

  • 多日历管理 — 自定义名称与颜色，支持 iCal 导入，完整 RRULE 重复事件支持
  • 四象限待办 — 按紧急度与重要度自动归类 P1–P4 优先级，截止日期倒计时
  • 智能调度 — 算法调度（贪心策略）与 LLM 调度（OpenAI / DeepSeek / Ollama / LM Studio）
  • 智能拆分 — 超过 90 分钟的长任务自动拆分，应用后生成独立待办记录
  • 深色模式 — 浅色 / 深色 / 跟随系统
  • 国际化 — 中英文切换
  • 日历交互 — 拖拽移动/调整时长，快速创建，Excel 周历导出
  • 安全 — API 密钥 AES-256-GCM 加密存储

快速开始

git clone https://github.com/ADA-quart/Intelligent-To-Do-Calendar.git
cd Intelligent-To-Do-Calendar
npm install
npm run dev:all

Windows 用户可直接双击 install.bat → start.bat 一键启动。

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages