Skip to content

mDeploys/FinAi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FinAI - Smart Financial Management Platform

A comprehensive, AI-powered financial management system designed for businesses with full IFRS compliance, multi-country support, and ZATCA e-invoicing integration.

License Version Saudi Arabia Status

🎯 Overview

FinAI is a modern, bilingual (English/Arabic) financial management platform built specifically for businesses in the GCC region and Middle East. It features advanced AI capabilities, comprehensive audit workflows, and compliance with international financial reporting standards.

πŸ’‘ Credits & Attribution

Idea & Concept: Mr. Sami Soud Developer & Implementation: Jalal Nasser Business Owner: GetSolution Co.

✨ Key Features

🌍 Multi-Country Support

  • 8 GCC & Middle East Countries: Saudi Arabia, UAE, Bahrain, Kuwait, Oman, Qatar, Egypt, Jordan
  • Country-specific VAT rates and tax configurations
  • Localized date formats, number formats, and fiscal years
  • Full bilingual support (English/Arabic) with RTL layout

πŸ“Š Financial Management βœ…

  • βœ… Chart of Accounts with IFRS mappings
  • βœ… Journal Entries with automatic debit/credit validation
  • βœ… Transaction Management with audit trail
  • βœ… Bank Reconciliation with automated matching
  • βœ… Financial Reports: Income Statement, Balance Sheet, Cash Flow, VAT Returns
  • βœ… Report Export: CSV/Excel export, PDF via browser print
  • βœ… IFRS Calculations: IAS 1, IAS 7, IFRS 15 compliant

πŸ‡ΈπŸ‡¦ ZATCA E-Invoicing (Saudi Arabia)

  • βœ… Phase 1 & Phase 2 Compliant
  • UBL 2.1 XML invoice generation
  • QR code generation (TLV encoding)
  • Digital signatures with X.509 certificates
  • Automatic submission to ZATCA (Clearance & Reporting modes)
  • Invoice hash chaining for audit trail
  • Certificate management (Production & Sandbox)
  • B2B and B2C invoice support

πŸ“ˆ IFRS Compliance

  • Statement of Financial Position (Balance Sheet)
  • Statement of Comprehensive Income (P&L)
  • Statement of Cash Flows
  • Statement of Changes in Equity
  • Financial statement notes with AI-powered templates
  • Compliance checklists and validation

πŸ” Audit Workflow

  • 4-stage audit process (Planning β†’ Controls β†’ Procedures β†’ Review)
  • Audit findings tracking with severity levels
  • Team assignment and due dates
  • Complete audit trail and reporting

πŸ€– AI-Powered Analytics βœ…

  • βœ… Real-time KPI dashboard (Revenue, Expenses, Net Income, Profit Margin)
  • βœ… Cash flow forecasting with 6-month predictions and confidence intervals
  • βœ… Anomaly detection with statistical analysis and duplicate transaction detection
  • βœ… Trend analysis with interactive Recharts visualizations
  • βœ… Transaction distribution analytics with pie charts
  • βœ… AI-generated financial insights with rule-based and OpenAI integration
  • βœ… Document processing and data extraction with OCR
  • βœ… Automatic insight generation from detected anomalies

πŸ” Security & Access Control

  • Role-based access control (Admin, Manager, Accountant, Viewer)
  • Multi-organization support with isolation
  • Encrypted certificate storage (AES-256)
  • Session management with secure cookies
  • Audit logging for all operations

πŸ› οΈ Technology Stack

Frontend

  • React 19 with TypeScript
  • Wouter for routing
  • TailwindCSS with dark mode support
  • Recharts for data visualization
  • i18next for internationalization
  • tRPC for type-safe API calls
  • Radix UI components

Backend

  • Node.js with Express
  • tRPC for API layer
  • Drizzle ORM with PostgreSQL (Neon)
  • Zod for validation
  • bcryptjs for password hashing
  • WebSockets for real-time updates

ZATCA Integration

  • xmlbuilder2 - UBL 2.1 XML generation
  • qrcode - QR code generation
  • node-forge - Cryptographic operations (SHA-256, RSA-2048)
  • uuid - UUID generation for invoices

AI Services

  • OpenAI GPT-4
  • Azure OpenAI
  • Document processing and OCR
  • Natural language processing

πŸ“¦ Installation

# Clone the repository
git clone https://github.com/Jalal-Nasser/FinAI.git
cd FinAI

# Install dependencies
pnpm install

# Set up environment variables
cp .env.example .env
# Edit .env with your database URL and API keys

# Run database migrations
pnpm db:push

# Seed initial data
pnpm db:seed

# Start development server
pnpm dev

πŸš€ Deployment

The application is designed for deployment on Vercel with Neon PostgreSQL:

# Build for production
pnpm build

# Preview production build
pnpm preview

πŸ“š Documentation

🌐 Supported Countries

Country Code Currency VAT Rate E-Invoicing
Saudi Arabia SA SAR 15% βœ… ZATCA
UAE AE AED 5% Ready
Bahrain BH BHD 10% Ready
Kuwait KW KWD 0% Ready
Oman OM OMR 5% Ready
Qatar QA QAR 0% Ready
Egypt EG EGP 14% Ready
Jordan JO JOD 16% Ready

πŸ“„ License

PROPRIETARY LICENSE

Copyright (c) 2025 GetSolution Co., Sami Soud & Jalal Nasser All Rights Reserved

This software is proprietary and confidential. Unauthorized copying, distribution, or use is strictly prohibited.

See LICENSE file for full details.

🀝 Contributing

This is a proprietary project. Contributions are accepted only from authorized personnel.

πŸ“§ Contact

πŸ™ Acknowledgments

  • Concept Creator: Sami Soud
  • Developer: Jalal Nasser
  • Open Source Community for the amazing tools and libraries
  • ZATCA for comprehensive e-invoicing documentation
  • IFRS Foundation for international reporting standards

Built with ❀️ in Saudi Arabia © 2025 GetSolution Co. | Idea by Sami Soud | Developed by Jalal Nasser

Releases

No releases published

Packages

No packages published

Languages