v0.9.3 - Internal Support & Feedback System

🚀 Version v0.9.3 — Internal Support & Feedback System

✨ Features

• Added a dedicated Help & Requests page for all user roles

• Employees, accountants, and owners can now:

  • Request new features
  • Suggest workflow changes
  • Report bugs/issues
  • Ask for operational help

• Admin receives and manages all submitted requests centrally

• Added full help_requests database table with:

  • user info
  • request type
  • title
  • description
  • status
  • admin notes
  • reviewer tracking
  • timestamps

• Added backend API routes:

  • GET /help-requests
  • POST /help-requests
  • PATCH /help-requests/:id/status
  • DELETE /help-requests/:id

• Added status workflow:

  • Open
  • Reviewed
  • Resolved
  • Closed

• Added request detail modal with:

  • full description
  • admin notes
  • submission timestamp

🛠 Improvements

• Integrated Help & Requests into role-based navigation
• Added role-specific visibility control
• Improved internal communication workflow between staff and admin
• Added dashboard metrics/stat cards for admin request monitoring

🐞 Bug Fixes

• Fixed broken JS caused by apostrophes inside select option strings
• Fixed isAdmin scope issue inside page title mappings
• Fixed incorrect Railway backend URL (mkaerp-production)
• Fixed silent request submission failures
• Restricted ticket visibility so only admin can view all submissions
• Owners, employees, and accountants now only see their own requests

⚠️ Known Issues

• No email notifications yet for newly submitted requests
• No attachment upload support inside requests currently
• No pagination/search for large ticket volumes yet

🔧 Next Steps

• Add image/file attachments for issue reporting
• Add admin notification alerts for new requests
• Add ticket priority levels and assignment system
• Add search and filtering for support requests

---

---

v0.9.2 - Notification System

v0.9.2 Release Notes 🚀

🔔 New Notification System

A complete real-time notification experience has been introduced across the ERP.

Added

• Notifications page for all users
• Live in-app notification engine
• Notification bell with unread badge
• Notification dropdown preview
• Mark as read functionality
• Category-based notification filters
• Search inside notifications

Live Activity Updates

Users now receive automatic notifications for:

• Invoice approvals/rejections
• Approval requests
• Product stock updates
• Expense actions
• System activities

Example:

• Employee submits invoice → Owner receives live notification
• Owner approves invoice → Employee instantly receives approval notification

---

📦 Live Product Stock Refresh

Products page now supports live stock monitoring.

Added

• Auto stock-change detection
• “Stock Updated” banner
• Reload button for instant refresh
• Smooth update handling for desktop + mobile

This prevents users from working with outdated stock data while multiple employees use the system simultaneously.

---

📱 Mobile Dashboard Improvements

Major responsive UI improvements added.

Improved

• Horizontal side scrolling for wide tables
• Better table responsiveness
• Fixed overflowing content
• Responsive spacing/padding
• Mobile-friendly layouts
• Improved button/input alignment
• Better chart responsiveness

Added

• overflow-x-auto support for tables/cards
• Better mobile readability
• Improved small-screen scaling

---

🗂️ Unified Navigation System

Desktop sidebar and mobile menu are now fully synchronized.

Fixed

• Missing pages in mobile sidebar
• Inconsistent navigation items
• Role-based mismatch issues

Added

• Shared navigation engine
• Notifications visible in all menus
• Approval counters in menus
• Notification badges in mobile + desktop nav

---

⚡ Live Sync Infrastructure

Improved multi-user system synchronization.

Added

• Background polling engine
• Automatic live updates every few seconds
• Real-time state refresh system
• Shared activity synchronization between users

---

🎨 UI/UX Improvements

Enhanced

• Cleaner mobile layouts
• Better card spacing
• Improved dashboard readability
• More modern notification styling
• Better responsive handling across devices

---

🛠 Backend Enhancements

Added

• /notifications API endpoint
• Notification targeting system
• User-specific notification support
• Audit log improvements
• Live update backend hooks

---

📌 Version

Release: v0.9.2
Codename: Live Sync Update

---

---

v0.9.1 - Performance & Reports Update

🚀 Version v0.9.1 — Performance & Visibility Update

✨ Sales Target System

• Introduced new Sales Targets Module for admins, owners, and accountants

• Added dedicated sales_targets database table for storing monthly employee targets

• Employee dashboards now show:

  • Individual sales vs target graphs
  • Monthly achievement percentages
  • Personal sales performance metrics

• Owner, admin, and accountant dashboards now display:

  • Combined team sales vs combined targets
  • Monthly employee performance overview

• Added full Sales Targets Management Page with:

  • Month/year target assignment
  • Achievement tracking
  • Per-employee breakdowns
  • 6-month performance charts

---

📊 Sales Report Exports

• Added Excel export support for:

  • Team sales reports
  • Monthly summaries
  • Employee-wise sales reports
  • Invoice-level sales breakdowns

• Added employee-only My Sales Page with:

  • Personal invoice history
  • Revenue metrics
  • Sales vs target analytics
  • Exportable personal sales reports

---

👥 Customer Management Improvements

• Customers are now linked and visible under assigned employees

• Employees can only view/export their own customers

• Owners, admins, and accountants can:

  • View all customers
  • Filter customers by employee
  • Search by customer name, phone, or product interest

• Added employee ownership indicators directly inside customer records

---

📁 Customer Export System

• Added Excel export support for customer records:

  • Employee exports contain only personal customer lists
  • Admin/owner exports support organization-wide customer exports

• Generated exports now include:

  • Customer details
  • Employee ownership
  • Product interest
  • Status summaries
  • Per-employee breakdown sheets

---

🛠 Dashboard & Reporting Enhancements

• Replaced static dashboard charts with real sales vs target analytics
• Added achievement-based color indicators across performance modules
• Improved operational visibility for management and employee performance tracking

---

---

---

v0.9 - Demand Tracker, Expenditure Evidence Updates, etc.

🚀 Version v0.9 — Operational Intelligence Update

✨ Features

• Added accountant authentication fallback for expenditures when proof images/documents cannot be attached

  • Accountant-in-charge name must now be entered to verify physical proof exists

---

📈 Demand Tracker System

• Introduced new Demand Tracker Page with dedicated database table

• Stores:

  • Customer name
  • Product ID
  • Product name
  • Required quantity

• Added workflow to convert demand entries directly into formal quotations

• Customer details from demand tracker now auto-fill quotation popup fields

• Demand entries are automatically removed once a formal quotation is generated

---

📊 VAT Report Enhancements

• VAT Report now includes all approved invoices grouped month-wise
• Improved visibility and aggregation of processed invoice totals within reports

---

📄 Invoice & Approval Improvements

• Employees can now view rejection reasons directly inside invoice detail view
• Added clearer invoice audit visibility for rejected submissions

---

🚨 Financial Risk Indicators

• Added dynamic invoice risk highlighting:

  • 🔴 Critical Red → Above 1000 OMR or discount above 15%
  • 🟡 Warning Yellow → Above 400 OMR or discount above 8%
  • 🟢 Normal Green → Below 400 OMR with 0–7% discount

---

📦 Inventory Visibility Controls

• Employees no longer see:

  • Product stock quantity
  • Product pricing
  • Product added timestamps

• Employees now see simplified inventory states:

  • In Stock
  • Low Stock
  • Out of Stock

• Owners, accountants, and admins retain full stock and pricing visibility

---

🛠 Backend & Workflow Improvements

• Added new demand_tracker database integration
• Improved quotation workflow automation from customer demand records
• Enhanced expenditure validation process for audit consistency

v0.8.5 - Stability Recovery Patch Update

🚀 Version v0.8.5 — Stability Recovery Patch

✨ Hotfix Release

• Resolved critical deployment failures caused by package.json dependency conflicts
• Removed duplicate dependency declarations causing Railway production build failures
• Fixed malformed package.json formatting issues blocking deployment pipeline
• Refactored backend structure by cleaning unused/commented server code
• Removed unnecessary nodemailer dependency temporarily to stabilize builds
• Restored successful Railway production deployments and GitHub Pages sync

---

🛠 Stability Improvements

• Improved dependency management consistency across frontend and backend environments
• Cleaned backend configuration for more reliable production startup behavior
• Reduced deployment instability caused by conflicting package states

---

🐞 Bug Fixes

• Fixed repeated production deployment failures on Railway
• Fixed duplicate dependencies causing package resolution conflicts
• Fixed invalid package formatting breaking deployment parsing
• Fixed backend startup inconsistencies after server restructuring

---

⚠️ Notes

• This is an emergency stabilization patch focused entirely on restoring deployment reliability and backend consistency after dependency-related failures.

v0.8 - VAT Report & Product Limit Page Improvements

🚀 Version v0.8

✨ Features

• Added VAT Report Page for owners and admins with yearly financial breakdowns

• Introduced monthly VAT analytics table with:

  • Invoice count
  • Subtotal
  • VAT collected
  • Gross revenue

• Added live yearly summary cards for:

  • Total invoices
  • Total VAT collected
  • Gross revenue

• Implemented automatic VAT back-calculation from invoice totals (Gross ÷ 1.05)

• Added export system generating .xlsx VAT reports with:

  • Monthly Summary sheet
  • Invoice Detail sheet

• VAT exports are now automatically logged in the audit system

• Added contextual VAT info banner for clearer financial understanding

---

📦 Inventory & Product Improvements

• Introduced Product Limits Page for owners and admins

• Added configurable reorder_threshold values per product

• Added live stock status badges:

  • ✓ OK
  • △ Below Threshold
  • ✕ Out of Stock

• Added inline threshold editing with protected Save/Cancel workflow

• Dashboard stock alerts now use real product thresholds instead of hardcoded values

• Invoice stock warnings now dynamically reflect actual configured limits

• Product threshold updates now appear in Audit Logs under product category

---

🖨 Invoice Reprint Protection

• Replaced instant “Print Again” with secure Reprint Confirmation Flow
• Added duplicate-document warning modal before reprinting invoices
• Reprint modal now supports editable LPO details before confirming
• Reprints now persist changes to database and local state
• Every reprint action is automatically audit logged under invoice category

---

🛠 Product Edit & Audit Enhancements

• Fixed product stock edits not persisting to backend database

• Added stock adjustment audit logging with:

  • Previous stock
  • New stock
  • Delta changes

• Added live stock delta preview during editing

• Improved success notifications for stock updates vs normal product edits

v0.7 - Product Threshold Creation

🚀 Version v0.7

✨ Features

• Added Product Limits Page for owners and admins to manage stock thresholds dynamically

• Introduced live product status indicators:

  • ✓ OK
  • △ Below Threshold
  • ✕ Out of Stock

• Added inline threshold editing with explicit Save / Cancel controls to prevent accidental changes

• Implemented threshold filtering (All / Below Threshold / OK)

• Added top-level inventory metrics:

  • Total Products
  • Below Threshold
  • No Threshold Set

• Dashboard stock alerts now use each product’s configured reorder_threshold instead of hardcoded values

• Invoice stock alerts now display real threshold-aware warnings during generation

• Added automatic audit logging for all threshold updates under product category

---

🖨 Reprint Protection System

• Replaced direct “Print Again” action with secure Reprint Confirmation Flow

• Added duplicate-document warning modal before reprinting invoices

• Reprint modal now displays:

  • Customer details
  • Invoice total
  • Editable LPO number & date

• Added dedicated “Confirm Reprint” action for intentional duplicate printing

• Reprint edits now persist to database and local state

• All reprints are automatically logged in audit trail under invoice category

---

🛠 Database Changes

ALTER TABLE products
ADD COLUMN IF NOT EXISTS reorder_threshold INTEGER DEFAULT 10;

v0.6 - User Logs & Admin Audit

🚀 Version v0.6

✨ Features

• Onboarding flow now guides users through features relevant to their role with step-by-step screens
• New users automatically marked as onboarded after completion (new_user = false)

---

📋 Audit Logging System

• Introduced centralized Audit Log System tracking:

  • Login & logout activity
  • Invoice creation, approval, rejection
  • Customer creation & edits
  • Product stock/price updates
  • Delivery scheduling & completion
  • Expenditure approvals/rejections

• Added dedicated Audit Log Page for admins featuring:

  • Search across actions, employees, and categories
  • Employee-based filtering
  • Category filtering
  • CSV export support
  • Detailed popup view for each event

---

🛠 Backend Additions

• Added /audit-log routes for inserting and retrieving audit events
• Added audit log database migration support
• Added optional cleanup endpoint for old logs

---

v0.5 - Smooth Onboarding

🚀 Version v0.5

✨ Features

• Added role-based onboarding system for new users after first login
• Help easier onboarding and feature usage

Role-specific onboarding includes:

• Employee → Home, Products, Invoice approvals, Customers
• Accountant → Products, Expenses, Approved Invoices, Delivery Management
• Owners → Invoice approvals, quotes, expenditure approvals, VIP services
• Admin → Users management and full audit access

---

v0.4 - Refreshed Mobile Navigation

🚀 Version v0.4

✨ Features

• Introduced role-based navigation system with tailored bottom navigation (max 4 items per role)

  • Employee → Home, Products, Invoice, Customers
  • Accountant → Home, Products, Expenses, Approved Invoices
  • Owner-specific views (e.g., approvals, quotes) based on user identity
  • Admin (Arya) → Home, Products, Users

• Added dynamic access control at UI level to restrict pages based on role/email

• Implemented hamburger menu (mobile topbar) with slide-in panel

• Built profile section inside menu (avatar, name, role, email)

• Added full-access navigation panel showing all allowed pages per user

• Integrated theme toggle and sign-out actions inside menu panel

• Enabled auto-close navigation behavior on menu item selection

---

🛠 Improvements

• Simplified navigation by reducing clutter to 4 primary actions per role
• Improved mobile UX with structured topbar + slide-in navigation
• Refined user flow by separating frequent actions (bottom nav) from full access (menu panel)
• Enhanced scalability for adding new roles and permissions

---