| Feature | Description |
|---|---|
| 📋 Task Management | Create, organize, and track tasks with colors, priorities, and deadlines |
| 🎯 Daily Goals | Set daily goals with priority levels and target times |
| 📅 Calendar | Plan events with color coding, templates, and exercise tracking |
| 👥 Team Management | Role-based access control (Leader, Mod, Member, Developer) |
| ⏰ Work Hours | Check-in/check-out system with hour tracking and charts |
| 📝 Submissions & Reports | Submit daily reports with admin approval workflow |
| 💬 Chat System | Real-time direct messaging between team members |
| 🔔 Notifications | In-app notification system with read/unread tracking |
| 📁 File Management | Upload/download files with role-based targeting |
| 🤖 Telegram Bot | Bot integration for reports, tasks, team info, and prices |
| 📊 Google Sheets | Auto-sync data to Google Sheets |
| 🔐 V2Ray Configs | Admin-managed VPN configuration sharing |
| 🗒️ Notepad | Persistent personal notes for users |
- Python 3.8+ with pip
- Node.js v18+ with npm
- Docker (optional, for production)
git clone https://github.com/AmirabbasRouintan/planner.git
cd planner
chmod +x start.sh
./start.shThe script sets up a Python venv, installs backend dependencies, starts Django on port 8001, installs frontend dependencies, and starts Vite on port 80.
Backend:
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python manage.py makemigrations
python manage.py migrate
python manage.py runserver 0.0.0.0:8001Frontend:
cd frontend
npm install
npm run dev -- --host 0.0.0.0 --port 80cd backend
docker-compose up -dStarts Django backend, Telegram bot, PostgreSQL, Redis, and Nginx.
| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript, Vite 7, Tailwind CSS 4 |
| UI Components | shadcn/ui, Radix UI, Framer Motion, Lucide Icons |
| Backend | Django 5.2, Django REST Framework 3.16 |
| Database | SQLite (dev), PostgreSQL (production) |
| Charts | Recharts |
| 3D Graphics | React Three Fiber, Three.js |
| Drag & Drop | Atlassian Pragmatic Drag and Drop |
| Flow Diagrams | xyflow/react |
| Chat | Stream Chat API + custom REST |
| Calendar | react-day-picker, date-fns |
planner/
├── frontend/ # React + Vite frontend
│ └── src/
│ ├── pages/ # App pages and routes
│ ├── components/ # UI components (shadcn/ui + custom)
│ ├── contexts/ # Auth context
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utilities and services
│ └── config/ # Backend URL config
├── backend/ # Django backend
│ ├── authentication/ # Auth app (User model, login, register)
│ ├── tickets/ # Main app (all core features)
│ ├── sim/ # Google Sheets + API docs
│ └── ixiflowerv2ray/ # Django project settings
├── start.sh # Quick start script
└── .env # Environment variables
The backend exposes 70+ API endpoints under:
/api/— Authentication, user management, working hours, Telegram, database/tickets/api/— Tasks, goals, submissions, reports, chat, notifications, files, configs, Google Sheets/admin/— Django admin panel
A full-featured Telegram bot (backend/planner-bot.py) with commands:
/reports— View daily reports/tasks— View assigned tasks/team— View team members/dollar— Current dollar price/gold— Current gold price/start— Welcome message/help— Command list
This project is MIT licensed.
⭐ If you found this project useful, please give it a star!
It took a lot of time and effort to build this project — your support means a lot ❤️
