- Reports Page
 

Central Payment, Finance & Cash Intelligence Module

- High-Level Overview (Main Module Purpose)
 

The Reports Page is the financial brain of the biz1 system.
 

It consolidates all monetary activity—payments, invoices, checks, deposits, obligations, cash flow, and orders—into a single, structured reporting hub.
 

 If Products & Orders generate money, the Reports Page explains what happened to that money.

• - Architecture Position (Very Important)
   

  SYSTEM CORE
  │
  ├── Customers
  ├── Products
  ├── Orders
  ├── Documents (Invoices / Receipts)
  │
  └── REPORTS PAGE  ← THIS MODULE
       ├── Payment Tracking
       ├── Documents
       ├── Checks / Cunto
       ├── Obligo
       ├── CashFlow
       ├── Order Report
       ├── Payers Tracking
       ├── Monthly Report
       └── Deposit
  
  

  
  ✔ Reports do not create data
  ✔ Reports read, analyze, group, and visualize data
  ✔ Reports are 100% dependent on other modules
  
  
   

  - Sub-Modules Explained (Conceptual, Not CRUD)
   

  ---

  1️⃣ Payment Tracking
   

  - Purpose:
  
  Tracks actual money movements.
   

• Key Characteristics:
   

• Chart-driven (monthly bars, pie charts)

• Filters by date, customer, project, team, gateway

• Export-ready

• Status-based (Moved / Did Not Pass)
   

• ---

  2️⃣ Documents
   

  - Purpose:
  
  Financial visibility per document, not per payment.
   

• Key Characteristics:
   

• Multi-document support (invoice, receipt, GI/IR, credit)

• Custom fields per organization

• Company-based filtering

• Deep integration with Documents module

• ---

  3️⃣ Checks
   

  - Purpose:
  
  Full lifecycle tracking of check-based payments.
   

• Key Characteristics:
   

• 27 structured rejection reasons

• Status workflow

• Image upload (check photo)

• Mission creation from checks

• ---

  4️⃣ Cunto (Conditional Module)
   

  - Purpose:
  
  Specialized check workflow for Cunto-enabled organizations.
   

  Key Characteristics:

• Same financial logic as Checks

• Different approval/status flow

• Enabled only if cunto_module exists
   

• ---

  5️⃣ Obligo Report
   

  ⚠️ Purpose:
  
  Shows customer debt exposure.
   

   

• Key Characteristics:
   

• Grouped by customer

• Date-based filtering

• Company & team filtering

• Critical for risk management
   

• ---

  6️⃣ CashFlow Report
   

  - Purpose:
  
  Shows timing of money, not just totals.
   

• Key Characteristics:
   

• Week-based analysis

• Predictive financial planning

• Visual flow representation
   

• ---

  7️⃣ Order Report (Admin Only)
   

  - Purpose:
  
  Connects orders → invoices → payments.
   

• Key Characteristics:

• Chart-driven

• Admin-level visibility

• Operational finance control
   

• ---

  8️⃣ Payers Tracking
   

  - Purpose:
  
  Customer-centric payment summary.
   

• Key Characteristics:
   

• Aggregated totals per customer

• Gateway filtering

• Export-ready
   

• ---

  9️⃣ Monthly Report
   

  - Purpose:
  
  Long-term financial trend analysis.
   

  Two Modes:
   

• Debt View

• Open Orders View
   

• Key Characteristics:
   

• Rolling 12-month window

• Debit / credit calculation

• Customer grouping
   

• ---

  - Deposit Report
  
   

  - Purpose:
  
  Tracks bank-level deposits.
   

• Key Characteristics:
   

• Cash, checks, transfers

• Bank selection

• Team member attribution
   

• ---

  - Connected Systems (Critical)
   

  The Reports Page pulls data from:

• Customers (contactus)

• Documents (documents)

• Orders

• Payment gateways

• Banks

• Teams

• Campaigns

• Subscriptions
   

• ✔ No data duplication
  ✔ Read-only analytics layer
   

  ---

  
  ⚙️ Settings & Customization
   

• Default tab per user

• Custom payment fields

• Company-based invoice filtering

• Payment gateway configurations

• Role & plan restrictions
   

• All stored in:
   

• user_detail

• invoices_settings

• payment_detail
   

• ---

  - Security & Governance
   

• Login enforcement

• Plan-based access

• Role-based tab visibility

• Organization-level data isolation

• Secure export & API access
  
   

• ---

  - Final Summary
   

  
  Reports Page =
  
  ✔ Financial transparency
  ✔ Payment intelligence
  ✔ Risk & obligation control
  ✔ Cash flow forecasting
  ✔ Multi-gateway reporting
  ✔ Enterprise-grade analytics