Ohada Lib 📈

A developer-friendly OHADA accounting library that transforms business events into type-safe journal entries, manages stock and expenses, and generates compliant financial reports.

🚀 Key Features

• ✅ OHADA Compliant: Strictly follows the SYSCOHADA "Golden Rule" (Invoice then Payment).
• 🛡️ Type-Safe: Built with TypeScript for maximum developer productivity and error prevention.
• 🌍 Multi-language: Full support for English and French translations out of the box.
• 📦 Modular Design: Specialized modules for Purchases, Sales, and Expenses.
• 🏗️ Automated Journal Entries: Generates accurate accounting records from simple business inputs.

📦 Installation

npm install @drcmind/ohada-lib
# or
yarn add @drcmind/ohada-lib

📖 Quick Start

import { Ohada } from '@drcmind/ohada-lib';

// Initialize the library
const ohada = new Ohada({ locale: 'en' });

// Record a purchase
const entries = ohada.recordPurchase({
  amount: 150000,
  label: 'Laptop for office',
  category: 'EQUIPMENT'
});

console.log(entries);
/*
Output: [
  {
    "type": "CONSTATATION",
    "lines": [
      { "account": "2441", "label": "Laptop for office", "debit": 150000, "credit": 0 },
      { "account": "4451", "label": "VAT on assets", "debit": 27000, "credit": 0 },
      { "account": "4812", "label": "Supplier", "debit": 0, "credit": 177000 }
    ],
    "isBalanced": true
  }
]
*/

📚 Documentation

For full documentation, visit https://Drc-Mind.github.io/ohda-lib/.

We cover:

• Getting Started
• Accounting Rules
• API Reference
• Internationalization

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your 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

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.

Built with ❤️ by Drc-Mind