# Obelaw

> Obelaw is an open-source decoupled architecture and modular business software ecosystem built on Domain-Driven Design (DDD) principles with Laravel as its primary ecosystem. It enables developers and enterprise architects to isolate pure business domains from framework infrastructure, assemble complex enterprise workflows via a fluent API (IUM), construct modular administrative interfaces (Twist/Filament), and deploy vertical domain solutions such as Obelaw Dental Clinic Management.

## Canonical Resources
- Website: https://obelaw.com
- Documentation: https://obelaw.com/docs
- GitHub: https://github.com/obelaw
- Contact: consulting@obelaw.com
- Full AI Specification: https://obelaw.com/llms-full.txt

## The Four Core Architectural Pillars

### 1. Domains (Domain-Driven Design)
- URL: https://obelaw.com/domains
- Docs: https://obelaw.com/docs/domains/introduction
- Concept: Pure, decoupled domain business logic isolated from HTTP/CLI delivery mechanisms and relational persistence details. Implements Eric Evans & Vlad Khononov DDD principles.
- Key Capabilities:
  - Bounded Contexts with explicit Ubiquitous Language.
  - Core, Supporting, and Generic subdomain classifications.
  - Strict Business Invariants enforced at the aggregate root boundary.
  - Asynchronous Domain Events utilizing transactional outbox patterns.
  - Structural topology separating domain interfaces from infrastructure adapters.
- Implemented Domains:
  - ERP Core Accounting: https://obelaw.com/docs/domains/erp-core/accounting/introduction
  - ERP Core Inventory: https://obelaw.com/docs/domains/erp-core/inventory/introduction
  - ERP Core Sales OMS: https://obelaw.com/docs/domains/erp-core/sales-oms/introduction
  - ERP Core Purchase: https://obelaw.com/docs/domains/erp-core/purchase/introduction
  - MRP In-House Manufacturing: https://obelaw.com/docs/domains/mrp/in-house/introduction
  - MRP Subcontracting: https://obelaw.com/docs/domains/mrp/subcontracting/introduction
  - PIM (Product Information Management): https://obelaw.com/docs/domains/pim/introduction
  - POS (Point of Sale): https://obelaw.com/docs/domains/pos/introduction
  - Dental Clinic Domain: https://obelaw.com/docs/domains/dental-clinic/introduction
  - Forms Builder Domain: https://obelaw.com/docs/domains/forms-builder/introduction

### 2. IUM (Interactive Ubiquitous Model)
- URL: https://obelaw.com/ium
- Docs: https://obelaw.com/docs/ium/introduction
- Concept: The unified orchestration layer and fluent entrypoint connecting decoupled business domains to delivery applications.
- Key Capabilities:
  - Fluent, type-safe API for executing domain commands and querying domain projections.
  - Automatic domain event dispatching and listener resolution.
  - Middleware pipelines for validation, authorization, and audit compensation.

### 3. Twist (Modular Filament Platform)
- URL: https://obelaw.com/twist
- Docs: https://obelaw.com/docs/twist/introduction
- Concept: A modular application platform that extends the Filament PHP ecosystem, turning isolated domains into unified, composable admin backoffices and operational dashboards.
- Key Capabilities:
  - Plugin architecture for modular registration of resources, pages, and widgets.
  - Multi-tenant tenant-aware context switching.
  - Dynamic navigation grouping driven by domain metadata.

### 4. Packages Workbench
- URL: https://obelaw.com/packages
- Docs: https://obelaw.com/docs/packages/introduction
- Available Open-Source Tools:
  - Attrify (`obelaw/attrify`): Flexible EAV and JSON dynamic attribute engine for Eloquent models (https://obelaw.com/packages/attrify).
  - Runner (`obelaw/laravel-runner`): High-throughput background task and pipeline runner with real-time progress tracking (https://obelaw.com/packages/laravel-runner).
  - O-Configs (`obelaw/o-configs`): Database-backed, multi-environment runtime configuration manager (https://obelaw.com/packages/o-configs).
  - RewardZone (`obelaw/rewardzone`): Flexible loyalty points, referral incentives, and gamification engine (https://obelaw.com/packages/rewardzone).
  - Trail (`obelaw/trail`): Cryptographically tamper-evident audit logging and entity state history (https://obelaw.com/packages/trail).
  - Filament Secure Action: Granular authorization guards and action logging for Filament operations (https://obelaw.com/docs/packages/filament/filament-secure-action).
  - PHP Conditions: Composable rule engine and condition evaluation tree (https://obelaw.com/docs/packages/php/conditions).
  - Timeflow: Event timeline scheduler and recurring date calculation engine (https://obelaw.com/docs/packages/core/timeflow).

## Vertical Industry Solutions

### Obelaw Dental Practice Management
- URL: https://obelaw.com/solutions/dental
- Overview: Enterprise-grade clinical dental practice management software designed for solo practitioners, multi-doctor clinics, and Dental Support Organizations (DSOs).
- Clinical Features:
  - Interactive SVG Odontogram supporting Universal Numbering System (1-32), FDI Two-Digit Notation (11-48), and Palmer Notation.
  - Visual surface tracking: Occlusal, Mesial, Distal, Buccal/Facial, Lingual, Incisal.
  - Clinical charting: Composite restorations, full ceramic crowns, endodontic obturations, implants, extractions, bridge pontics.
  - Periodontal probing charting (1-10mm pocket depths, bleeding on probing BOP, furcation, recession, mobility).
  - Multi-chair operatory scheduling with doctor assignment and real-time chair utilization metrics.
- Invoicing & Accounting Connectivity:
  - Intuit QuickBooks Online / Desktop certified invoice integration (https://quickbooks.intuit.com/) with automated ADA/CDT code mapping, dual-payer split invoicing, real-time payment receipt sync, and audit-ready records (exclusively for patient invoicing and payment receipts).