Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Auditix Pro - Enterprise Financial Management Suite

A comprehensive enterprise-grade full-stack financial management platform designed for corporate companies. Features user authentication, role-based access control (RBAC), AI-powered financial analysis, audit-ready reports, stock/forex markets tracking, and a modern silhouette-themed UI.

Features

Core Modules

  • Executive Dashboard - Real-time KPIs, cash flow analysis, customizable widgets
  • Markets - Stock indices (S&P 500, NASDAQ, DOW, FTSE) and forex tracking with watchlists
  • Cash Management - Transaction tracking, multi-account management
  • Investment Portfolio - Asset allocation, performance analytics
  • General Ledger - Double-entry accounting system
  • AR/AP Management - Invoice creation, payment tracking
  • Expense Management - Employee expenses with approval workflows
  • Financial Reports - P&L, Balance Sheet, Cash Flow statements
  • Budget & Forecasting - Department budgeting, variance analysis
  • Vendor Management - Supplier relationships, contract tracking
  • Payroll & HR - Malaysian statutory calculations (EPF 11%/12%, SOCSO, EIS, PCB)
  • Compliance & Audit - SOX, GAAP, IFRS tracking with audit trails
  • Risk Analysis - Risk profiling, credit scoring
  • AI Financial Advisor - Google Gemini integration for insights and recommendations

Security & Access Control

  • Username/password authentication with bcrypt hashing
  • Session-based authentication with PostgreSQL session store
  • Role-based access control (RBAC) with 7 enterprise roles:
    • Admin, CFO, Controller, Accountant, Manager, Analyst, Viewer
  • Subscription tier gating (Free, Professional, Enterprise)
  • Rate limiting and input validation
  • Request sanitization (XSS prevention)
  • Helmet security headers

AI Features

  • Explainable financial recommendations with confidence scores
  • Investment analysis with data points and alternatives
  • Risk assessment with reasoning
  • Anomaly detection for fraud prevention

Tech Stack

Frontend

  • React 19 + TypeScript
  • Vite build tool
  • Tailwind CSS
  • Recharts for data visualization
  • Lucide React icons

Backend

  • Express.js REST API
  • PostgreSQL database (Neon-backed)
  • Drizzle ORM
  • express-session for authentication

Project Structure

/
├── App.tsx                    # Main application component
├── index.tsx                  # Entry point
├── types.ts                   # TypeScript type definitions
├── components/
│   ├── Sidebar.tsx            # Navigation sidebar
│   └── ChatWidget.tsx         # AI chat widget
├── pages/
│   ├── Dashboard.tsx          # Executive dashboard
│   ├── Markets.tsx            # Stock & forex markets
│   ├── PersonalFinance.tsx    # Cash management
│   ├── Investments.tsx        # Investment portfolio
│   ├── Accounting.tsx         # General ledger
│   ├── InvoiceManagement.tsx  # AR/AP management
│   ├── ExpenseManagement.tsx  # Expense reports
│   ├── FinancialReports.tsx   # Financial statements
│   ├── BudgetForecasting.tsx  # Budget planning
│   ├── VendorManagement.tsx   # Supplier management
│   ├── PayrollManagement.tsx  # Payroll & HR
│   ├── ComplianceAudit.tsx    # Compliance tracking
│   ├── RiskAnalysis.tsx       # Risk assessment
│   ├── AIAssistant.tsx        # AI financial advisor
│   ├── Settings.tsx           # User settings
│   └── Auth.tsx               # Login/Register
├── server/
│   ├── index.ts               # Express server entry
│   ├── db.ts                  # Database connection
│   ├── localAuth.ts           # Authentication logic
│   ├── routes.ts              # API routes
│   └── middleware/
│       └── rbac.ts            # Role-based access control
├── shared/
│   ├── schema.ts              # Drizzle database schema
│   └── models/
│       └── auth.ts            # Auth type definitions
└── services/
    └── geminiService.ts       # Google Gemini AI service

Getting Started

Prerequisites

  • Node.js 18+
  • PostgreSQL database

Installation

  1. Install dependencies:

    npm install
  2. Set up environment variables:

    • DATABASE_URL - PostgreSQL connection string
    • GEMINI_API_KEY - Google Gemini API key for AI features
    • SESSION_SECRET - Session encryption key
  3. Push database schema:

    npm run db:push
  4. Start the development servers:

    npm run dev      # Frontend (port 5000)
    npm run server   # Backend (port 3001)

API Endpoints

Authentication

  • POST /api/auth/register - Register new user
  • POST /api/auth/login - Login with username/password
  • POST /api/auth/logout - Logout
  • GET /api/auth/user - Get current user

Data Endpoints

  • GET /api/transactions - Get user transactions
  • POST /api/transactions - Create transaction
  • GET /api/accounts - Get user accounts
  • GET /api/investments - Get investments
  • GET /api/invoices - Get invoices
  • GET /api/vendors - Get vendors
  • GET /api/employees - Get employees
  • GET /api/payroll - Get payroll records
  • GET /api/compliance - Get compliance checks
  • GET /api/audit-logs - Get audit logs
  • GET /api/dashboard/stats - Get dashboard statistics

AI Endpoints

  • POST /api/ai/chat - Chat with AI advisor
  • POST /api/ai/analyze - Analyze financial data

User Roles & Permissions

Role Description Access Level
Admin System Administrator Full access
CFO Chief Financial Officer Executive
Controller Financial Controller Operations
Accountant Staff Accountant Day-to-day
Manager Department Manager Department
Analyst Financial Analyst Reporting
Viewer Read-only User View only

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages