Product

SmartERP

Ashewa Technology Solutions' business platform, built on modern enterprise architecture Community.

Pages 712

• Welcome to SmartERP

  Enterprise business management platform for Ethiopian and global organizations.

  Introduction
• SmartERP application portfolio

  Overview of core business areas, application suites, and modular expansion capabilities.

  Introduction
• Glossary of key terms

  Standard enterprise definitions for terminology used across SmartERP applications.

  Introduction
• SmartERP Developer SDK and Architecture Overview Overview

  Technical architecture, repository structure, Odoo 19 Community base, OCA dependencies, and Ashewa enterprise addon framework.

  Custom Software Development Kit & Scaffolding
• Local Development Environment and Toolchain Setup Tutorial

  Step-by-step instructions for configuring Python 3.12+, PostgreSQL 16, uv/pip, Docker, pre-commit git hooks, and VS Code / Antigravity development tools.

  Custom Software Development Kit & Scaffolding
• Module Scaffolding and Codebase Governance Standards How-To

  Creating compliant SmartERP custom addons, manifest declarations, directory layouts, and layered inheritance rules.

  Custom Software Development Kit & Scaffolding
• Odoo 19 ORM Modeling and Database Field Types How-To

  Defining data models, relational fields (Many2one, One2many, Many2many), computed attributes, stored indexes, and SQL constraints.

  Custom Software Development Kit & Scaffolding
• View Architecture and Odoo 19 List View Migration How-To

  Migrating legacy <tree> views to Odoo 19 <list> elements, form layouts, search filters, and responsive mobile design.

  Custom Software Development Kit & Scaffolding
• Documentation Generator Tools and Diagram Tooling How-To

  Using the smarterp_docs engine, scanning tools, building declarative vector diagrams, and screenshot manifest registration.

  Custom Software Development Kit & Scaffolding
• CLI Utilities, Webhook Tunneling, and Playwright Testing How-To

  Setting up local development webhook tunnels using ngrok or Cloudflare, and running automated Playwright end-to-end browser tests.

  Custom Software Development Kit & Scaffolding
• Testing Strategies and Test-Driven Development (TDD) How-To

  Writing unit tests with TransactionCase, HTTP tests with HttpCase, and creating fast offline test suites without database overhead.

  Custom Software Development Kit & Scaffolding
• Git Workflow, Branch Parity, and GitLab Governance How-To

  Operating rules for the Ashewa GitLab monorepo, strict branch parity across migration, dev, and main, and zero-leakage policies.

  Custom Software Development Kit & Scaffolding
• Troubleshooting Common Developer and Runtime Issues Troubleshooting

  Diagnostic trees for resolving registry reload blocks, schema locks, asset compilation errors, and dependency circularity.

  Custom Software Development Kit & Scaffolding
• API and Integration Hub Architecture Overview Overview

  Architectural blueprint of the SmartERP Integration Hub, REST/JSON-RPC protocols, webhook event bus, and external microservice connectivity.

  API, Webhooks & Integration Hub
• JSON-RPC and RESTful API Architecture Concept

  Deep dive into Odoo 19 JSON-RPC wire protocol, controller routing (type='json' vs type='http'), CORS headers, and payload serialization.

  API, Webhooks & Integration Hub
• API Authentication, Bearer Tokens, and Key Management How-To

  Generating user API keys, Bearer token authentication headers, role-based API scope restrictions, and secret rotation policies.

  API, Webhooks & Integration Hub
• Webhook Subscriptions and Asynchronous Event Bus How-To

  Configuring event subscriptions for record creation, modification, and deletion, asynchronous queue processing, and HMAC verification.

  API, Webhooks & Integration Hub
• n8n Workflow Automation and Low-Code Orchestration How-To

  Building automated workflows connecting SmartERP with external SaaS apps, CRM pipelines, and notification bots using the n8n orchestrator.

  API, Webhooks & Integration Hub
• Telebirr SuperApp FinTech Payment Bridge Integration How-To

  Implementing the Ethio Telecom Telebirr C2B/B2B payment bridge, dynamic QR generation, instant webhook callbacks, and invoice clearing.

  API, Webhooks & Integration Hub
• Chapa and Commercial Bank of Ethiopia (CBE) Gateways How-To

  Integrating the Chapa payment orchestrator and CBE Birr banking rails for card payments, domestic transfers, and fee settlement.

  API, Webhooks & Integration Hub
• API Rate Limiting, Throttling, and Observability How-To

  Protecting SmartERP endpoints using Redis rate limiters, token bucket algorithms, Prometheus metrics, and latency dashboards.

  API, Webhooks & Integration Hub
• Connecting External Microservices and Message Queues How-To

  Architectural guidelines for bridging SmartERP with FastAPI/Flask microservices, Celery distributed tasks, and RabbitMQ event queues.

  API, Webhooks & Integration Hub
• Troubleshooting API, Webhook, and Network Failures Troubleshooting

  Diagnostic trees for resolving HTTP 401 Unauthorized, webhook delivery timeouts, dropped FinTech callbacks, and JSON parsing errors.

  API, Webhooks & Integration Hub
• Enterprise Security and Governance Architecture Overview Overview

  Overview of SmartERP's defense-in-depth security model, ISO 27001 principles, role-based access control, and multi-company data isolation.

  Advanced Security & Multi-Company Governance
• Role-Based Access Control (RBAC) and Model ACLs Concept

  Designing security group hierarchies, configuring ir.model.access.csv files, and granting granular Create, Read, Write, and Unlink (CRUD) permissions.

  Advanced Security & Multi-Company Governance
• Row-Level Security and Dynamic Record Rules How-To

  Implementing ir.rule domain filters to partition records by department, branch, assigned salesperson, and confidentiality flags.

  Advanced Security & Multi-Company Governance
• Multi-Company Partitioning and Legal Entity Governance How-To

  Architectural rules for multi-company isolation under Company 1 (Ashewa Technology Solutions S.C.), inter-company transactions, and boundary governance.

  Advanced Security & Multi-Company Governance
• Field-Level Encryption and Sensitive PII Protection How-To

  Encrypting confidential payroll, bank, and medical data at rest using AES-GCM, PII tokenization, and dynamic field masking.

  Advanced Security & Multi-Company Governance
• Audit Logging and Tamper-Evident Revision Trails How-To

  Configuring audit trails for critical model mutations, tracking field-level before/after values, user timestamps, and IP addresses.

  Advanced Security & Multi-Company Governance
• Two-Factor Authentication (2FA) and Session Governance How-To

  Enforcing mandatory Time-Based One-Time Password (TOTP) 2FA, session timeout limits, brute-force lockouts, and password policies.

  Advanced Security & Multi-Company Governance
• Database Hardening, Edge Blocking, and Network Security How-To

  PostgreSQL security hardening, TLS/SSL encryption, edge proxy blocking of database enumeration endpoints, and Docker network isolation.

  Advanced Security & Multi-Company Governance
• Security Compliance Protocols and Penetration Testing Reference

  Conducting periodic vulnerability scans, static application security testing (SAST), penetration testing, and ISO 27001 audit protocols.

  Advanced Security & Multi-Company Governance
• Troubleshooting Security, ACL, and Record Rule Failures Troubleshooting

  Diagnostic guide for debugging 'Access Rights Error', conflicting group memberships, record rule domain evaluation, and 2FA recovery.

  Advanced Security & Multi-Company Governance
• Choose a module and check the requirements

  Which social module to install, what it needs, and the one thing you must supply yourself.

  Getting started
• Install with Docker (Route A)

  A self-contained stack on port 8291, from nothing but Docker.

  Getting started
• Install into an existing Odoo (Route B)

  The scripted route for adding the modules to the Odoo 17 database you already use.

  Getting started
• Install by hand (Route C)

  The same install as Route B, one step at a time.

  Getting started
• Users and access

  The two roles each social module defines, and how to give people the right one.

  Getting started
• Executive and CEO Guide

  Strategic portfolio oversight, executive KPI dashboards, capital expenditure authorizations, and corporate risk governance.

  Role-Based Journeys
• Project Manager Guide

  End-to-end delivery management, sprint execution, Definition of Ready enforcement, task allocation, and budget controls.

  Role-Based Journeys