SmartERP Documentation An Ashewa Technology Solutions Platform

Security, confidentiality, and access governance

Multi-tiered security roles, four-level confidentiality classification, departmental isolation, statutory retention, and audit logging.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Security, confidentiality, and access governance within SmartERP.

Module map showing dependencies between SmartERP Supply Chain Core, Tenders, Store Vouchers, Landed Costs, and WMS.
SmartERP Supply Chain and Sourcing architectural module map.

Enterprise correspondence frequently carries sensitive commercial information, classified state correspondence, executive personnel decisions, or legal disputes. SmartERP Letter & Correspondence Management implements multi-tier role-based access control (RBAC), confidentiality clearances, departmental record rules, and audit logging to protect organizational privacy.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_letter, smarterp_correspondence
  • Security Groups:
    • Letter Registry Clerk (Technical ID: smarterp_letter.group_letter_clerk)
    • Executive Reviewer (Technical ID: smarterp_letter.group_letter_reviewer)
    • Director General (Technical ID: smarterp_letter.group_letter_executive)
  • Master Data Dependencies: Dual calendar templates (Ethiopian & Gregorian), official stamp repository, letter reference numbering formats, and departmental dispatch routes.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to Settings → Technical.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (System Administrator, Certified Specialist).
  • Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
  • Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
  • Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Security user groups#

SmartERP Letters defines fine-grained security groups structured across operational responsibilities:

Security GroupTechnical IdentifierIntended UsersPermissions & Access Scope
Letter Usergroup_letter_userAll standard employeesView public/internal circulars and letters assigned to them; create internal draft memos.
Letter Officergroup_letter_officerDepartmental action officersCreate, edit, and submit letters within their own department; view department correspondence.
Letter Approvergroup_letter_approverDepartment heads & managersReview, approve, reject, or request revisions on departmental letters; endorse circulars.
Registry Officergroup_letter_registryCentral mailroom / registry clerksAccess incoming and outgoing registry books; allocate official reference numbers; record dispatch and return receipts.
Letter Managergroup_letter_managerRegistry directors & operations managersConfigure numbering schemes, manage templates, maintain stamp registry, and reassign stalled letters across all departments.
Confidential Clearancegroup_letter_confidentialExecutives, legal counsel, HR managersView correspondence classified as confidential.
Secret Clearancegroup_letter_secretBoard members, CEO, Chief Legal OfficerView correspondence classified as secret / restricted.
Letter Auditorgroup_letter_auditorCompliance officers, internal auditorsRead-only access to all letter audit logs, cryptographic digests, and dispatch manifests across the enterprise.

Confidentiality levels and record rules#

Every correspondence record is assigned a confidentiality level that strictly restricts database queries via Odoo Record Rules:

flowchart TD
    PUB[Public: Visible to all internal users and circular portal]
    INT[Internal: Visible to originating department members and recipients]
    CONF[Confidential: Requires 'Confidential Clearance' group OR explicit assignment]
    SEC[Secret / Restricted: Requires 'Secret Clearance' AND explicit assignment]
    
    PUB --> INT
    INT --> CONF
    CONF --> SEC

Access Matrix by Confidentiality Level#

LevelTechnical KeyVisible ToSearchable by General Users?
PublicpublicAll enterprise employeesYes
InternalinternalMembers of the originating department, drafter, assigned reviewers, and recipient partnersOnly within authorized departments
ConfidentialconfidentialDrafter, assigned approvers, and users with group_letter_confidentialNo (hidden from general queries)
Secret / RestrictedsecretExplicitly named participants with group_letter_secretNo (hidden from all non-cleared users)

Statutory retention schedules and legal holds#

  1. Statutory Retention Policies: Letters can be bound to automated retention policies (e.g., Financial correspondence: 10 years; Routine circulars: 3 years; Board resolutions: Permanent). When retention expires, letters are marked for archival review.
  2. Legal Holds: When litigation or regulatory audits occur, authorized compliance officers can place an official Legal Hold on a letter thread. While on legal hold:
    • The letter cannot be archived, soft-deleted, or purged.
    • Any attempt to alter underlying DMS attachments raises an immediate security block.
    • All access events are recorded in high-fidelity compliance logs.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Letters: Check dispatch delivery receipt status (smarterp_letter.ir_cron_dispatch_check): Runs daily to verify courier delivery confirmation slips
    • Letters: Follow-up on pending memorandum actions (smarterp_letter.ir_cron_followup): Runs weekly to alert assigned officers of pending correspondence replies
  • Custom Print Templates & Reports:
    • Official Letterhead Dispatch Copy with QR Verification
    • Institutional Letter Inward/Outward Registry Ledger
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
Signature Block: Missing executive stamp clearanceLetter cannot be dispatched without authorized cryptographic stamp.Submit letter to Executive Office for digital signing.
Calendar Error: Invalid Ethiopian date conversionSpecified Ethiopian calendar date does not match leap year rules (Pagume 5/6).Use the automated calendar picker to ensure synchronized EC/GC conversion.
Unregistered Recipient: Partner profile missing TINExternal institutional recipient lacks complete corporate profile.Create or update recipient partner master record before dispatching.
Last updated: 2026-11-15