Skip to content

README.md

Latest commit

 

History

History
119 lines (99 loc) · 3.82 KB

README.md

File metadata and controls

119 lines (99 loc) · 3.82 KB

Intelligent Schedule Manager

AI-powered mobile-first app for smart task scheduling, habit tracking, and productivity management.

Tech Stack

Layer Technology
Frontend Flutter (Dart)
Backend Node.js + Express
Database Firebase Firestore
Auth JWT + bcrypt
AI Engine Python (Flask)

Project Structure

offtrack/
├── lib/                    # Flutter app
│   ├── main.dart
│   ├── models/             # Data models (User, Task, Habit, Schedule, Notification, Preference)
│   ├── screens/            # 11 app screens
│   ├── services/           # API & Auth services
│   └── theme/              # App dark theme
├── backend/                # Node.js API
│   ├── server.js           # Express server
│   ├── config/             # Firebase config
│   ├── controllers/        # Route handlers
│   ├── middleware/          # JWT auth & validation
│   ├── routes/             # API routes
│   └── .env                # Environment variables
├── ai_engine/              # Python AI scheduler
│   ├── app.py              # Flask server
│   ├── scheduler.py        # Scheduling algorithm
│   └── requirements.txt

Setup & Run

Prerequisites

  • Flutter SDK (3.11+)
  • Node.js (18+)
  • Python (3.9+)
  • Firebase project with Firestore enabled

1. Backend

cd backend
npm install
# Edit .env with your Firebase project ID and a strong JWT_SECRET
npm start
# Server runs on http://localhost:5000

2. AI Engine

cd ai_engine
pip install -r requirements.txt
python app.py
# AI Engine runs on http://localhost:5001

3. Flutter App

# From project root (offtrack/)
flutter pub get
flutter run

Note: For Android emulator, the API uses 10.0.2.2:5000. For web/iOS, change baseUrl in lib/services/api_service.dart to localhost:5000.

Environment Variables (backend/.env)

Variable Description Default
PORT Server port 5000
JWT_SECRET JWT signing secret dev_secret_key
FIREBASE_PROJECT_ID Firebase project ID intelligent-schedule-manager
AI_ENGINE_URL AI engine URL http://localhost:5001

API Endpoints

Method Endpoint Auth Description
POST /auth/register No Register user
POST /auth/login No Login
GET /tasks Yes List tasks
POST /tasks Yes Create task
PUT /tasks/:id Yes Update task
DELETE /tasks/:id Yes Delete task
POST /schedule/generate Yes AI-generate schedule
GET /schedule Yes Get schedule
POST /habits Yes Create habit
PUT /habits/:id Yes Update/complete habit
DELETE /habits/:id Yes Delete habit
GET /notifications Yes List notifications
POST /notifications Yes Create notification
PUT /notifications/:id/mark-read Yes Mark as read
DELETE /notifications/:id Yes Delete notification
POST /calendar/sync Yes Sync to Google Calendar
GET /preferences Yes Get preferences
PUT /preferences Yes Update preferences

Screens (11)

  1. Splash – Animated loading + auth check
  2. Login – Email/password auth
  3. Register – Name, email, password signup
  4. Dashboard – Today's schedule, tasks, habits, quick actions
  5. Task Management – CRUD tasks with priority/deadline
  6. Schedule – AI-generated timeline view
  7. Habit Tracking – Daily habits with streaks
  8. Calendar Sync – Google Calendar integration
  9. Notifications – Reminders management
  10. Help & Support – FAQ + contact
  11. Settings – Preferences, logout, about, terms