@caominhhung1991/components

🚀 React Component Library - Thư viện components và utilities cho phát triển React applications nhanh chóng và hiệu quả.

📦 Cài đặt

npm install @caominhhung1991/components
# hoặc
yarn add @caominhhung1991/components

🏗️ Cấu trúc dự án

├── 📁 src/                    # Mã nguồn chính
│   ├── 📁 components/         # React components
│   ├── 📁 bussiness/          # Business logic modules
│   ├── 📁 services/           # Service functions & utilities
│   ├── 📁 interface/          # TypeScript interfaces & types
│   ├── 📁 stores/             # Redux stores
│   ├── 📁 utils/              # Utility functions & hooks
│   ├── 📁 locales/            # Đa ngôn ngữ
│   ├── 📁 providers/          # React context providers
│   └── 📁 routes/             # Routing configuration
├── 📁 example/                # Ví dụ sử dụng
├── 📁 stories/                # Storybook stories
├── 📁 test/                   # Test files
├── 📁 dist/                   # Distribution build
└── 📁 .github/                # GitHub workflows

🚀 Sử dụng nhanh

Import components

import { 
  Modal, 
  InputModal,
  activeSwitch,
  clickToActive 
} from '@caominhhung1991/components';

Import services

import {
  excelService,
  stringUtils,
  numberUtils,
  timeUtils
} from '@caominhhung1991/components';

Import business logic

import {
  PhieuBusiness,
  MatHangBusiness
} from '@caominhhung1991/components';

🎯 Tính năng chính

🧩 Components

• Modal System - Customizable modal components
• Input Controls - Advanced input components với validation
• Print Components - In ấn documents
• Interactive Elements - Switches, buttons, quantity controls

🔧 Services

• Excel Processing - Đọc/ghi Excel files
• Data Handling - Transform và validate data
• Form Utilities - Form management helpers
• Time/Date Utils - Comprehensive time handling
• Image Processing - Image manipulation utilities

🏢 Business Logic

• Document Management (Phieu) - Quản lý phiếu chứng từ
• Product Management (MatHang) - Quản lý mặt hàng
• Category System (NhomMatHang) - Hệ thống phân loại
• Detail Processing (PhieuChiTiet) - Xử lý chi tiết

🗄️ State Management

• Redux Toolkit - Modern Redux patterns
• Table State - Advanced table management
• Form State - Form state handling
• UI State - User interface preferences

🛠️ Development

Setup

git clone <repository>
cd components
yarn install

Development commands

yarn start          # Start development server
yarn build          # Build for production
yarn test           # Run tests
yarn lint           # Lint code
yarn storybook      # Start Storybook

Publish

yarn hung           # Version bump & publish

📚 Documentation

Mỗi thư mục có README riêng với documentation chi tiết:

• src/ - Source code overview
• src/components/ - React components
• src/services/ - Service layer
• src/bussiness/ - Business logic
• src/interface/ - TypeScript types
• src/stores/ - Redux stores
• example/ - Usage examples
• stories/ - Storybook stories
• test/ - Testing guide

🔨 Tech Stack

• React 17+ với TypeScript
• Ant Design - UI Framework
• Redux Toolkit - State management
• TSDX - Build tooling
• Jest - Testing framework
• Storybook - Component documentation

📄 License

MIT License - xem LICENSE file.

👨‍💻 Tác giả

Cao Minh Hưng - @caominhhung1991

🤝 Đóng góp

Contributions, issues và feature requests đều được chào đón!

📈 Version

Current version: 0.1.17

Xem CHANGELOG để biết thêm chi tiết về các phiên bản.