AHT KPI Management System

A modern, professional PHP-based management system with a beautiful Light Theme design, smooth animations, and clean architecture.

🌟 Features

🎨 Professional Light Theme - Clean, bright, corporate-friendly
✨ Smooth Animations - Count-up effects, hover animations, transitions
🏗️ Modular Architecture - Easy to extend and maintain
🔐 Secure Authentication - Password hashing, session management
📊 Beautiful Dashboard - Stats cards, data tables, modern UI
🔗 Clean URLs - SEO-friendly routing
📱 Responsive Design - Works on all devices
💼 Enterprise-Ready - Professional quality for business use

🚀 Quick Start

1. Start the server

cd"/Users/hyuncao/AHT KPI"
php -S localhost:8000 router.php

Or use the script:

./start-server.sh

2. Access the application

Open browser: http://localhost:8000/login

3. Login

Username:admin
Password:@admin123

⚠️Change the default password after first login!

📁 Project Structure

AHT KPI/
├── index.php # Main entry point
├── router.php # Router for PHP built-in server
├── .htaccess # Apache configuration (production)
├── README.md # This file
├── START.md # Quick start guide
├── CHANGELOG.md # Version history
├── config/ # Configuration files
│ ├── config.php # Database & app config
│ ├── config.example.php # Config template
│ └── database.sql # Database schema
├── assets/ # Static assets
│ ├── css/ # Stylesheets (Light theme)
│ │ ├── style.css # Login page
│ │ └── dashboard.css # Dashboard
│ ├── js/ # JavaScript
│ │ ├── script.js # Login page
│ │ └── dashboard.js # Dashboard animations
│ └── images/ # Image assets
├── modules/ # Feature modules
│ ├── auth/ # Authentication
│ │ ├── login.php # Login page
│ │ └── logout.php # Logout handler
│ └── dashboard/ # Dashboard
│ └── dashboard.php # Main dashboard
├── includes/ # Reusable components
│ └── url_helper.php # URL helper functions
└── public/ # Public files

🎨 Design - Professional Light Theme

Color Palette

Background:

#ffffff - Pure white (cards)
#f8fafc - Light gray (background)
#f1f5f9 - Subtle gray

Text:

#0f172a - Dark (primary)
#64748b - Medium gray (secondary)
#94a3b8 - Light gray (tertiary)

Primary Colors:

#2563eb - Professional blue
#7c3aed - Purple accent
#06b6d4 - Cyan highlight

Status Colors:

#10b981 - Success green
#ef4444 - Error red
#f59e0b - Warning orange

Design Principles

✅ Clean & Minimal - White backgrounds, subtle borders, soft shadows ✅ Professional - Corporate blue palette, consistent spacing ✅ Modern - Gradient accents, smooth animations, rounded corners ✅ Accessible - High contrast text, clear focus states, readable fonts

✨ Animations & Effects

Count-up numbers - Stats animate from 0 to final value
Fade-in cards - Elements appear smoothly on scroll
Hover effects - Cards lift, icons rotate, smooth transitions
Ripple clicks - Material design ripple effect on buttons
Icon animations - Scale and rotate on hover
Mobile menu - Smooth slide-in sidebar

🔗 Available URLs

URL	Description
`/`	Home (redirects to login/dashboard)
`/login`	Login page
`/dashboard`	Dashboard
`/logout`	Logout

⚙️ Installation

Prerequisites

PHP 7.4 or higher
MySQL 5.7 or higher
Web browser

Setup Steps

Configure database

Create MySQL database and import schema:

mysql -u your_username -p your_database < config/database.sql

Update configuration

Edit config/config.php:

define('DB_HOST', 'localhost');
define('DB_USER', 'your_username');
define('DB_PASS', 'your_password');
define('DB_NAME', 'your_database');

Start server
```
php -S localhost:8000 router.php
```
Access application
Open: http://localhost:8000/login

🛠️ Development vs Production

Development (PHP Built-in Server)

php -S localhost:8000 router.php

✅ Quick setup, no Apache needed
✅ Uses router.php for clean URLs
❌ Not suitable for production

Production (Apache Server)

Copy to web directory:
```
sudo cp -r "AHT KPI" /var/www/html/
```

Enable mod_rewrite:

sudo a2enmod rewrite
sudo service apache2 restart

Access: http://yourdomain.com/AHT%20KPI/

✅ High performance
✅ Uses .htaccess for clean URLs
✅ Production ready

🔧 Adding New Modules

1. Create module directory

mkdir -p modules/your_module

2. Create module file

modules/your_module/index.php:

<?phprequire_once__DIR__ . '/../../config/config.php';
if (!isset($_SESSION['user_id'])) {
header("Location: /login");
exit();
}
?>
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="/assets/css/dashboard.css">
</head>
<body>
<h1>Your Module</h1>
</body>
</html>

3. Add route

In router.php:

'/your-module' => 'modules/your_module/index.php',

In .htaccess (for Apache):

RewriteRule^your-module/?$modules/your_module/index.php [L]

4. Access

http://localhost:8000/your-module

🐛 Troubleshooting

Port already in use

kill -9 $(lsof -ti:8000)# Or use different port
php -S localhost:8001 router.php

ERR_TOO_MANY_REDIRECTS

Clear browser cookies (F12 → Application → Cookies → Clear)
Or use Incognito mode
Restart server

CSS/JS not loading

# Check if server is running
lsof -ti:8000
# If not, start server
php -S localhost:8000 router.php

Database connection error

Check MySQL is running
Verify credentials in config/config.php
Ensure database exists and schema is imported

📝 Default Credentials

Admin Account:

Username: admin
Password: @admin123

⚠️Important: Change immediately after first login!

🔒 Security Features

✅ Password hashing with password_hash()
✅ SQL injection prevention (prepared statements)
✅ Session management
✅ XSS protection (htmlspecialchars())
✅ Directory browsing disabled
✅ Config directory protected
⚠️ Add CSRF protection (recommended)

📚 Technology Stack

Backend: PHP 7.4+
Database: MySQL 5.7+
Frontend: HTML5, CSS3, Vanilla JavaScript
Design: Professional Light Theme
Fonts: Inter (Google Fonts)

💼 Perfect For

✅ Corporate environments
✅ Professional dashboards
✅ Business applications
✅ Data visualization
✅ Admin panels
✅ Management systems

📄 Documentation

README.md - This file (complete documentation)
START.md - Quick start guide
CHANGELOG.md - Version history

💡 Quick Commands

# Start server
php -S localhost:8000 router.php
# Kill server on port 8000kill -9 $(lsof -ti:8000)# Import database
mysql -u root -p your_database < config/database.sql
# Check if server is running
lsof -ti:8000

📊 What's New in v2.0

Light Theme

✨ Professional light color scheme
🌟 Bright, clean interface
💼 Corporate-friendly design
📝 High readability

Enhanced Animations

✨ Count-up effect for numbers
✨ Fade-in animations on scroll
✨ Hover effects with 3D transforms
✨ Ripple effect on clicks
✨ Icon scale & rotate animations

Improved UX

✨ Smooth transitions everywhere
✨ Mobile menu with animations
✨ Better responsive design
✨ Professional quality

📄 License

👥 Support

For support, please contact the development team.

Version: 2.0.0 (Light Theme)
Last Updated: February 12, 2026
Developed by: ArrowHitech

Happy coding! 🎉

Name		Name	Last commit message	Last commit date
api		api
assets		assets
backups		backups
config		config
cron		cron
docs		docs
fonts		fonts
includes		includes
libs		libs
modules		modules
public		public
scratch		scratch
uploads/hrm		uploads/hrm
vendor		vendor
.gitignore		.gitignore
.htaccess		.htaccess
Archive.zip		Archive.zip
CHANGELOG.md		CHANGELOG.md
README.md		README.md
START.md		START.md
SUMMARY.txt		SUMMARY.txt
api_debug_budget.json		api_debug_budget.json
api_debug_overview.json		api_debug_overview.json
api_debug_pos_error.txt		api_debug_pos_error.txt
composer.json		composer.json
composer.lock		composer.lock
comprehensive_fix.php		comprehensive_fix.php
database_export.sql		database_export.sql
db_alter.php		db_alter.php
db_webauthn_migration.php		db_webauthn_migration.php
debug_folio_2068.json		debug_folio_2068.json
debug_radar_out.html		debug_radar_out.html
dump_hrm.php		dump_hrm.php
fix_budget_large_values.php		fix_budget_large_values.php
generate_import.php		generate_import.php
import_candidate_sources.php		import_candidate_sources.php
import_data_to_live.php		import_data_to_live.php
import_hrm.php		import_hrm.php
import_offices.php		import_offices.php
index.php		index.php
install_budget.php		install_budget.php
migrate_docs.php		migrate_docs.php
read_prompts.php		read_prompts.php
router.php		router.php
run_import.php		run_import.php
setup_presale_db.php		setup_presale_db.php
update_db.php		update_db.php
update_folio_db.php		update_folio_db.php
update_stage_screening.php		update_stage_screening.php
update_users_kpi_permission.php		update_users_kpi_permission.php
yolov8n.pt		yolov8n.pt

Latest commit

History

Folders and files

Repository files navigation