📋 v2.5 Complete Guide + AI Enhancements

TaskManager Pro
Complete User Guide

Comprehensive checklist for testing all application features with detailed entry instructions and AI-powered enhancements

Overall Testing Progress 0%
0 / 115 tests completed
🔐

1. Authentication & Organizations

Setup Phase

User Login

📝 How to Create/Test:

  1. python manage.py createsuperuser - Create admin user
  2. Navigate to http://127.0.0.1:8000/login/
  3. Enter email: admin@example.com
  4. Enter password: ••••••••
  5. Click "Sign In"

Organization Setup

📝 How to Create:

  1. After login, click "Create New Organization" in switcher
  2. Name: Acme Corporation
  3. Slug: acme-corp (URL-friendly name)
  4. Click "Create Organization"
  5. Verify you're switched to new org automatically
👥

2. Team Management

Role Assignment

Team Members

📝 How to Add Team Members:

  1. Navigate to Team → Invite Member
  2. Email: manager@test.com
  3. Role: Manager
  4. Click "Send Invitation"
  5. Check email for invitation link (console in dev)
  6. Click link to accept invitation

Role Permissions

📝 How to Test:

  1. Log in with each test user
  2. Try to access different features
  3. Verify permissions match matrix below

📊 Role Permission Matrix

Permission Admin Manager Member Viewer
View Dashboard ✅ ✅ ✅ ✅
View Clients/Projects ✅ ✅ ✅ ✅
Create Clients/Projects ✅ ✅ ✅ ❌
Edit Clients/Projects ✅ ✅ ✅ ❌
Delete Clients/Projects ✅ ✅ ❌ ❌
View Team ✅ ✅ ❌ ❌
Invite Members ✅ ❌ ❌ ❌
👤

3. Client Management

CRUD Operations

Create & View Clients

📝 How to Create a Client:

  1. Navigate to Clients → Add New Client
  2. Company Name: Acme Corporation
  3. Contact Person: John Doe
  4. Email: john@acme.com
  5. Phone: (555) 123-4567
  6. Address: 123 Business Ave
  7. City: New York
  8. State: NY
  9. Zip: 10001
  10. Tax ID: 12-3456789
  11. Hourly Rate: 150
  12. Click "Save Client"

Edit & Delete Clients

📝 How to Edit/Delete:

  1. From client list, click Edit button
  2. Update any field (e.g., change phone number)
  3. Click Save Changes
  4. To delete, click Delete and confirm
✅ Data Isolation Test: Switch to Org B and verify "Acme Corporation" is not visible.
📁

4. Project Management

CRUD Operations

Create & View Projects

📝 How to Create a Project:

  1. Navigate to Projects → New Project
  2. Client: Acme Corporation (select from dropdown)
  3. Name: Website Redesign
  4. Description: Complete overhaul of company website
  5. Budget: 15000
  6. Start Date: 2024-01-15
  7. Deadline: 2024-03-30
  8. Status: Active
  9. Click "Create Project"

Edit & Delete Projects

📝 How to Edit/Delete:

  1. From project list, click Edit button
  2. Update budget or deadline
  3. Click Save Changes
  4. To delete, click Delete and confirm
✅

5. Task Management

With Time Tracking

Create Tasks

📝 How to Create a Task:

  1. Navigate to Tasks → New Task
  2. Project: Website Redesign
  3. Title: Design homepage mockup
  4. Description: Create 3 design concepts
  5. Priority: High (3)
  6. Status: To Do
  7. Deadline: 2024-02-01
  8. Estimated Hours: 8
  9. Click "Create Task"

Time Tracking

📝 How to Log Time:

  1. Open task detail page
  2. In "Time Entry" section, enter:
  3. Hours: 2.5
  4. Notes: Completed wireframes
  5. Click "Add Time"
  6. Repeat with different hours

Task Status Updates

📝 How to Update Status:

  1. From task list, click task to open
  2. Click "Mark In Progress"
  3. Later, click "Mark Complete"
  4. Verify task moves to completed

Edit & Delete Tasks

📝 How to Edit/Delete:

  1. From task list, click Edit button
  2. Update title or description
  3. Click Save Changes
  4. To delete, click Delete and confirm
💰

6. Invoice Management

Billing & Payments

Create Invoice from Tasks

📝 How to Create Invoice from Tasks:

  1. Navigate to Invoices → Create from Tasks
  2. Select Client: Acme Corporation
  3. Select Project: Website Redesign
  4. Check completed tasks (should auto-calculate hours)
  5. Issue Date: 2024-02-15
  6. Due Days: 30
  7. Tax Rate: 10 (if applicable)
  8. Add Notes if needed
  9. Click "Create Invoice"

Manual Invoice Creation

📝 How to Create Manual Invoice:

  1. Navigate to Invoices → New Invoice
  2. Select Client: Globex Inc
  3. Add line items (click "Add Item"):
  4. Item 1: "Consulting services", Qty 10, Rate $150
  5. Item 2: "Design work", Qty 5, Rate $200
  6. Set tax rate if needed
  7. Click "Save Invoice"

Invoice Actions

📝 How to Process Invoice:

  1. Open invoice detail page
  2. Click "Download PDF" - verify PDF generates
  3. Click "Send Email" - enter client email
  4. Click "Add Payment" to record payment
  5. Enter amount, date, method
  6. Click "Record Payment"

Invoice Filtering & Status

📝 How to Test:

  1. Go to invoice list page
  2. Use filters: Status, Client, Date Range
  3. Check overdue invoices highlighting
📊

7. Dashboard & Analytics

Reports & Insights + AI-Powered Features

Dashboard Overview

📝 What to Check:

  1. Navigate to Dashboard (home page)
  2. Verify organization banner shows current org
  3. Check summary cards for correct data
  4. Verify recent items show latest entries

Recent Activity

📝 How to Test:

  1. Create new client/project/task/invoice
  2. Return to dashboard
  3. Verify new items appear in recent lists

Charts & Analytics

📝 How to Test:

  1. Scroll to charts section
  2. Verify invoice chart shows correct distribution
  3. Verify task chart shows correct distribution
  4. Hover over charts to see tooltips

Quick Actions

📝 How to Test:

  1. Click each quick action button
  2. Verify it opens correct form

AI-Powered Insights AIValidate

📝 How to Test AI Features:

  1. Navigate to Dashboard and look for "AI Insights" panel
  2. Check for AI-generated task prioritization suggestions
  3. Look for smart deadline recommendations
  4. Review predictive analytics for project completion
  5. Check AI-powered time estimates based on historical data
🤖 AI Test Example: Create a task with a tight deadline, then verify AI suggests priority adjustment or deadline extension.

Predictive Analytics AIValidate

📝 How to Test Predictive Features:

  1. Go to Analytics section of Dashboard
  2. Look for "Projected Completion" charts
  3. Check "Revenue Forecast" based on current projects
  4. Review "Resource Allocation" predictions

Automated Invoice Generation AI

📝 How to Test AI Invoice Generation:

  1. Complete several tasks across different projects
  2. Navigate to Invoices section
  3. Look for "AI Suggested Invoices" or "Auto-generate Invoices" button
  4. Review AI-selected tasks for invoicing
📈

8. Advanced Analytics Dashboard

Complete Training Guide
📌 Purpose: This guide provides a comprehensive overview of the Advanced Analytics Dashboard, explaining all features, metrics, and how to leverage them for business intelligence and decision-making.

📍 Quick Navigation

1. 📈 Dashboard Overview

The Advanced Analytics Dashboard provides comprehensive business intelligence with real-time metrics, predictive analytics, and customizable reports. It's designed to give you actionable insights into your business performance, team productivity, and financial health.

Key Capabilities:

  • Real-time Metrics: Live updates of revenue, profit margins, and team productivity
  • Predictive Analytics: AI-powered forecasts for cash flow and project completion
  • Custom Reports: Build and save custom reports with drag-and-drop interface
  • Multi-format Export: Export to Excel, CSV, or PDF with one click
  • AI Insights: Smart recommendations for risk assessment and task prioritization

2. 🔑 How to Access

Main Dashboard URL: http://127.0.0.1:8000/analytics/
Admin Access: http://127.0.0.1:8000/admin/
Page URL Description
Analytics Home /analytics/ Main dashboard with key metrics and overview
Profitability /analytics/profitability/ Client and project profitability reports
Team Performance /analytics/team/ Individual and team productivity metrics
Cash Flow /analytics/cash-flow/ 90-day cash flow forecasts
Report Builder /analytics/builder/ Custom report creation and scheduling

3. 📊 Key Metrics Explained

Dashboard Metrics Overview

Metric Description Calculation Business Value
Total Revenue Sum of all paid invoices in the selected period SUM(invoice.total WHERE status='paid') Track income and growth trends
Profit Margin Percentage of revenue retained as profit (Revenue - Estimated Cost) / Revenue * 100 Measure business efficiency
Team Productivity Total tasks completed in period COUNT(tasks WHERE status='completed') Monitor team output and efficiency
Cash Flow Risk AI-predicted financial risk level Based on projected balances and overdue invoices Anticipate cash shortages
Outstanding Unpaid invoices total SUM(invoice.total WHERE status='pending') Track accounts receivable

4. 💰 Profitability Reports

Features:

  • By Client: View profitability breakdown per client
  • By Project: Analyze project-level profitability
  • Time Periods: Filter by custom date ranges
  • Visual Analytics: Bar charts and trend lines

Available Filters:

Filter Options Purpose
Date Range Custom, Last 30 days, This Month, Last Month, This Quarter, This Year Analyze specific time periods
Group By Client, Project, Month, Quarter View data from different angles
Client Filter Select specific clients Focus on key accounts
Project Filter Select specific projects Analyze individual projects
💡 Pro Tip: Use the "Group By Month" view to identify seasonal trends in your revenue. This helps with capacity planning and resource allocation.

5. 👥 Team Performance Dashboard

Metrics Tracked:

  • Tasks Completed: Individual and team task completion rates
  • Hours Logged: Total billable and non-billable hours
  • Revenue Generated: Direct revenue attributed to each team member
  • Effective Hourly Rate: Revenue / Hours logged
  • AI Accuracy: How often team accepts AI suggestions

Top Performers Section:

Automatically identifies and highlights top-performing team members based on:

  • Tasks completed (weight: 40%)
  • Revenue generated (weight: 35%)
  • AI acceptance rate (weight: 25%)
⚠️ Important: Revenue attribution requires tasks to be linked to invoice items. Ensure proper task-invoice linkage for accurate revenue tracking.

6. 💵 Cash Flow Forecasting

Forecast Periods:

Period What it Shows Use Case
30 Days Immediate cash position Short-term liquidity planning
60 Days Medium-term outlook Resource allocation and hiring
90 Days Long-term projection Strategic planning and investments

Risk Levels:

  • Low Risk - Positive balance across all periods
  • Medium Risk - Balance below $10,000 in any period
  • High Risk - Negative balance projected
📊 Data Sources:
  • Inflows: Pending and overdue invoices with due dates
  • Outflows: Estimated based on team size and fixed costs
  • Current Balance: Manual entry or linked bank account

7. 🔧 Custom Report Builder

Configuration Options:

Report Types:
  • Profitability Report: Financial performance by client/project
  • Team Report: Individual and team productivity metrics
  • Cash Flow Report: Daily cash flow details
  • Custom Report: Fully configurable with any combination
Available Metrics:
Category Metrics Available
Financial Revenue, Cost, Profit, Margin, Outstanding, Paid
Productivity Tasks Completed, Hours Logged, Tasks Per Day
AI Metrics AI Accuracy, Risk Score, Priority Score
Scheduling Options:
  • Daily: Receive report every morning
  • Weekly: Monday morning delivery
  • Monthly: 1st of each month
  • Quarterly: First day of quarter
💡 Pro Tip: Save frequently used report configurations. Scheduled reports can be automatically emailed to stakeholders.

8. 📥 Export Options

Available Formats:

Format Best For Features
Excel (.xlsx) Further analysis, pivot tables Formatted tables, formulas preserved, multiple sheets
CSV Data import, system integration Raw data, comma-separated, lightweight
PDF Presentations, client sharing Professional formatting, charts included, print-ready

Export Locations:

  • Download: Direct browser download
  • Email: Send to specified recipients (scheduled reports)
  • Save: Store in report library for later access

9. 🤖 AI Insights Integration

AI-Powered Features:

Task Risk Assessment:
  • Low Risk - Simple tasks, on track
  • Medium Risk - Some concerns, monitor closely
  • High Risk - Critical issues, immediate attention needed
Dashboard AI Widgets:
  • Tasks Analyzed: Total tasks with AI assessment
  • Urgent Tasks: Priority 4 tasks needing immediate action
  • High Risk: Tasks flagged as high risk
  • Need Attention: Urgent + High Risk tasks combined
🤔 How AI Risk is Calculated:

Risk score = (Complexity × 0.3) + (Dependencies × 0.3) + (Deadline Pressure × 0.4)

Where each factor is normalized to 1-10 scale.

10. ❓ FAQ & Troubleshooting

Common Issues and Solutions:

Issue Possible Cause Solution
Revenue shows $0 No paid invoices in selected period Check invoice statuses or expand date range
Team productivity shows 0 Tasks not marked as completed Update task statuses in task manager
Cash flow forecast shows zeros No invoices with due dates Ensure invoices have proper due dates
AI Insights show zeros Tasks haven't been analyzed Run AI analysis on tasks or wait for auto-analysis
Export fails Missing xlsxwriter library Run pip install xlsxwriter

Best Practices:

  • Regular Data Entry: Keep tasks, time entries, and invoices up to date
  • Set Realistic Deadlines: Accurate dates improve AI predictions
  • Review Weekly: Check dashboards every Monday for weekly planning
  • Export Key Reports: Save monthly reports for compliance and historical reference

🎯 Quick Reference Card

Dashboard URL: /analytics/
Default Login: admin@demo.com / admin123
Required Package: pip install xlsxwriter weasyprint
Key Models: Task, TimeEntry, Invoice, Client, Project
🔒

9. Data Isolation & Multi-tenancy

Critical Tests

Organization A Data

Organization B Data

URL Access Tests

🔗

10. Integrations

External Connections
📌 Purpose: TaskManager Pro integrates with external services to enhance functionality and eliminate double-entry. The Google Calendar integration automatically syncs your tasks and availability bidirectionally.

Google Calendar Integration

📝 How to Set Up:

  1. Navigate to Calendar → Google Calendar in the sidebar
  2. Click "Connect Google Calendar"
  3. Sign in with your Google account and grant permissions
  4. Configure sync settings:
    • Enable auto-sync (recommended: every 15 minutes)
    • Choose what to sync (tasks, project milestones, availability)
  5. Click "Save Settings"
✨ What Gets Synced:

⬆️ Push to Google Calendar:

  • Task deadlines appear as calendar events
  • Project milestones as all-day events
  • Automatic reminders (24h and 1h before)
  • Events are color-coded (green for tasks, purple for projects)

⬇️ Pull from Google Calendar:

  • Busy periods mark you as unavailable
  • Meetings affect resource allocation
  • Vacation/OOO blocks are respected
  • Team availability updates automatically
🧪 Test Case 1: Push Task to Google Calendar
  1. Create a task with a deadline (e.g., "Review Q1 Report" due tomorrow at 3 PM)
  2. Assign it to yourself (the user connected to Google Calendar)
  3. Wait for auto-sync (up to 15 minutes) OR click "Sync Now" in Calendar Settings
  4. Open Google Calendar at calendar.google.com
  5. Verify the task appears as an event with:
    • Title format: 📋 Review Q1 Report
    • Green color coding
    • Correct date and time (with 1-hour duration)
    • Description contains project and client details
Expected Result Task appears in Google Calendar within sync interval
🧪 Test Case 2: Pull Busy Status from Google Calendar
  1. Create an event in Google Calendar (e.g., "Client Meeting" tomorrow from 10 AM - 11 AM)
  2. Mark it as "Busy" (default setting)
  3. Wait for auto-sync OR click "Sync Now" in Calendar Settings
  4. In TaskManager, go to Team → Resource Allocation
  5. Check your availability during that time slot
  6. Verify you're marked as busy/unavailable
Expected Result Your calendar busy period blocks resource allocation in TaskManager
🧪 Test Case 3: Bidirectional Sync Validation
  1. Check Sync Logs at Calendar → Google Calendar → Settings
  2. Verify you see both "Push to Google" and "Pull from Google" entries
  3. Confirm the "Changes" column shows numbers (e.g., +1, ~2)
  4. Check the busy periods widget shows your upcoming meetings
Expected Result Sync logs show successful bidirectional sync with event counts
👥

11. Advanced Team Features

Collaboration & Planning
📌 Purpose: These features transform TaskManager from a solo tool into a powerful team collaboration platform, enabling efficient resource management, skill-based assignment, and real-time communication.

Resource Allocation Planning

📝 How to Use:

  1. Navigate to Team → Resource Allocation
  2. Click "Allocate Resource" to assign team members
  3. Select team member, project, and hours
  4. Set start/end dates and priority
  5. System automatically checks availability
✨ Key Functionality:
  • Availability Checking: Automatically warns if user is overallocated
  • Utilization Tracking: See percentage of team capacity used
  • Timeline View: Visual representation of allocations over time
  • Priority Levels: Critical, High, Medium, Low
  • Google Calendar Integration: Busy periods automatically block allocations

Skill-Based Task Assignment

📝 How to Use:

  1. Navigate to Team → Skill Matrix
  2. Click "Add Skill" to create new skills (e.g., Python, Design, Management)
  3. Assign skills to team members with proficiency levels:
    • 1 - Beginner
    • 2 - Elementary
    • 3 - Intermediate
    • 4 - Advanced
    • 5 - Expert
  4. Mark preferred skills for optimal task assignment
✨ Key Functionality:
  • Skill Matrix View: See all team skills in a comprehensive table
  • Proficiency Levels: Color-coded skill badges
  • Skill Gaps: Automatically identifies missing skills for projects
  • Distribution Chart: Visual breakdown of skills by category
  • Export: Download skill matrix as CSV

Activity Feed & Notifications

📝 How to Use:

  1. Navigate to Team → Activity Feed
  2. View all team activities in chronological order
  3. Use filters to see specific types (tasks, projects, invoices, team)
  4. Click on activity items to navigate to related records
  5. Check Team → Notifications for personal alerts
✨ Key Functionality:
  • Real-time Updates: Activities appear as they happen
  • Importance Levels: Critical, High, Medium, Low (color-coded)
  • Unread Indicators: Visual markers for new activities
  • Filtering: By type, date range, importance
  • Notifications: Personal alerts for assignments and mentions

📊 Team Features Summary

Feature Purpose Location
Resource Allocation Assign team members to projects, track capacity Team → Resource Allocation
Skill Matrix Track team skills, identify gaps, assign tasks by expertise Team → Skill Matrix
Activity Feed Real-time team activity tracking Team → Activity Feed
Notifications Personal alerts for assignments and updates Team → Notifications

🎯 Target Audience

TaskManager Pro is designed for professionals and teams who need to streamline their workflow from task creation to payment collection.

👤 Freelancers

  • Independent consultants
  • Creative professionals (designers, writers, developers)
  • Contractors managing multiple clients
  • Service providers with hourly or project-based billing

🏢 Small Agencies

  • Marketing & creative agencies
  • Web development shops
  • Consulting firms with 2-20 employees
  • Professional service providers

📊 Project Managers

  • Team leads managing multiple projects
  • Operations managers tracking time and budgets
  • Client account managers
  • Resource allocation planners

💰 Business Owners

  • Small business owners
  • Startup founders
  • Solopreneurs
  • Growing businesses needing structure

📋 Ideal Customer Profile

Team Size: 1-50 users
Annual Revenue: $50K - $10M
Industry: Professional Services, Creative, Tech, Consulting
Pain Points: Time tracking, billing accuracy, project visibility

✨ Key Benefits

What makes TaskManager Pro the ultimate solution for your business?

⏱️ Time Savings

Eliminate manual data entry and duplicate work across multiple tools.

60% less admin time 10+ hrs/week saved

💰 Increased Revenue

Never miss billable hours again with integrated time tracking and invoicing.

15% more billable hours 2x faster payment

📊 Better Visibility

Real-time dashboard shows exactly where your projects and money stand.

100% project visibility Real-time analytics

🤝 Team Collaboration

Role-based access control lets you work seamlessly with team members and clients.

4 role types Unlimited team members

🔒 Data Security

Multi-tenant architecture ensures complete data isolation between organizations.

100% data isolation Bank-level encryption

📈 Scalability

Grows with your business from solo freelancer to multi-team agency.

1-1000+ users Unlimited projects

🎯 Business Outcomes

Real results you can expect from implementing TaskManager Pro

40%
Faster Project Completion
Streamlined workflows and clear task priorities
99%
Billing Accuracy
Eliminate missed hours and billing errors
3x
Faster Invoicing
Generate invoices directly from completed tasks
100%
Data Visibility
Complete transparency across all projects
50%
Reduced Admin Work
Automated workflows eliminate manual processes
24/7
Access Anywhere
Cloud-based access from any device
ROI: 300%+ in first year

🚀 Next Phase: What's Coming

Exciting new features planned to make TaskManager Pro even more powerful

🤖 AI-Powered Features

  • AI task prioritization based on deadlines and project value
  • Smart deadline suggestions to balance workload
  • Automated invoice generation from completed tasks
  • Predictive analytics for project completion
  • AI-powered time estimates based on historical data
Now Available in Dashboard

📱 Mobile Apps

  • Native iOS and Android apps
  • Mobile time tracking with GPS
  • Quick invoice approval on the go
  • Push notifications for deadlines
  • Offline mode with sync
Coming Q4 2026

🔗 Calendar Integrations

  • Google Calendar integration for deadlines ✓ Completed
  • Outlook 365 integration
  • API access for custom integrations
Coming Q3 2026

📊 Advanced Analytics

  • Profitability reports by client/project
  • Team performance dashboards
  • Cash flow forecasting
  • Custom report builder
  • Export to Excel/PDF
Now Available in Analytics

💳 Online Payments

  • Stripe/PayPal integration
  • Automatic payment reminders
  • Recurring invoices for retainers
  • Online payment portal for clients
  • Multi-currency support
Coming Q4 2026

👥 Advanced Team Features

  • Team availability calendar ✓ Completed
  • Resource allocation planning ✓ Completed
  • Skill-based task assignment ✓ Completed
  • Activity feed and notifications ✓ Completed
Now Available in Team Section

Have a feature request? We'd love to hear from you!

🧪 Quick Test Data Setup

Run this in Django shell to create test users with different roles:

from core.models import Organization, TeamMember, User
from django.utils import timezone
import uuid

org = Organization.objects.first()
users = [
    {'email': 'admin@test.com', 'password': 'test123', 'role': 'admin'},
    {'email': 'manager@test.com', 'password': 'test123', 'role': 'manager'},
    {'email': 'member@test.com', 'password': 'test123', 'role': 'member'},
    {'email': 'viewer@test.com', 'password': 'test123', 'role': 'viewer'},
]

for user_data in users:
    user, created = User.objects.get_or_create(
        email=user_data['email'],
        defaults={'password': 'make_this_secure'}
    )
    if created:
        user.set_password(user_data['password'])
        user.save()

    TeamMember.objects.get_or_create(
        user=user,
        organization=org,
        defaults={'role': user_data['role'], 'is_active': True}
    )
    print(f"✅ Created {user_data['role']}: {user_data['email']}")

📝 Test Notes & Issues Found

TaskManager Pro - Complete Testing Guide v2.5 with AI Enhancements

✅ Pass | ❌ Fail | ⚠️ Needs Review

© 2026 SurgerPulse.org - All Rights Reserved