╔══════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                ║
║     ██╗   ██╗ ██████╗ ██████╗ ███████╗███╗   ██╗ ██████╗ ██╗███╗   ██╗    ║
║     ██║   ██║██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝ ██║████╗  ██║    ║
║     ██║   ██║██║   ██║██║  ██║█████╗  ██╔██╗ ██║██║  ███╗██║██╔██╗ ██║    ║
║     ╚██╗ ██╔╝██║   ██║██║  ██║██╔══╝  ██║╚██╗██║██║   ██║██║██║╚██╗██║    ║
║      ╚████╔╝ ╚██████╔╝██████╔╝███████╗██║ ╚████║╚██████╔╝██║██║ ╚████║    ║
║       ╚═══╝   ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝ ╚═════╝ ╚═╝╚═╝  ╚═══╝    ║
║                                                                                ║
║                🎭  Professional Assessment Platform  🎭                              ║
║                                                                                ║
╚══════════════════════════════════════════════════════════════════════════════════════╝

---

🎯 What is HumanOS?

HumanOS is a professional online assessment platform that provides comprehensive psychological, personality, career, and cognitive evaluations.

"Discover yourself through scientific assessments."

🎯 Project Positioning

HumanOS serves as a professional assessment platform for:

• 👤 Individuals - Self-discovery and personal development
• 🏢 Organizations - Talent assessment and team building
• 🎓 Educational Institutions - Student guidance and career planning
• 🏥 Healthcare - Psychological screening and mental health support

Key Philosophy

Principle	Description
🧠 Scientific Basis	All assessments based on validated psychological theories
📊 Comprehensive Analysis	Multi-dimensional evaluation with detailed insights
🎯 Three-Tier System	Basic, Advanced, and Professional versions for all needs
🔒 Privacy First	All data stored locally, complete privacy protection

---

✨ Key Features

Feature	Description	Status
🧠 Personality Assessments	MBTI, Big Five, Enneagram, and more	✅
💼 Career Evaluations	Holland Code, Leadership Style, Career Values	✅
💑 Relationship Tests	Attachment Style, Communication Style	✅
🎓 Cognitive Assessments	Learning Style, Critical Thinking, IQ Tests	✅
💪 Mental Health	Anxiety, Depression, EQ, Stress Management	✅
📊 Three-Tier System	Basic (10+ Q), Advanced (50%), Professional (100%)	✅
🎨 Modern UI	Beautiful, responsive, and accessible design	✅
📱 Cross-Platform	Works on desktop, tablet, and mobile	✅
🔒 Privacy Protected	All data stored locally, no server upload	✅
📈 Detailed Reports	Visual charts, personalized analysis, and recommendations	✅

---

🆕 Latest Update (v2.3.0)

🎉 Major Features

📊 Three-Tier Assessment System

• ✅ 基础版 (Basic) - 10+ questions, quick assessment
• ✅ 进阶版 (Advanced) - 50% of professional questions, balanced depth
• ✅ 专业版 (Professional) - Complete question bank, comprehensive analysis

🌐 Custom Domain Support

• ✅ Configured custom domain: humanos.dpdns.org
• ✅ Updated all meta tags and structured data
• ✅ Enhanced SEO with custom domain

📦 Deployment Package

• ✅ Created standalone deployment package (HumanOS-web-deploy)
• ✅ Ready-to-deploy static files
• ✅ Comprehensive deployment documentation

🎯 Enhanced Question Banks

Assessment	Basic	Advanced	Professional
MBTI	18 Q	47 Q	93 Q
Big Five	10 Q	25 Q	50 Q
EQ	10 Q	25 Q	50 Q
Holland	10 Q	25 Q	50 Q
Attachment	10 Q	25 Q	50 Q
SAS	10 Q	25 Q	50 Q
Political Ideology	12 Q	29 Q	60 Q

🔧 Technical Improvements

• ✅ Optimized build configuration for production
• ✅ Enhanced GitHub Actions deployment workflow
• ✅ Improved code splitting and lazy loading
• ✅ Updated dependencies to latest versions

---

Previous Update (v2.2.1)

🐛 Bug Fixes & Accessibility

Navigation & Interaction

• ✅ Fixed Navbar "测评" navigation path error
• ✅ Fixed Assessment back button not navigating properly
• ✅ Fixed Dashboard "View All Achievements" button missing functionality
• ✅ Improved Results share button with Web Share API support

Content Consistency

• ✅ Updated Home page content to reflect frontend framework showcase positioning
• ✅ Corrected version display to v2.2.1

♿ Accessibility Improvements

• ✅ Added type="button" to all interactive buttons
• ✅ Added aria-label to search input
• ✅ Added aria-label and aria-pressed to category filter buttons
• ✅ Added aria-label to delete buttons

🔧 Code Refactoring

• ✅ Refactored AssessmentCard3D component - reduced 60 lines of duplicate code
• ✅ Optimized bundle size: Home component 16.56KB → 14.94KB (-9.8%)

---

Previous Update (v2.2.0)

Major Improvements

🚀 Performance & Quality Optimization

• ✅ Code Quality: Removed 25+ unused imports and variables
• ✅ Performance: Implemented lazy loading for all routes
• ✅ SEO: Added Open Graph, Twitter Card, and structured data
• ✅ Accessibility: Enhanced ARIA labels and keyboard navigation
• ✅ Mobile: Optimized responsive design for all devices
• ✅ Type Safety: Zero TypeScript errors with strict mode
• ✅ Build: Optimized chunk splitting for faster loading

📚 Enhanced Question Banks

• MBTI Assessment: Expanded to 40 questions with optimized options
• Big Five (OCEAN): Comprehensive 20-question personality profile
• Career Assessments: Holland Code + Leadership Style tests
• Relationship Tests: Attachment Style + Communication Style
• Cognitive Evaluations: Learning Style + Critical Thinking
• Health & Wellness: Stress Management + Creativity Potential

🔧 Quality Fixes

• ✅ Eliminated repetitive questions and options across all assessments
• ✅ Fixed display issues for previously broken question banks
• ✅ Added detailed, personalized result analysis for every test
• ✅ Ensured theme-specific feedback (no more mixed/confused analysis)
• ✅ Improved score calculation algorithms for accuracy

🎯 New Assessment Categories

Category	Tests	Questions/Test	Key Features
🧠 Personality	MBTI, Big Five, Anxiety, EQ	20-40	Trait analysis, career suggestions
💼 Career	Holland Code, Leadership	12-15	RIASEC model, leadership profiles
💑 Relationships	Attachment, Communication	8-10	Adult attachment theory, comm styles
🎓 Cognitive	Learning Style, Critical Thinking	5-8	VARK model, bias detection
💪 Wellness	Stress Management, Creativity	5-8	Coping strategies, innovation tips

---

🎨 Use Cases

HumanOS can be used for:

• 👤 Personal Development - Self-discovery, career planning, relationship improvement
• 🏢 Organizations - Talent assessment, team building, employee development
• 🎓 Education - Student guidance, career counseling, learning style assessment
• 🏥 Healthcare - Psychological screening, mental health support, patient assessment
• 🔬 Research - Data collection, psychological studies, behavioral analysis

Quick Start

1. Choose Assessment - Browse categories and select a test
2. Select Version - Basic, Advanced, or Professional
3. Complete Questions - Answer honestly for accurate results
4. View Results - Get detailed analysis and recommendations
5. Save & Share - Export or share your results

📖 See User Guide for detailed instructions

---

🚀 Quick Start

Requirements

• Node.js >= 18.0.0
• npm >= 9.0.0 or pnpm >= 8.0.0

Installation

# Clone repository
git clone https://github.com/badhope/HumanOS.git

# Navigate to directory
cd HumanOS

# Install dependencies
npm install
# or
pnpm install

Development

# Start dev server
npm run dev

# Open http://localhost:5173

Build

# Production build
npm run build

# Preview build
npm run preview

Deployment

# Deploy to GitHub Pages (automatic via GitHub Actions)
git push origin main

# Or use the deployment package
# Upload HumanOS-web-deploy folder to any web server

Live Demo

• Custom Domain: https://humanos.dpdns.org/
• GitHub Pages: https://badhope.github.io/HumanOS/

Code Quality

# Run ESLint
npm run lint

# TypeScript check
npm run typecheck

---

🛠️ Tech Stack

Core Frameworks

• React 18 - UI library
• TypeScript 5 - Type safety
• Vite 5 - Next-gen build tool

UI & Styling

• Tailwind CSS - Atomic CSS framework
• Framer Motion - Animation library
• Lucide Icons - Icon library

State Management

• Zustand - Lightweight state management

3D Effects

• Three.js - 3D rendering
• React Three Fiber - React 3D renderer

Tools

• ESLint - Code linting
• Prettier - Code formatting
• PostCSS - CSS post-processing

---

🎨 Animation System

HumanOS features a complete animation system:

Page Transitions

• Fade In/Out
• Slide
• 3D Flip
• Zoom

Interactive Animations

Component	Effect
GlowCard	Hover glow effect
RippleButton	Click ripple animation
AnimatedNumber	Number scroll animation
AnimatedProgress	Progress bar animation

Scene Animations

Component	Description
SplashScreen	Loading animation
ResultReveal	Result reveal effect
AchievementUnlock	Achievement unlock animation

Animation Configuration

import { pageVariants, cardVariants } from '@utils/animation-config'
import { GlowCard, RippleButton, FadeInSection } from '@components/animations'

---

📂 Project Structure

HumanOS/
├── .github/
│   ├── workflows/          # CI/CD pipelines
│   └── ISSUE_TEMPLATE/     # Issue templates
├── public/                 # Static assets
├── src/
│   ├── components/        # React components
│   │   ├── animations/    # Animation components
│   │   ├── AssessmentCard3D.tsx
│   │   ├── PersonalityRadar.tsx
│   │   └── ...
│   ├── data/             # Assessment data
│   ├── pages/            # Page components
│   ├── store/            # State management
│   ├── types/            # TypeScript types
│   ├── utils/            # Utilities
│   ├── App.tsx           # App entry
│   └── main.tsx          # Render entry
├── CHANGELOG.md           # Changelog
├── CODE_OF_CONDUCT.md     # Code of conduct
├── CONTRIBUTING.md        # Contributing guide
├── LICENSE               # CC BY-NC 4.0
├── README.md             # Chinese docs
├── README_EN.md          # English docs
├── SECURITY.md           # Security policy
├── package.json
├── tailwind.config.js
├── tsconfig.json
└── vite.config.ts

---

🎯 How Assessments Work

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Assessment Flow                                      │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  1️⃣  Choose Assessment                                                        │
│      └─► Browse 6+ categories, 20+ assessments                                 │
│                                                                              │
│  2️⃣  Select Version                                                           │
│      └─► Basic (10+ Q), Advanced (50%), Professional (100%)                   │
│                                                                              │
│  3️⃣  Complete Questions                                                       │
│      └─► Answer honestly, track progress                                       │
│                                                                              │
│  4️⃣  Calculate Results                                                        │
│      └─► Scientific algorithms, multi-dimensional analysis                     │
│                                                                              │
│  5️⃣  View Report                                                              │
│      └─► Visual charts, detailed insights, recommendations                     │
│                                                                              │
│  6️⃣  Save & Share                                                             │
│      └─► Local storage, export PDF, share results                              │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

---

🤝 Contributing

We welcome contributions! Please read CONTRIBUTING.md.

Ways to Contribute

1. 🍴 Fork this repository
2. 🌿 Create feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to branch (git push origin feature/AmazingFeature)
5. 🎉 Open Pull Request

Development Standards

• Follow Conventional Commits
• Pass ESLint and TypeScript checks
• Add tests for new features
• Update documentation

---

📄 License

This project is licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

You are free to:

• ✅ Share — copy and redistribute the material
• ✅ Adapt — remix, transform, and build upon the material

Under the following terms:

• ⚠️ Attribution — Give appropriate credit
• ⚠️ NonCommercial — You may not use the material for commercial purposes

See LICENSE for details.

---

🙏 Acknowledgments

Scientific Foundation

• Psychological assessment theories and validated instruments
• Research in personality psychology and behavioral science

Open Source Projects

• React - UI framework
• Vite - Build tool
• Tailwind CSS - Styling
• Framer Motion - Animations
• Recharts - Data visualization

Special Thanks

Thanks to all contributors and the psychological assessment community!

---

🚀 Future Roadmap

Platform Expansion

HumanOS is evolving into a comprehensive assessment ecosystem:

📱 Upcoming Features

Feature	Description	Status
🌍 Multi-language Support	i18n for global users	🔬 Planning
📊 Advanced Analytics	AI-powered insights and trends	🔬 Planning
🤝 Team Assessments	Group evaluation and comparison	🔬 Planning
📱 Mobile App	Native iOS and Android apps	🔬 Planning
🔗 API Access	RESTful API for integration	🔬 Planning
🏆 Certification System	Verified assessment certificates	🔬 Planning

🎯 Assessment Expansion

Category	New Tests	Timeline
Personality	DISC, StrengthsFinder, VIA Character	Q2 2026
Career	Skills Assessment, Job Fit, Work Values	Q2 2026
Cognitive	Memory Tests, Attention Span, Problem Solving	Q3 2026
Health	Sleep Quality, Burnout Risk, Resilience	Q3 2026
Education	Study Skills, Academic Motivation, Test Anxiety	Q4 2026

🔧 Technical Improvements

• AI Integration - Personalized recommendations and insights
• Cloud Sync - Cross-device data synchronization
• Offline Mode - Complete assessments without internet
• Export Options - PDF reports, data export, integration APIs
• Accessibility - Enhanced support for users with disabilities

🤝 Partnership Opportunities

We're actively seeking partnerships with:

• 🏢 Organizations - Custom assessment solutions
• 🎓 Educational Institutions - Curriculum integration
• 🏥 Healthcare Providers - Clinical assessment tools
• 🔬 Research Institutions - Collaborative studies

For partnership inquiries: contact@humanos.dev

---

📞 Support

Channel	Link
🐛 Bug Reports	GitHub Issues
💬 Discussions	GitHub Discussions
📖 Wiki	GitHub Wiki

---

⭐ If this project helps you, please give it a star! ⭐

Made with ❤️ by HumanOS Team

---

Home • Releases • Issues • Discussions

---