Order Management System

📋 Project Overview

Order Management System (OMS) is an enterprise-grade, production-ready trading platform designed for stock exchanges, brokerage houses, and financial institutions. Built to handle high-frequency trading with ultra-low latency, the system integrates directly with stock exchanges using industry-standard FIX and ITCH protocols.

The platform provides comprehensive order lifecycle management, real-time market data distribution, portfolio tracking, risk management, and multi-user support with role-based access control, delivering an exceptional experience for traders, investors, and administrators.

🎯 Key Objectives

• High-Performance Trading: Ultra-low latency order execution with FIX 5.0 SP1 protocol
• Real-time Market Data: Live market feed via ITCH 4.0 protocol with millisecond updates
• Multi-Exchange Support: Designed for DSE (Dhaka Stock Exchange) with extensibility for CSE and international exchanges
• Risk Management: Comprehensive limit controls, margin management, and position monitoring
• Multi-User Platform: Support for administrators, traders, and investors with distinct permissions
• Enterprise Architecture: Microservices-based design with Laravel backend and Java protocol handlers
• Real-time Broadcasting: WebSocket-based live updates for orders, trades, and market data
• Compliance Ready: Audit trails, session logging, and regulatory reporting capabilities

✨ Features

📈 Order Management (FIX Protocol Integration)

• Order Lifecycle Management:

  • New Order (Single) - Submit buy/sell orders with advanced options
  • Order Cancel Request - Cancel pending or partially filled orders
  • Order Cancel/Replace Request - Modify order price or quantity
  • Off-Market Trade execution support
  • Multi-exchange routing (DSE primary, extensible)

• Order Types & Options:

  • Market Orders (MKT)
  • Limit Orders (LMT)
  • Stop Orders (STP)
  • Stop Limit Orders (STPLMT)
  • Day Orders and Good Till Cancel (GTC)
  • Immediate or Cancel (IOC)
  • Fill or Kill (FOK)

• Real-time Order Status:

  • Pending New (0) - Order submitted to exchange
  • Partially Filled (1) - Order partially executed
  • Filled (2) - Order fully executed
  • Canceled (4) - Order canceled by user or system
  • Replaced (5) - Order modified
  • Pending Cancel (6) - Cancel request pending
  • Rejected (8) - Order rejected by exchange
  • Expired (C) - Order expired

• Advanced Features:

  • Panic Mode - Emergency cancel all open orders
  • Queued Order System - Pre-market order queuing
  • Order Retry Mechanism - Automatic retry on temporary failures
  • Batch Order Processing - Multiple orders in single submission
  • Commission Group-based Order Routing
  • Cash vs Margin order validation

📊 Market Data (ITCH Protocol Integration)

• Real-time Market Data:

  • Live price updates (Last Traded Price, LTP)
  • Best Bid/Ask prices with quantities
  • Market depth (5-level order book)
  • Time & Sales (Tick-by-tick trade data)
  • Trading session status (Pre-open, Open, Close, Post-close)
  • Circuit breaker and halt notifications

• Market Instruments:

  • Equity securities (stocks)
  • Fixed Income securities (bonds)
  • Mutual funds
  • Index tracking (DSE30, DSES, etc.)
  • Instrument directory with classifications

• Historical Data & Charting:

  • OHLCV (Open, High, Low, Close, Volume) candlestick data
  • Multi-timeframe support: 1m, 3m, 5m, 15m, 30m, 45m, 1h, 2h, 3h, 4h, Daily, 2D, 3D, Weekly
  • Market session filtering (trading hours only)
  • Historical price data with timezone handling
  • Volume analysis
  • Fundamental data integration (P/E ratio, market cap, EPS, etc.)

• Market Indices:

  • Real-time index calculations
  • Index constituent tracking
  • Historical index charts
  • Custom index creation support

👥 User & Account Management

• Role-based Access Control:

  • Administrator: Full system access, user management, settings control
  • Trader: Manage multiple investor accounts, portfolio monitoring, order execution
  • Investor: Personal portfolio, order placement, market data access

• BO Account Management:

  • Client registration with BO (Beneficiary Owner) account linking
  • Multi-account support for traders
  • Account status management (active/suspended)
  • Buy/Sell suspension controls
  • Account type classification (Cash, Margin)
  • Dealer and broker assignment

• User Features:

  • Secure authentication with Laravel Sanctum
  • Email and phone verification
  • OTP-based two-factor authentication
  • Session management with timeout controls
  • Password reset and recovery
  • Activity logging and audit trails

💰 Portfolio & Position Management

• Real-time Portfolio Tracking:

  • Current holdings with real-time valuations
  • Average purchase price calculation
  • Unrealized gain/loss tracking
  • Realized profit/loss history
  • Portfolio performance metrics
  • Asset allocation visualization

• Position Management:

  • Intraday position tracking
  • T+0, T+1, T+2 settlement tracking
  • Available vs locked quantity management
  • Position reconciliation with exchange
  • Corporate action handling (dividends, splits, rights)

• Trade History:

  • Complete trade log with timestamps
  • Executed price and quantity details
  • Commission and fees breakdown
  • Settlement date tracking
  • Trade confirmation reports
  • Export to CSV/Excel for accounting

🛡️ Risk Management & Limits

• Multi-level Limit Controls:

  • Cash Limit - Available cash for trading
  • Deposit Limit - Credit facility limit
  • Margin Ratio Limit - Leverage control
  • Max Capital Buy Limit - Maximum purchase amount
  • Max Capital Sell Limit - Maximum sell amount
  • Total Transaction Limit - Daily transaction cap
  • Net Transaction Limit - Net exposure limit

• Market-specific Limits:

  • Per-market position limits
  • Instrument-specific limits
  • Sector-wise exposure limits
  • Group company exposure controls

• Pre-trade Risk Checks:

  • Sufficient fund validation
  • Position limit verification
  • Margin requirement calculation
  • Short selling validation
  • Price band/circuit filter checks
  • Duplicate order detection

• Real-time Risk Monitoring:

  • Live exposure calculation
  • Margin utilization tracking
  • Limit breach alerts
  • Automatic order rejection on limit violation
  • Risk dashboard for administrators

💼 Commission & Pricing

• Commission Group Management:

  • Flexible commission structures
  • User-based commission assignment
  • Instrument-based commission rules
  • Volume-based commission tiers
  • Special pricing for VIP clients

• Commission Calculation:

  • Buy-side commission
  • Sell-side commission
  • Exchange fees
  • BSEC fees
  • DP charges
  • VAT and taxes
  • Real-time commission preview

📱 Watchlist & Market Monitoring

• Personal Watchlists:

  • Create multiple custom watchlists
  • Add/remove instruments dynamically
  • Real-time price updates on watchlist
  • Sorting and filtering options
  • Quick order placement from watchlist
  • Price alerts and notifications

• Market Overview:

  • Top gainers and losers
  • Most active stocks by volume
  • Index movements
  • Market breadth indicators
  • Sector performance

🔔 Support & Communication

• Support Ticket System:
  • Create support tickets for issues
  • Ticket status tracking (Open, In Progress, Resolved, Closed)
  • Priority levels (Low, Medium, High, Critical)
  • Admin response management
  • Ticket history and audit trail
  • Email notifications on status updates

🔌 Microservices Architecture

• Java-based Protocol Handlers:

  • FIX Microservice (oms-fix-1.0.1.jar):

    • FIX 5.0 SP1 protocol implementation
    • Session management with exchange
    • Heartbeat and sequence number handling
    • Automatic reconnection and failover
    • Message queuing and retry logic
    • Reset sequence number support

  • ITCH Microservice (oms-itch-1.0.0.jar):

    • ITCH 4.0 protocol parser
    • Real-time market data streaming
    • Multi-channel support (TV, Index, News)
    • Message filtering and routing
    • High-throughput message processing

  • Broadcast Microservice (oms-broadcast-1.0.0.jar):

    • WebSocket broadcasting server
    • Real-time data distribution to clients
    • Connection pooling and management
    • Message compression and optimization
    • Automatic reconnection handling

🔄 Background Processing

• Laravel Queue System:

  • ImportDSEClient: Import client data from exchange
  • ImportDSEPosition: Sync portfolio positions
  • ExportTrades: Export trade confirmations
  • ExportEODTicker: End-of-day market data export
  • BackupDB: Automated database backups
  • RestoreDB: Database restoration capability
  • FixJob: Asynchronous FIX message processing
  • ImportKodeviteOMSUser: User data synchronization

• Scheduled Tasks:

  • Market open/close automation
  • End-of-day settlement processing
  • Limit reset at market close
  • Portfolio reconciliation
  • Automated reporting
  • Data archival and cleanup

🔐 Security & Compliance

• Security Features:

  • Role-based access control (RBAC)
  • API token authentication (Laravel Sanctum)
  • CSRF protection on all forms
  • SQL injection prevention (Eloquent ORM)
  • XSS protection (Blade escaping)
  • Rate limiting on authentication endpoints
  • Session timeout and management
  • Encrypted sensitive data storage

• Audit & Compliance:

  • Complete FIX message logging
  • Event log for all system activities
  • User action tracking
  • IP address and user agent logging
  • Session audit trail
  • Trade confirmation archival
  • Regulatory reporting capabilities

🌐 Integration & APIs

• Redis Integration:

  • Real-time data caching
  • Session storage
  • Queue management (DSE:FIX:Observer)
  • Pub/Sub for broadcasting
  • Rate limiting

• Database Design:

  • PostgreSQL with advanced features
  • Partitioning for high-volume tables
  • Indexed for optimal query performance
  • JSONB for flexible data structures
  • Foreign key constraints for data integrity

⚙️ Administrative Features

• Settings Management:

  • Market hours configuration
  • Trading parameters (lot size, tick size)
  • Commission rates and fees
  • Risk limits and thresholds
  • System maintenance mode
  • Feature toggles

• User Management:

  • Create and manage users
  • Assign roles and permissions
  • Link users to BO accounts
  • Suspend/activate accounts
  • Password reset for users
  • Bulk user operations

• System Management:

  • Database backup and restore
  • Log viewing and analysis
  • System health monitoring
  • Performance metrics
  • Error tracking and alerting
  • Version control and updates

🛠️ Technology Stack

Backend

Financial Protocols

Infrastructure

• Queue System: Redis-backed job queue for asynchronous processing
• Cache: Redis for high-performance caching
• Session: Database sessions for horizontal scaling
• WebSocket: Real-time bidirectional communication
• File Storage: Local/S3 compatible storage
• Docker: Laravel Sail containerization support

Development Tools

📊 Project Statistics

🎯 Use Cases

For Brokerage Houses

• Complete order management system for retail and institutional clients
• Multi-user platform for traders and back-office staff
• Real-time risk management and compliance monitoring
• Portfolio tracking and performance reporting
• Commission management and billing
• Regulatory reporting and audit trails

For Stock Exchanges

• Order routing and execution platform
• Market data distribution infrastructure
• Member connectivity via FIX protocol
• Real-time surveillance and monitoring
• Circuit breaker and halt management
• End-of-day settlement processing

For Institutional Traders

• Direct market access (DMA) trading
• Algorithmic trading support
• Multi-account management
• Portfolio optimization tools
• Real-time P&L tracking
• Trade cost analysis

For Retail Investors

• User-friendly trading interface
• Real-time market data and charts
• Portfolio management
• Watchlists and alerts
• Trade history and reporting
• Customer support system

🌟 Key Differentiators

1. Production-Ready FIX Integration - Certified FIX 5.0 SP1 implementation with failover
2. Real-time ITCH Parser - High-performance market data processing
3. Microservices Architecture - Scalable Java services for protocol handling
4. Ultra-Low Latency - Optimized for high-frequency trading
5. Comprehensive Risk Management - Multi-level limit controls and pre-trade checks
6. Enterprise Security - Audit trails, session management, and compliance ready
7. Multi-Exchange Support - Designed for DSE with extensibility
8. WebSocket Broadcasting - Real-time updates without polling
9. Advanced Portfolio Tracking - T+0, T+1, T+2 settlement handling
10. Flexible Commission Engine - Group-based and instrument-specific pricing

🔒 Security & Compliance

Security Measures

• Authentication: Multi-factor authentication with OTP
• Authorization: Role-based access control (RBAC)
• API Security: Token-based authentication (Sanctum)
• Data Encryption: Sensitive data encrypted at rest
• Session Security: Timeout controls and IP tracking
• Audit Logging: Complete activity and message logs
• Rate Limiting: Protection against brute force attacks
• Input Validation: Comprehensive request validation

Compliance Features

• FIX Message Logging: All messages logged with timestamps
• Trade Confirmation: Automated trade confirmation generation
• Settlement Tracking: T+0, T+1, T+2 settlement monitoring
• Regulatory Reporting: End-of-day reports for BSEC
• Audit Trail: Complete user action history
• Data Retention: Configurable data archival policies

📞 Support & Contact

Developed by: Kodevite Project: Order Management System Framework: Laravel 12 with PostgreSQL, Redis, and Java Microservices Website: https://kodevite.com

For support, feature requests, or custom development:

• Email: info@kodevite.com
• Website: https://kodevite.com

📄 License

License information to be added based on project requirements

🙏 Acknowledgments

Built with industry-standard technologies and protocols:

• Laravel - The PHP Framework
• FIX Protocol - Financial Information eXchange
• ITCH Protocol - Market Data Protocol
• Redis - In-memory data structure store
• PostgreSQL - Advanced relational database