🏢 Hero PM Helper

**P### 📋 Instant Task Management

• Live task tracking from HeroPM system
• Real-time project status updates with visual indicators
• Task details with project hierarchy showing main and sub-projects
• Time tracking information with start dates and times
• Status badges with color-coded indicators
• One-click task completion with integrated workflow

🤖 AI-Powered Activity Reports

• HERO AI integration for automatic activity descriptions
• Git change analysis to generate professional reports
• Smart content generation based on your development work
• Manual editing options for customizing AI-generated content

⚡ Advanced Task Completion

• Location-based work tracking (Office/Remote)
• Interactive completion forms with validation
• Automatic activity submission to PM API
• Real-time dashboard refresh after task completionional project management integration for VS Code developers**

Hero PM Helper brings powerful HeroPM project management capabilities directly into your VS Code environment. Seamlessly connect to your HeroHRM account, manage tasks, and complete activities with AI-powered assistance without leaving your development workspace.

✨ Key Features

🔐 Secure Authentication

• Direct HeroHRM login integration within VS Code
• JWT token management with automatic expiry handling
• Secure credential storage using VS Code's global state
• Smart re-authentication when tokens expire

📊 Real-time Dashboard

• Beautiful, theme-compatible dashboard that adapts to your VS Code theme
• User profile information display with avatar support
• Department and position details for complete context
• Professional card-style layout with modern design

📋 Instant Task Management

• Live task tracking from HeroPM system
• Real-time project status updates with visual indicators
• Task details with project hierarchy showing main and sub-projects
• Time tracking information with start dates and times
• Status badges with color-coded indicators
• One-click task completion with integrated workflow

🤖 AI-Powered Activity Reports

• HERO AI integration for automatic activity descriptions
• Git change analysis to generate professional reports
• Smart content generation based on your development work
• Manual editing options for customizing AI-generated content

⚡ Advanced Task Completion

• Location-based work tracking (Office/Remote)
• Interactive completion forms with validation
• Automatic activity submission to PM API
• Real-time dashboard refresh after task completion

🎯 Developer-Focused UI

• Dedicated activity bar panel for quick access
• Status bar integration with live user status
• Tree view navigation with expandable sections
• Responsive design following VS Code UI patterns
• Hover effects and smooth transitions

🔄 Smart Token Management

• Automatic token validation every 5 minutes
• Smart refresh prompts when tokens expire
• Seamless re-authentication workflow
• Secure logout with complete data cleanup

🚀 Quick Start

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "Hero PM Helper"
4. Click Install

First Use

1. Look for the HeroHRM icon in the activity bar (left sidebar)
2. Click the icon to open the Hero PM panel
3. Click "🔑 Giriş Yapın" to start the login process
4. Enter your credentials when prompted
5. Access your dashboard automatically after successful login

🎨 Interface Overview

Activity Bar Integration

📋 Explorer
🔍 Search  
🌿 Source Control
🐛 Debug
🧩 Extensions
🏢 Hero PM Helper  ← Your new panel!

Tree View Structure

🏢 HeroHRM
├── 👤 Your Name (expandable)
│   ├── 📧 your.email@company.com
│   ├── 🏷️ Your Role  
│   ├── 🏢 Department Name
│   └── 💼 Job Title
└── 🔧 İşlemler (expandable)
    ├── 📊 Dashboard Aç
    └── 🚪 Çıkış Yap

Dashboard Features

• Two-Column Layout: Separate cards for profile and tasks
• Profile Section: Avatar, name, email, department and position
• Active Tasks: Real-time task list with completion buttons
• Manual Refresh: One-click refresh button for latest data
• Task Completion Modal: Interactive forms for activity submission
• Location Selection: Office/Remote work location tracking
• AI Integration: Smart content generation for activity reports
• Modern Design: Responsive grid layout with animations

🎯 Task Completion Workflow

Complete a Task

1. Click "✅ Görevi Bitir" on any active task
2. Select Location: Choose between Office (Yerinde) or Remote (Uzaktan)
3. Add Activity Details:
   • Enter subject manually OR
   • Click "🤖 HERO AI ile Doldur" for AI-generated content
4. Submit: Click "✅ Görevi Bitir" to complete

AI Content Generation

• Automatic Analysis: AI analyzes your Git changes
• Smart Suggestions: Generates professional activity descriptions
• Editable Content: Modify AI suggestions before submission
• Fallback Mode: Works without API key (manual input only)

⚙️ Configuration

OpenAI API Key (Optional)

For AI-powered content generation:

1. Open VS Code Settings (Cmd+, / Ctrl+,)
2. Search for "herohrm"
3. Set your OpenAI API Key in herohrm.openaiApiKey

Note: AI features are optional. Task completion works without API key.

🛠 Requirements

• VS Code: Version 1.74.0 or higher
• HeroHRM Account: Active account with valid credentials
• Internet Connection: Required for API access and real-time updates
• OpenAI API Key (Optional): For AI-powered content generation

🎯 Task Completion Workflow

Complete a Task

1. Click "✅ Görevi Bitir" on any active task
2. Select Location: Choose between Office (Yerinde) or Remote (Uzaktan)
3. Add Activity Details:
   • Enter subject manually OR
   • Click "🤖 HERO AI ile Doldur" for AI-generated content
4. Submit: Click "✅ Görevi Bitir" to complete

AI Content Generation

• Automatic Analysis: AI analyzes your Git changes
• Smart Suggestions: Generates professional activity descriptions
• Editable Content: Modify AI suggestions before submission
• Fallback Mode: Works without API key (manual input only)

📱 Status Bar Integration

The extension provides three different status bar states:

🎯 Usage Scenarios

Daily Workflow Integration

• Morning: Check your active tasks directly in VS Code
• During Development: Monitor task progress without context switching
• Project Updates: Get real-time status updates on your assignments
• Time Tracking: View start times and duration information

Team Collaboration

• Project Visibility: See which projects you're currently assigned to
• Status Updates: Real-time task status with visual indicators
• Hierarchy Understanding: Clear project and sub-project relationships

🔒 Security & Privacy

Data Protection

• No password storage: Passwords are never saved or logged
• Secure token storage: JWT tokens stored in VS Code's encrypted global state
• HTTPS only: All API communications use secure connections
• Automatic cleanup: Complete data removal on logout or extension disable

Privacy Commitment

• No telemetry: We don't collect usage data
• Local storage only: All data stays on your machine
• No third-party sharing: Your information never leaves the HeroHRM ecosystem

🎯 Perfect For

• Software developers using AIF project management workflows
• Project managers tracking development tasks
• Development teams wanting integrated workflow management
• Professionals who prefer staying in their IDE environment
• Remote workers needing seamless project integration

🚀 Advanced Features

Smart Notifications

• Token expiration warnings with one-click renewal
• Automatic status updates without manual refresh
• Error handling with user-friendly messages

Performance Optimized

• Lightweight extension with minimal VS Code impact
• Efficient API calls with smart caching
• Responsive UI that adapts to VS Code themes

Developer Experience

• Command palette integration for keyboard shortcuts
• Consistent with VS Code design patterns
• Accessibility support for screen readers

🛠 Commands

Access these commands via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

• HeroHRM: Login - Start the authentication process
• HeroHRM: Show Dashboard - Open the main dashboard
• HeroHRM: Logout - Securely logout and clear data
• HeroHRM: Refresh - Refresh the tree view manually

📞 Support & Feedback

Getting Help

• Use VS Code's built-in extension feedback system
• Check the extension's output panel for diagnostic information
• Ensure your HeroHRM credentials are correct and account is active

Common Issues

• Login fails: Verify your credentials and internet connection
• Tasks not loading: Check if your account has task access permissions
• Token expired: Use the automatic refresh prompt or logout/login again

Contributing

This extension is developed and maintained by the AIF Digital Solutions team as part of the HeroHRM ecosystem.

Transform your development workflow with seamless HeroHRM integration!

Made with ❤️ by AIF Digital Solutions