📦 Merconiq Documentation
Welcome to the documentation portal for Merconiq — a modern, native .NET 10 / EF Core / PostgreSQL enterprise ERP platform with complete functional parity against ERPNext v16.
The canonical documentation URL is hosted on GitHub Pages.
📖 Documentation Index
1. Enterprise Core & Architecture
| Document | Audience | Focus Area | |—|—|—| | Architecture Boundaries | Developers & Architects | Modular-monolith structure, project dependency graph, analyzer baselines, OpenTelemetry observability, and Data Protection key persistence. | | ERPNext Parity Matrix | Product Owners & Auditors | Comprehensive 100% parity breakdown against ERPNext v16 backed by executable PostgreSQL integration test citations. | | Finance Posting Kernel | Finance Engineers | Double-entry balanced immutable journals, source-action idempotency, period 13 adjustments, fiscal locks, and trial balance reconciliation. | | Inventory Valuation & Costing | Inventory Controllers | Moving-average stock valuation math, FIFO layer queues, Landed Cost Vouchers (LCV), and append-only stock ledgers. | | Authorization & Capabilities | Security Administrators | Multi-tenant isolation, role-based access control (RBAC), company capability gates, and audit trails. | | Organization Ownership | System Administrators | Multi-tenant organization hierarchies, legal companies, branches, warehouses, and document ownership boundaries. | | Acceptance Scenarios | QA & Engineers | Canonical golden test fixtures and end-to-end integration workflows. |
2. Operations & Guides
| Document | Audience | Focus Area |
|—|—|—|
| User Guide | End Users & Operators | Day-to-day operations manual covering inventory, POS, procurement, sales, manufacturing, payroll, and banking. |
| REST API Reference | Integrators & Developers | Versioned /api/v1 endpoints, HMAC webhook subscriptions, idempotent requests, and payload specifications. |
| Backup & Recovery Runbook | DevOps & DBAs | PostgreSQL logical dump/restore procedures, verification checklists, and Data Protection encryption key backups. |
| Transfer Transit Runbook | Warehouse Managers | In-transit stock transfer tracking, aging reconciliation, and discrepancy dispute resolution. |
| Master Data Onboarding | Implementers | Bulk onboarding specifications and CSV/Excel import templates for catalog items, suppliers, customers, and opening balances. |
3. AI & Demand Forecasting
| Document | Audience | Focus Area | |—|—|—| | Demand Forecasting Engine | Data Scientists & Engineers | Native on-device forecasting runtime (deterministic Managed Moving Average & ML.NET SSA), configuration ceilings, and chronological holdout evaluation. |
4. Security, Provenance & Legal
| Document | Audience | Focus Area | |—|—|—| | Security Scanning & Headers | Security Engineers | Automated CodeQL static analysis, container vulnerability scanning with Trivy SARIF reporting, and defense-in-depth HTTP security headers (CSP, HSTS). | | Threat Model | Security Architects | STRIDE threat matrix, attack surface evaluation, and boundary mitigations. | | Image Provenance & Attestations | SecOps & Release Managers | Multi-architecture container build provenance, BuildKit SBOM attestations, and immutable digest verification. | | Project Provenance | Maintainers | Repository history integrity, authentic commit policies, and contributor guidelines. | | Third-Party Notices | Compliance Officers | Full inventory of third-party open-source components and licenses. |
🚀 Quick Start
Launch Merconiq locally using Docker Compose:
git clone https://github.com/nirzaf/merconiq.git
cd merconiq
cp .env.example .env # Set database credentials and JWT signing key
./scripts/validate-compose.sh development
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d --wait
The application will be live at http://localhost:8080 with Swagger API documentation available at http://localhost:8080/swagger.
🧠Navigation
- Using the application → User Guide
- API integrations → REST API Reference
- ERP feature verification → ERPNext Parity Matrix
- Architecture design → Architecture Boundaries
- Disaster recovery → Backup & Recovery Runbook
- Source repository → GitHub Repository
Built with .NET 10, ASP.NET Core, MudBlazor, PostgreSQL 16, MediatR, and QuestPDF. Released under the MIT License.