A comprehensive personal performance tracking web application that unifies career development, physical health, nutrition, daily productivity, and personal finance into a single intelligent dashboard.
- Overview
- Key Features
- Technical Architecture
- Database Schema
- API Endpoints
- Project Structure
- Setup & Installation
- Usage
- AI-Powered Task Suggestions
NERI Performance Tracker is a full-stack web application designed to help users track and improve across multiple dimensions of their life — from career skills and professional growth to physical health, nutrition, financial habits, and daily productivity. It provides a unified dashboard with real-time progress tracking, intelligent daily recommendations, interactive charts, and a calendar system.
The application leverages FastAPI as the backend framework for high-performance, async-capable API routing, SQLite for lightweight persistent storage, and the Google Gemini API for AI-powered personalized task suggestions based on the user's BMI metrics and career skill profile.
- Daily performance summary with combined completion percentages
- Interactive calendar with day-by-day progress heatmap (color-coded: green/amber/red)
- Quick reminder sticky notes with deadlines
- Motivational daily quotes fetched from an external API
- Day notes for journaling and reflection
- Personalized daily task checklists generated based on profession type and field of interest
- Support for multiple profession types: Student, Working Professional, Freelancer, and more
- Task CRUD operations with completion tracking
- Career development goals auto-synced daily via the Gemini API
- Progress percentage calculation combining core tasks and career goals
- BMI calculation with real-time status classification (Underweight / Normal / Overweight / Obese)
- Water intake tracking against personalized daily targets
- Protein intake monitoring with BMI-based target calculation
- Auto-generated daily nutrition checklist (breakfast, lunch, dinner, fruits)
- Rotating daily workout routines (Cardio, Leg Day, Chest & Triceps, etc.)
- Physical goal scheduling with deadlines and notes
- Detailed daily expense tracking and categorization
- Visual breakdown of spending (last 30 days) using an interactive Doughnut chart
- Add, review, and delete functionality for recent transactions
- Easy navigation across past and present dates to inspect historical spending habits
- Comprehensive editable profile: name, profession type, field of interest, degree, branch, institution, bio
- Distinct view and edit modes with "Edit Profile" toggle
- Support for Student and Working Professional profile variants
- Profile data drives personalized task generation across the entire app
- Month-at-a-glance view with daily completion dots
- Click any date to view historical performance data
- Past dates show frozen, read-only snapshots
- Future dates are blurred with "Future date" indicators
- Persistent day notes per date
┌────────────────────────────────────────────────────────────────────────┐
│ CLIENT (Browser) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Overview │ │Profession│ │ Physical │ │ Career │ │ Finance │ │
│ │ .html │ │ .html │ │ .html │ │ .html │ │ .html │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │ │
│ ┌────┴─────────────┴────────────┴─────────────┴────────────┴─────┐ │
│ │ Vanilla JS (script.js) & Chart.js │ │
│ │ fetch() API calls · DOM manipulation · Event mgmt │ │
│ └───────────────────────────┬────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────────┴────────────────────────────────────┐ │
│ │ CSS (style.css) — Dark Theme │ │
│ │ Glassmorphism · Animations · Responsive Layout │ │
│ └────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────┬──────────────────────────────────────┘
│ HTTP (JSON / Form POST)
┌─────────────────────────────────┴──────────────────────────────────────┐
│ SERVER (FastAPI + Jinja2) │
│ │
│ ┌───────────────────────────────────────────────────────────────┐ │
│ │ app.py (1800+ LOC) │ │
│ │ │ │
│ │ ┌─────────────┐ ┌──────────────┐ ┌─────────────────────┐ │ │
│ │ │ Auth │ │ Page Routes │ │ API Endpoints │ │ │
│ │ │ login │ │ /overview │ │ /api/tasks │ │ │
│ │ │ signup │ │ /profession │ │ /api/physical │ │ │
│ │ │ logout │ │ /physical │ │ /api/finance │ │ │
│ │ │ decorator │ │ /finance │ │ /api/calendar │ │ │
│ │ └─────────────┘ └──────────────┘ └─────────────────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────┐ │ │
│ │ │ Business Logic Layer │ │ │
│ │ │ • recalculate_daily_activity() │ │ │
│ │ │ • compute_nutrition_targets() │ │ │
│ │ │ • _generate_profession_checklist() │ │ │
│ │ │ • track_daily_finance() │ │ │
│ │ └────────────────────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────┐ ┌───────────────────────────────────────────┐ │
│ │ database.py │ │ Gemini API (External) │ │
│ │ get_db() │ │ AI-powered task & goal suggestions │ │
│ │ init_db() │ │ based on BMI + career skill profile │ │
│ └──────┬───────┘ └───────────────────────────────────────────┘ │
│ │ │
│ ┌──────┴────────────────────────────────────────────────────────┐ │
│ │ SQLite (neri.db) │ │
│ │ 13 Tables · Row-factory dict access · UNIQUE constraints │ │
│ └───────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────┘
| Layer | Technology | Purpose |
|---|---|---|
| Backend Framework | FastAPI | High-performance async web framework with automatic request validation |
| Templating | Jinja2 | Server-side HTML rendering with template inheritance (base.html) |
| Database | SQLite | Lightweight, file-based relational database (neri.db) |
| Frontend UI/Logic | Vanilla JS + CSS | No framework overhead; direct DOM manipulation with fetch() API |
| Data Visualization | Chart.js | Renders interactive breakdown doughnut charts for expenses |
| AI Integration | Google Gemini API | Intelligent, personalized task and goal suggestions |
| Auth | Session-based | SHA-256 password hashing with server-side session management |
The application uses 13 normalized tables in SQLite, including the new daily_finance table:
┌──────────────────┐ ┌───────────────────┐ ┌────────────────────┐
│ users │ │ tasks │ │ daily_finance │
│──────────────────│ │───────────────────│ │────────────────────│
│ id (PK) │◄──┐ │ id (PK) │ ┌──►│ id (PK) │
│ username │ ├──►│ user_id (FK) │ │ │ user_id (FK) │
│ password_hash │ │ │ title │ │ │ entry_date │
│ height │ │ │ task_date │ │ │ category │
│ weight │ │ │ is_completed │ │ │ amount │
│ bmi │ │ └───────────────────┘ │ │ notes │
└──────────────────┘ │ │ └────────────────────┘
│ ┌───────────────────┐ │
┌──────────────────┐ ├──►│ daily_physical │ │ ┌────────────────────┐
│ user_profiles │ │ │───────────────────│ │ │ profession_tasks │
│──────────────────│ │ │ user_id (FK) │ │ │────────────────────│
│ user_id (FK, UQ) │◄──┤ │ entry_date │ ├──►│ id (PK) │
│ full_name │ │ │ water_intake │ │ │ user_id (FK) │
│ profession_type │ │ │ protein_intake │ │ │ title │
│ bio │ │ └───────────────────┘ │ │ is_completed │
└──────────────────┘ │ │ └────────────────────┘
│ ┌───────────────────┐ │
┌──────────────────┐ ├──►│ daily_activity │ │ ┌────────────────────┐
│ reminders │ │ │───────────────────│ │ │nutrition_checklist │
│──────────────────│ │ │ user_id (FK) │ │ │────────────────────│
│ user_id (FK) │◄──┤ │ entry_date (UQ) │ ├──►│ user_id (FK) │
│ title │ │ │ total_points │ │ │ entry_date │
│ reminder_date │ │ │ day_note │ │ │ item_label │
└──────────────────┘ │ └───────────────────┘ │ └────────────────────┘
│ │
│ ┌───────────────────┐ │ ┌────────────────────┐
├──►│ physical_goals │ │ │scheduled_activities│
│ │───────────────────│ │ │────────────────────│
│ │ user_id (FK) │ └──►│ user_id (FK) │
│ │ goal_date │ │ activity_date │
│ │ goal_title │ │ activity_name │
│ └───────────────────┘ └────────────────────┘
| Method | Endpoint | Description |
|---|---|---|
GET |
/finance |
Finance tracking page dashboard |
GET |
/api/finance/data |
Retrieve 30-day grouped data or single date specifics |
POST |
/api/finance/add |
Logs a new expense item into the database |
POST |
/api/finance/delete |
Removes an expense transaction securely |
| Method | Endpoint | Description |
|---|---|---|
GET/POST |
/login |
User login with session creation |
GET/POST |
/signup |
New user registration |
GET |
/logout |
Session teardown and redirect |
| Method | Endpoint | Description |
|---|---|---|
GET |
/overview |
Main dashboard with daily summary |
GET |
/profession |
Profession task tracker |
GET |
/physical |
Physical health & nutrition tracker |
GET |
/career |
Career profile management |
GET |
/profile-setup |
Initial profile setup wizard |
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/tasks/add |
Create a new daily task |
POST |
/api/physical/update |
Update water/protein intake |
GET |
/api/calendar/month |
Get monthly activity data |
POST |
/api/profession/tasks/add |
Manage professional tasks |
Performance_Tracker phase 3/
│
├── app.py # Main application — routes, APIs, business logic
├── database.py # Database connection helper
├── schema.sql # Full database schema (13 tables)
│
├── templates/ # Jinja2 HTML templates
│ ├── base.html # Base layout with navbar, dark theme
│ ├── overview.html # Main dashboard
│ ├── profession.html # Profession tasks
│ ├── physical.html # Physical health
│ ├── career.html # Profile management
│ └── finance.html # Finance / Expense dashboard
│
├── static/
│ ├── css/style.css # Global stylesheet — dark mode, UI styling
│ └── js/script.js # Client-side API calls & interaction logic
│
└── requirements.txt # Environment spec
- Python 3.10 or higher
- pip (Python package manager)
git clone https://github.com/mukeshraj-2006/Performance-Tracker-Phase-03.git
cd Performance-Tracker-Phase-03pip install fastapi uvicorn jinja2 python-multipart requests# Set a custom secret key (defaults to 'dev_key_neri_dark_mode')
export SECRET_KEY="your-secret-key-here"
# Set your Gemini API key for AI-powered suggestions
export GEMINI_API_KEY="your-gemini-api-key"The database (neri.db) is automatically initialized on the first run using schema.sql.
uvicorn app:app --reload --port 5000The application will be available at http://localhost:5000
- Overview Dashboard — View daily summary metrics, calendar, and reminders.
- Profession — Tackle AI-generated career tasks and check off your skills-oriented routines.
- Physical — Maintain health streaks tracking calories, macros, and scheduled workout routines.
- Finance — Track daily expenses and review historical financial flows with interactive charts.
- Career — Setup personal profile details shaping all AI features.
NERI integrates with the Google Gemini API to provide intelligent, automated task and goal suggestions tailored to each user's unique profile:
┌────────────────────────┐
│ User Profile │
│ Profession | Metrics │
└──────────┬─────────────┘
▼
┌────────────────────────┐ ┌────────────────────────┐
│ Gemini Processing │─────►│ Generated Outputs │
└────────────────────────┘ │ 📋 Profession Tasks │
│ 🏋️ Health Goals │
│ 🎯 Career Goals │
└────────────────────────┘
- BMI-Aware Nutrition: Calculates daily protein and water targets logically scaling by body limits.
- Career-Skill Alignment: Generates specific tasks dynamically matching CS, Medical, Business, and varied pathways.
- Adaptive Loading: Limits and updates suggested checkboxes without duplicating daily routines.
Built with ❤️ by Mukesh Raj