@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

``bash
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

$3

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

$3

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

$3

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

🎯 Tính năng chính

$3

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

$3

- 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

$3

- 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

$3

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

🛠️ Development

$3

`bash
git clone
cd components
yarn install
`

$3

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

$3

`bash
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.