Skip to content

Adix097/EentCo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

37 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

EentCo - Business Management Solution

A simple, responsive web-based dashboard for managing business operations, sales, labour, and daily summaries.

๐ŸŒ Live Demo: https://adix097.github.io/EentCo/

๐Ÿ“‹ Overview

EentCo is a lightweight business management application designed for small businesses to track customers, orders, sales, operations, labour, and generate summaries. The application features a clean interface with multiple pages for different business functions.

โœจ Features

๐Ÿ  Dashboard

  • Customer & Order Tracking: View total customers and orders with percentage changes
  • Monthly Sales Chart: Visual placeholder for sales trends
  • Monthly Target: Track daily earnings and progress
  • AI Insights: Get business recommendations (placeholder)
  • Recent Orders Table: View and filter recent orders
  • Statistics Toggle: Switch between monthly and yearly views

๐Ÿ’ฐ Sales

  • Add New Sale: Record buyer name, quantity, and total cost
  • Sales History: View all sales in a searchable table
  • Auto-dating: Sales are automatically timestamped

๐Ÿšš Operations

  • Status Tracking: Monitor operations in three states:
    • Pending (purple)
    • In Progress (beige)
    • Completed (green)
  • Quick Toggle: Click sections to cycle through statuses

๐Ÿ‘ท Labour

  • Labour Management: Add workers with role, age, and wages
  • Active Count: See total active labours and revenue
  • Status Toggle: Switch workers between Active/Inactive
  • Revenue Tracking: Automatic calculation of total wages

๐Ÿ“Š Summaries

  • Daily Metrics: View production, sales, workers, and revenue
  • Trend Visualization: Daily trend chart placeholder
  • PDF Export: Export summary data (demo functionality)

โš™๏ธ Settings

  • Language Options: Change application language
  • Profile Management: Update user preferences

๐Ÿš€ Getting Started

Option 1: Use Online (Recommended)

Simply visit https://adix097.github.io/EentCo/ in your browser!

  1. Enter any username and password on the login page
  2. Click "Login" to access the dashboard
  3. Start managing your business data

Option 2: Run Locally

  1. Clone or download the repository:

    git clone https://github.com/adix097/EentCo.git
    cd EentCo
  2. Open index.html in your web browser (double-click or right-click โ†’ Open with โ†’ Browser)

  3. Login: Enter any username and password (validation only checks if fields are filled)

  4. Start using: You'll be redirected to the dashboard

Prerequisites

  • A modern web browser (Chrome, Firefox, Safari, Edge)
  • No server or installation required!

๐Ÿ“ฑ How to Use

Navigation

Click sidebar menu items to switch between pages:

  • Dashboard
  • Sales
  • Operations
  • Labour
  • Summaries
  • Settings

Adding Data

Sales:

  1. Go to Sales page
  2. Fill in buyer name, quantity, and total cost
  3. Click "Add sale"

Labour:

  1. Go to Labour page
  2. Fill in role, age, and wages
  3. Click "Add labour"

Searching

  • Use the search bar in the navbar to filter any table on the current page

Mobile View

  • Click the hamburger menu (โ˜ฐ) to toggle the sidebar on small screens

๐Ÿ’พ Data Storage

The application uses browser localStorage to save your data:

  • Sales records
  • Labour information
  • Dashboard metrics
  • Active labour count and revenue

โš ๏ธ Important Notes:

  • Data persists only in the browser where you entered it
  • Clearing browser data will delete all records
  • Data doesn't sync between devices or browsers
  • Perfect for testing and demos, but consider a backend for production use

๐ŸŽจ Features Breakdown

Responsive Design

  • Desktop: Full sidebar with expanded layout
  • Tablet: Adjusted grid layouts
  • Mobile: Collapsible sidebar, stacked sections

Interactive Elements

  • Hover effects on buttons and cards
  • Smooth page transitions with fade-in animations
  • Dynamic table filtering
  • Status indicators with color coding

Demo Features (Placeholder)

Some features are demonstrations and show alerts:

  • Language change
  • Recent activity notifications
  • Profile picture upload
  • PDF export (logs to console)

๐Ÿ”ง Technical Details

Technologies Used

  • HTML5: Structure
  • CSS3: Styling with animations and responsive design
  • Vanilla JavaScript: All functionality (no frameworks)
  • Font Awesome 7.0.1: Icons
  • localStorage API: Data persistence
  • GitHub Pages: Hosting

Browser Compatibility

Browser Support
Chrome/Edge โœ… Fully supported
Firefox โœ… Fully supported
Safari โœ… Fully supported
Opera โœ… Fully supported
IE11 โŒ Not supported

๐Ÿ“‚ File Structure

EentCo/
โ”‚
โ”œโ”€โ”€ index.html          # Login page (entry point)
โ”œโ”€โ”€ home.html           # Main application dashboard
โ”œโ”€โ”€ style.css           # All styles and responsive design
โ”œโ”€โ”€ script.js           # Application logic and data handling
โ””โ”€โ”€ README.md           # This file

๐ŸŽฏ Default Data

The application comes with sample data:

  • 3,728 customers (โ†‘ 11.2%)
  • 5,359 orders (โ†“ 9.2%)
  • 2 active labours with โ‚น1,800 total revenue
  • Sample sales records
  • Sample recent orders
  • Daily production metrics

โš ๏ธ Limitations

  • No backend: Data is stored locally only (localStorage)
  • Single user: No multi-user support or real authentication
  • Demo features: Some buttons show alerts instead of full functionality
  • No data export: PDF export is placeholder functionality
  • Browser-specific: Data doesn't sync across devices or browsers
  • No data backup: Clearing browser data will delete everything

๐Ÿ”ฎ Future Enhancements

Potential features for future versions:

  • โœจ Real backend integration (Node.js, Firebase, etc.)
  • ๐Ÿ“ˆ Actual chart implementations (Chart.js or Recharts)
  • ๐Ÿ“„ Real PDF generation with jsPDF
  • ๐ŸŒ Multi-language support (i18n)
  • ๐Ÿ’พ Data export to CSV/Excel
  • ๐Ÿ” User authentication and authorization
  • โ˜๏ธ Cloud data sync
  • ๐Ÿ“Š Advanced analytics and reporting
  • ๐Ÿ”” Real-time notifications
  • ๐Ÿ“ฑ Progressive Web App (PWA) support

๐Ÿ’ก Tips

  • Backup your data: Take screenshots or export console logs periodically
  • Testing mode: Perfect for presentations and prototypes
  • Customization: Edit style.css to change colors and layouts
  • Development: Use browser DevTools (F12) to inspect and debug
  • Mobile testing: Test on actual devices or use browser responsive mode

๐Ÿ› Known Issues

  • localStorage has a 5-10MB limit depending on browser
  • No data validation on some input fields
  • Charts are placeholders and don't display real data
  • Toggle status feature in Operations may need page context

๐Ÿค Contributing

Found a bug or want to contribute?

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“ž Support

For issues or questions:

  1. Check browser console for errors (F12)
  2. Verify localStorage is enabled in browser settings
  3. Try clearing cache and reloading
  4. Open an issue on GitHub

๐Ÿ“„ License

This is a demo/educational project. Feel free to use and modify for your needs.

๐Ÿ™ Acknowledgments

  • Font Awesome for icons
  • GitHub Pages for free hosting
  • Modern web standards for making this possible without frameworks

Version: 1.0
Live URL: https://adix097.github.io/EentCo/
Repository: https://github.com/adix097/EentCo
Created for: Small business management and demonstration purposes

Made with โค๏ธ for small businesses

About

Business management solution for small and medium enterprises

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors