Project Overview

ERPdash is a modular enterprise ERP system designed for single company deployment with scalable architecture for future multi-company support.

🎯 Core Goals

Enterprise-grade financial integrity

Modular expansion (Sales → Inventory → Finance → HR)

Strong RBAC (Role Based Access Control)

Audit-ready architecture

Quarterly financial periods

Immutable financial posting

🏗 SYSTEM ARCHITECTURE
Folder Structure
app/
├── Models/
│     ├── Core/
│     ├── Finance/
│     ├── Sales/
│     ├── Inventory/
│     └── HR/
│
├── Http/
│     ├── Controllers/
│     ├── Requests/
│
├── Services/
│     ├── Core/
│     ├── Finance/
│     │     ├── Posting/
│     │     └── Reports/
│
├── Policies/
└── DTO/
📦 MODULE ROADMAP
🧩 M1 — Core
Branches

code

name

is_active

Settings

system settings

branch settings

Number Sequences

Document numbering

LockForUpdate

💰 M2 — Finance Foundation
Accounts

Hierarchical chart of accounts

Parent-child structure

Journals

Journal types

Journal Entries

Draft

Post

Reverse

Immutable after posting

Balances

Quarterly tracking

Per account per branch

📊 M3 — Reports

Trial Balance

General Ledger

Income Statement

Balance Sheet

🔐 PERMISSION MODEL

Naming convention:

core.branches.view
finance.accounts.create
finance.journal_entries.post
finance.reports.trial_balance.view

Super Admin bypass enabled.

🧪 TEST STRATEGY

Each module must include:

CRUD test

Permission test

Unauthorized access test

Edge case test

Finance modules must include:

Posting validation test

Reverse test

Period lock test

Double posting prevention test

📈 SCALABILITY CONSIDERATIONS

Future multi-company ready

Indexed financial tables

Optimized reporting queries

Modular services

🛡 SECURITY CONSTRAINTS

No editing posted financial records

Route protection mandatory

Permission cache reset after role changes

Admin inactive login blocked

🚀 Development Phases

Phase 1: Core
Phase 2: Finance
Phase 3: Reports
Phase 4: Sales
Phase 5: Inventory
Phase 6: HR