{"id":29966293,"url":"https://github.com/codewizard-404/traceflow","last_synced_at":"2026-04-11T12:02:35.304Z","repository":{"id":303883415,"uuid":"927785644","full_name":"CodeWizard-404/TraceFlow","owner":"CodeWizard-404","description":"TraceFlow is an AI-powered platform for Enda Tao, streamlining territorial activity tracking, timesheet management, and receipt book traceability. With secure authentication, geolocation, real-time notifications, and AI-driven analytics, it empowers roles like Supervisors, Regional Managers, and HR with dynamic dashboards and multilingual support. ","archived":false,"fork":false,"pushed_at":"2025-09-04T19:28:21.000Z","size":179147,"stargazers_count":0,"open_issues_count":227,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-04T21:25:43.723Z","etag":null,"topics":["flutter","google-cloud-platform","keycloak","nginx","nodejs","pm2","postgresql","react-tsx","redis","websocket"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodeWizard-404.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-05T14:43:06.000Z","updated_at":"2025-09-04T19:28:26.000Z","dependencies_parsed_at":"2025-07-10T09:05:17.734Z","dependency_job_id":null,"html_url":"https://github.com/CodeWizard-404/TraceFlow","commit_stats":null,"previous_names":["codewizard-404/traceflow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CodeWizard-404/TraceFlow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWizard-404%2FTraceFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWizard-404%2FTraceFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWizard-404%2FTraceFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWizard-404%2FTraceFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodeWizard-404","download_url":"https://codeload.github.com/CodeWizard-404/TraceFlow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWizard-404%2FTraceFlow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278891741,"owners_count":26063861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flutter","google-cloud-platform","keycloak","nginx","nodejs","pm2","postgresql","react-tsx","redis","websocket"],"created_at":"2025-08-04T02:32:15.713Z","updated_at":"2025-10-08T05:25:00.941Z","avatar_url":"https://github.com/CodeWizard-404.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌟 TraceFlow: AI-Powered Efficiency for Enda Tao 🚀\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-v22.14+-green?logo=node.js)](https://nodejs.org/)\n[![Flutter](https://img.shields.io/badge/Flutter-v3.29-blue?logo=flutter)](https://flutter.dev/)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-v9+-blue?logo=postgresql)](https://www.postgresql.org/)\n[![Docker](https://img.shields.io/badge/Docker-Enabled-blue?logo=docker)](https://www.docker.com/)\n\n**TraceFlow** is a state-of-the-art, AI-driven platform developed for **Enda Tao** to streamline territorial activity tracking, timesheet management, and receipt book traceability. Created as a final-year project, TraceFlow empowers roles such as Super Admin, Admin, Director, Regional Manager, Supervisor, Purchase Team, Stock Manager, and HR with secure authentication, geolocation, real-time updates, and AI-powered analytics. Featuring dynamic dashboards, multilingual support (English, French, Arabic), and seamless integrations, TraceFlow delivers operational excellence in a scalable, user-centric package. 🌍\n\n---\n\n## 📑 Table of Contents\n- [🌟 Overview](#-overview)\n- [🔥 Key Features](#-key-features)\n- [🏗️ System Architecture](#-system-architecture)\n- [🛠️ Technology Stack](#-technology-stack)\n- [🚀 Getting Started](#-getting-started)\n- [⚙️ Configuration](#-configuration)\n- [🎮 Usage](#-usage)\n- [📚 API Documentation](#-api-documentation)\n- [🧪 Testing](#-testing)\n- [🚀 Deployment](#-deployment)\n- [🤝 Contributing](#-contributing)\n- [📜 License](#-license)\n- [📬 Support](#-support)\n\n---\n\n## 🌟 Overview\nTraceFlow revolutionizes Enda Tao’s operational workflows by digitizing and optimizing key processes. It integrates:\n- **Timesheet Management**: Streamlined creation, validation, and AI-driven scheduling. 📅\n- **Visit Tracking**: Real-time geolocation and QR code-based logging. 📍\n- **Receipt Book Traceability**: Secure tracking with QR codes and OTP. 📚\n- **AI Analytics**: Anomaly detection and actionable insights. 🤖\n- **Dynamic Dashboards**: Role-specific, multilingual interfaces. 📊\n- **Real-Time Notifications**: WebSocket-driven alerts for instant updates. 🔔\n\nBuilt for scalability and security, TraceFlow leverages modern technologies to ensure efficiency, traceability, and accountability.\n\n---\n\n## 🔥 Key Features\n- **Timesheet Management** 📅\n  - Create, edit, validate, and delete timesheets with role-based access.\n  - AI-generated suggestions (up to 5 per request) for optimized scheduling.\n  - Filter by week, year, or role (e.g., Supervisor, HR).\n- **Visit Tracking** 📍\n  - Log visits via QR code scanning and OTP validation.\n  - Google Maps integration for real-time agent tracking, route optimization, and nearby agent detection.\n  - Filter by regions, governorates, or delegations.\n- **Receipt Book Traceability** 📚\n  - Secure tracking with QR codes and OTP for books and stubs.\n  - Transfer history, stock management, and validation for Purchase Team and Stock Manager roles.\n  - Comprehensive audit trails.\n- **AI-Powered Analytics** 🤖\n  - Anomaly detection with a 0.95 confidence threshold.\n  - Automated report generation for Directors and Admins.\n- **Dynamic Dashboards** 📊\n  - Interactive, role-specific KPIs with dark mode support.\n  - Multilingual: English, French, Arabic.\n- **Real-Time Notifications** 🔔\n  - WebSocket-based alerts for timesheet approvals, visit logs, and receipt transfers.\n  - Configurable notification rules.\n- **Secure Authentication** 🔒\n  - Keycloak with OAuth2 and Google Auth integration.\n  - Token lifespans: Access (15 min), Refresh (1 day), SSO Session (1 day, idle: 9 hours).\n- **Rate Limiting** ⚡\n  - Sensitive operations: 10 requests/10 min.\n  - OTP and refresh token limits for security.\n- **Logging** 📜\n  - 30-day retention with log statistics, filters, and health metrics.\n  - Max page size: 500, default: 50.\n\n\u003e **Tip**: TraceFlow supports up to 5 file downloads per session for reports and logs.\n\n---\n\n## 🏗️ System Architecture\nTraceFlow’s modular architecture ensures scalability and maintainability:\n- **Frontend (Web)**: React with TypeScript, Vite, and Tailwind CSS for responsive dashboards.\n- **Frontend (Mobile)**: Flutter for cross-platform Android/iOS apps.\n- **Backend**: Node.js with Express.js for API, authentication, and WebSocket communication.\n- **Database**: PostgreSQL for relational data, Redis for caching.\n- **AI Engine**: Ollama with Mistral model for analytics and suggestions.\n- **Authentication**: Keycloak for SSO, Google OAuth2 for Maps and Calendar.\n- **Infrastructure**: Docker for containerization, NGINX for reverse proxy, PM2 for process management.\n\n\u003cdetails\u003e\n\u003csummary\u003e📊 Architecture Diagram\u003c/summary\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://via.placeholder.com/600x300.png?text=TraceFlow+Architecture+Diagram\" alt=\"TraceFlow Architecture Diagram\" /\u003e\n\u003c/p\u003e\n\u003c/details\u003e\n\n---\n\n## 🛠️ Technology Stack\nTraceFlow leverages a modern, robust tech stack, showcased with GitHub-style badges for clarity and visual appeal:\n\n| **Category**            | **Technologies**                                                                 |\n|-------------------------|---------------------------------------------------------------------------------|\n| **Frontend (Web)**      | [![React](https://img.shields.io/badge/React-v18-61DAFB?logo=react)](https://reactjs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-v5-3178C6?logo=typescript)](https://www.typescriptlang.org/) [![Vite](https://img.shields.io/badge/Vite-v4-646CFF?logo=vite)](https://vitejs.dev/) [![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-v3-38B2AC?logo=tailwind-css)](https://tailwindcss.com/) |\n| **Frontend (Mobile)**   | [![Flutter](https://img.shields.io/badge/Flutter-v3.29-02569B?logo=flutter)](https://flutter.dev/) [![Dart](https://img.shields.io/badge/Dart-v3.7-0175C2?logo=dart)](https://dart.dev/) |\n| **Backend**             | [![Node.js](https://img.shields.io/badge/Node.js-v22.14-339933?logo=node.js)](https://nodejs.org/) [![Express.js](https://img.shields.io/badge/Express.js-v4-000000?logo=express)](https://expressjs.com/) |\n| **Database**            | [![PostgreSQL](https://img.shields.io/badge/PostgreSQL-v9-4169E1?logo=postgresql)](https://www.postgresql.org/) [![Redis](https://img.shields.io/badge/Redis-Latest-DC382D?logo=redis)](https://redis.io/) |\n| **Authentication**      | [![Keycloak](https://img.shields.io/badge/Keycloak-SSO-4B5EAA?logo=keycloak)](https://www.keycloak.org/) [![Google OAuth2](https://img.shields.io/badge/Google_OAuth2-v2-4285F4?logo=google)](https://developers.google.com/identity) |\n| **AI Engine**           | [![Ollama](https://img.shields.io/badge/Ollama-Mistral-FF6F61?logo=ai)](https://ollama.ai/) |\n| **Real-Time**           | [![WebSockets](https://img.shields.io/badge/WebSockets-Enabled-FFCA28?logo=websocket)](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) |\n| **API Docs**            | [![Swagger](https://img.shields.io/badge/Swagger-Redoc-85EA2D?logo=swagger)](https://swagger.io/) |\n| **Testing**             | [![Jest](https://img.shields.io/badge/Jest-v29-99424F?logo=jest)](https://jestjs.io/) [![Postman](https://img.shields.io/badge/Postman-API-F76935?logo=postman)](https://www.postman.com/) [![Flutter Test](https://img.shields.io/badge/Flutter_Test-v3-02569B?logo=flutter)](https://flutter.dev/docs/testing) |\n| **Infrastructure**      | [![Docker](https://img.shields.io/badge/Docker-Enabled-2496ED?logo=docker)](https://www.docker.com/) [![NGINX](https://img.shields.io/badge/NGINX-Reverse_Proxy-009639?logo=nginx)](https://nginx.org/) [![PM2](https://img.shields.io/badge/PM2-Process_Mgr-2B037A?logo=pm2)](https://pm2.keymetrics.io/) |\n| **External Services**   | [![Google Maps](https://img.shields.io/badge/Google_Maps-API-4285F4?logo=google-maps)](https://developers.google.com/maps) [![Google Calendar](https://img.shields.io/badge/Google_Calendar-API-4285F4?logo=google)](https://developers.google.com/calendar) [![WBM.tn SMS](https://img.shields.io/badge/WBM.tn-v3/v5-FF5733)](https://wbm.tn/) [![Gmail SMTP](https://img.shields.io/badge/Gmail-SMTP-D14836?logo=gmail)](https://support.google.com/mail) |\n| **Logging**             | Custom logger (30-day retention, log filters, metrics) |\n| **CSV Processing**      | UTF-8 (fallback: win1252), comma-delimited, JSON config |\n\n---\n\n## 🚀 Getting Started\n\n### Prerequisites\n- [![Node.js](https://img.shields.io/badge/Node.js-v22.14+-339933?logo=node.js)](https://nodejs.org/) Node.js v22.14 or later\n- [![PostgreSQL](https://img.shields.io/badge/PostgreSQL-v9-4169E1?logo=postgresql)](https://www.postgresql.org/) PostgreSQL with pgAdmin4 v9\n- [![Redis](https://img.shields.io/badge/Redis-Latest-DC382D?logo=redis)](https://redis.io/) Redis (latest stable)\n- [![Docker](https://img.shields.io/badge/Docker-Enabled-2496ED?logo=docker)](https://www.docker.com/) Docker for Keycloak and Redis\n- [![Flutter](https://img.shields.io/badge/Flutter-v3.29-02569B?logo=flutter)](https://flutter.dev/) Flutter v3.29, Dart 3.7\n- [![Git](https://img.shields.io/badge/Git-Clone-F05032?logo=git)](https://git-scm.com/) Git for repository access\n\n### Installation\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/CodeWizard-404/traceflow.git\n   cd traceflow\n   ```\n\n2. **Install Backend Dependencies**:\n   ```bash\n   cd Back\n   npm install\n   ```\n\n3. **Install Frontend (Web) Dependencies**:\n   ```bash\n   cd ../Front\n   npm install\n   ```\n\n4. **Install Mobile Dependencies**:\n   ```bash\n   cd ../Mobile\n   flutter pub get\n   ```\n\n5. **Set Up Database**:\n   - Create a PostgreSQL database: `traceflow_db`.\n   - Run migrations:\n     ```bash\n     cd Back\n     npm run migrate\n     ```\n\n6. **Start Docker Containers**:\n   - Launch Keycloak and Redis:\n     ```bash\n     docker-compose up -d\n     ```\n\n---\n\n## ⚙️ Configuration\nConfiguration is managed via `.env` files included in the repository. Key settings are detailed below:\n\n### Backend `.env`\n\u003cdetails\u003e\n\u003csummary\u003e🔍 View Backend Configuration\u003c/summary\u003e\n\n- **Database**:\n  - Host: `localhost:5432`\n  - User: `postgres`\n  - Password: `admin`\n  - Database: `traceflow_db`\n- **URLs**:\n  - Development: `http://localhost`\n  - Production: `https://localhost`\n  - Frontend: `http://localhost:5173`, `http://192.168.1.21:5173`, `http://192.168.1.100`\n  - Login: `http://localhost:5173/login`\n  - Redirect: `http://localhost:5000/api/auth/callback`\n- **Keycloak**:\n  - URL: `http://localhost:8080`\n  - Realm: `TraceFlow`\n  - Client ID: `traceflow-backend`\n  - Client Secret: `9FQJDVvEU3MZvB9CGxuM50IcTVOapED7`\n  - Admin: Configured for administrative access\n- **Google APIs**:\n  - Maps API Key: `AIzaSyDkbpHSSJc-fsV5fcwYkSxk0Mq0RNCAb7g`\n  - Calendar Client ID: `803294683158-1o22qb2cda9c5mgvj5dhn8pdcn11jo45.apps.googleusercontent.com`\n  - Calendar Redirect URI: `http://localhost:5000/api/auth/google-calendar-auth/callback`\n- **Redis**:\n  - Host: `localhost:6379`\n  - Cluster: Disabled\n- **Ollama (AI)**:\n  - URL: `http://localhost:11434/api`\n  - Model: `mistral`\n  - Timeout: 5 minutes\n  - Max Retries: 3\n  - Anomaly Threshold: 0.95\n  - Max Timesheet Suggestions: 5\n- **SMTP**:\n  - Host: `smtp.gmail.com:587`\n  - Configured with app-specific credentials\n- **SMS**:\n  - WBM.tn API (v5): `https://wbm.tn/wbmonitor/send/webapi/v5/`\n  - API Key: `9c5362a406e609d0ecc6f9a0e129c0a6`\n  - WBM.tn API (v3): `https://wbm.tn/wbmonitor/send/webapi/v3/send_ack.php`\n  - Username: `enda-cash`\n  - Password: Configured for secure access\n- **Rate Limiting**:\n  - Sensitive Operations: 10 requests/10 min\n  - OTP: 10 requests/10 min\n  - Refresh Tokens: 5 requests/10 min\n- **Logging**:\n  - Level: `info`\n  - Retention: 30 days\n  - Secret: Configured for secure logging\n  - Sample Rate: 1\n- **CSV Processing**:\n  - Encoding: `utf8` (fallback: `win1252`)\n  - Delimiter: `,`\n  - Config Path: `./config/csv-config.json`\n- **Roles**:\n  - Super Admin, Admin, Director, Regional Manager, Supervisor, Purchase Team, Stock Manager, HR\n- **Initialization**:\n  - Enabled: Database, SMTP, SMS, Redis, Google Services, WebSocket, etc.\n- **Vault**:\n  - Address: `http://127.0.0.1:8200`\n  - Token: Configured for secret management\n- **mDNS**: Enabled for local discovery\n\u003c/details\u003e\n\n### Frontend `.env`\n\u003cdetails\u003e\n\u003csummary\u003e🔍 View Frontend Configuration\u003c/summary\u003e\n\n- **API**:\n  - URL: `http://192.168.1.21:5000/api`\n  - Timeout: 30 seconds\n  - Access Token Lifespan: 15 minutes\n- **Keycloak**: Matches backend configuration\n- **Google APIs**: Configured for Maps and Calendar\n- **Permissions** (Selected):\n  - **Users**: `access_all_users`, `create_users`, `update_users`, `delete_users`\n  - **Timesheets**: `access_all_timesheets`, `validate_timesheets`, `suggest_timesheets`\n  - **Visits**: `scan_visits`, `log_visits`, `sync_calendar`\n  - **Receipt Books**: `transfer_receipt_books`, `validate_receipt_stubs`, `access_receipt_book_history`\n  - **Agents**: `access_agents_by_location`, `update_agents_location`, `access_nearby_agents`\n  - **Notifications**: `trigger_notifications`, `manage_notification_rules`\n  - **Logs**: `view_logs`, `archive_logs`, `export_logs`, `view_logger_metrics`\n  - **Reports**: `generate_report`, `schedule_report`, `download_report`\n  - **AI**: `access_ai_anomaly_detection`, `manage_ai_config`\n- **Roles**: Matches backend roles\n- **Checklist Items**:\n  - `Transfer a receipt book`\n  - `Collect receipt stub`\n\u003c/details\u003e\n\n### Mobile Configuration\n\u003cdetails\u003e\n\u003csummary\u003e🔍 View Mobile Configuration\u003c/summary\u003e\n\n- **Base URL**: `http://192.168.1.21:5000/api`\n- **Keycloak**:\n  - URL: `http://localhost:8080`\n  - Realm: `TraceFlow`\n  - Client ID: `traceflow-backend`\n  - Client Secret: `9FQJDVvEU3MZvB9CGxuM50IcTVOapED7`\n  - Redirect URI: `http://localhost:8080/realms/TraceFlow/broker/google/endpoint`\n- **Google**:\n  - Web Client ID: `803294683158-1o22qb2cda9c5mgvj5dhn8pdcn11jo45.apps.googleusercontent.com`\n  - Android Client ID: `803294683158-jf323a7qjjo3nfblgl2nao9il1fgroia.apps.googleusercontent.com`\n  - iOS Client ID: `803294683158-47b4jojal7je374cr7n4qh7ra47pcttq.apps.googleusercontent.com`\n\u003c/details\u003e\n\n### Additional Setup\n- **Keycloak**:\n  - Admin Console: `http://localhost:8080`\n  - Configure `TraceFlow` realm, clients, and roles.\n- **Google APIs**:\n  - Enable Maps and Calendar APIs in Google Cloud Console.\n  - Update `.env` files with credentials.\n- **SSL (Production)**:\n  - Paths: `/etc/ssl/private/key.pem`, `/etc/ssl/certs/cert.pem`\n- **Vault**:\n  - Address: `http://127.0.0.1:8200`\n  - Token: Configured for secure secrets.\n\n---\n\n## 🎮 Usage\n- **Web Application**:\n  - Start backend:\n    ```bash\n    cd Back\n    npm start\n    ```\n  - Start frontend:\n    ```bash\n    cd ../Front\n    npm run dev\n    ```\n  - Access: `http://localhost:5173`\n- **Mobile Application**:\n  - Run Flutter app:\n    ```bash\n    cd Mobile\n    flutter run\n    ```\n\n### Example Workflows\n- **Log a Visit** 📍:\n  - Scan QR code, enter OTP, complete checklist (e.g., “Transfer a receipt book”).\n  - View agent locations on Google Maps.\n- **Manage Timesheets** 📅:\n  - Create timesheets, review AI suggestions, and validate via web interface.\n  - Filter by week, year, or role.\n- **Track Receipt Books** 📚:\n  - Scan QR codes to transfer books or collect stubs.\n  - Validate transfers or view history.\n- **Generate Reports** 📊:\n  - Schedule AI-driven reports or download (max 5 per session).\n  - Analyze anomalies (0.95 threshold).\n\n---\n\n## 📚 API Documentation\n- Access Swagger docs: `http://localhost:5000/api-docs`\n- Key Endpoints:\n  - **Users**: `/api/users`, `/api/roles/assign`, `/api/users/by-role`\n  - **Timesheets**: `/api/timesheets`, `/api/timesheets/suggest`, `/api/timesheets/validate`\n  - **Visits**: `/api/visits`, `/api/visits/scan`, `/api/visits/sync-calendar`\n  - **Receipt Books**: `/api/receipt-books`, `/api/receipt-books/transfer`, `/api/receipt-books/history`\n  - **Agents**: `/api/agents`, `/api/agents/locations`, `/api/agents/nearby`\n  - **Notifications**: `/api/notifications`, `/api/notifications/rules`\n  - **Logs**: `/api/logs`, `/api/logs/export`, `/api/logs/statistics`\n  - **Reports**: `/api/reports/generate`, `/api/reports/schedule`\n\n---\n\n## 🧪 Testing\n- **Unit Tests**:\n  - Backend:\n    ```bash\n    cd Back\n    npm test\n    ```\n  - Mobile:\n    ```bash\n    cd Mobile\n    flutter test\n    ```\n- **API Tests**:\n  - Use Postman collections in `Back/tests`.\n- **Coverage**:\n  - Target 80%+ coverage for critical modules.\n\n---\n\n## 🚀 Deployment\n- **Development**:\n  - Set `NODE_ENV=development`.\n  - Start services:\n    ```bash\n    docker-compose up -d\n    ```\n- **Production**:\n  - Set `NODE_ENV=production` and update `PROD_URL`.\n  - Configure NGINX:\n    ```bash\n    nginx -s reload\n    ```\n  - Manage Node.js with PM2:\n    ```bash\n    pm2 start Back/app.js --name traceflow-backend\n    ```\n  - Deploy with Docker:\n    ```bash\n    docker-compose -f docker-compose.prod.yml up -d\n    ```\n  - Enable HTTPS with SSL certificates.\n\n---\n\n## 🤝 Contributing\nContributions are welcome to enhance TraceFlow’s capabilities.\n- **Issues**: Report bugs or suggest features via [GitHub Issues](https://github.com/CodeWizard-404/traceflow/issues).\n- **Pull Requests**:\n  - Fork the repository.\n  - Create a branch: `git checkout -b feature/your-feature`.\n  - Commit changes and submit a pull request.\n- **Guidelines**:\n  - Follow ESLint, TypeScript, and Dart standards.\n  - Include unit tests.\n  - Provide detailed PR descriptions.\n\n---\n\n## 📜 License\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n---\n\n## 📬 Support\nFor inquiries or issues, please use [GitHub Issues](https://github.com/CodeWizard-404/traceflow/issues). Additional support is available through the platform’s official channels.\n\n---\n\n**TraceFlow** – Empowering Enda Tao with AI-driven efficiency, traceability, and scalability. 🌍\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewizard-404%2Ftraceflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodewizard-404%2Ftraceflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewizard-404%2Ftraceflow/lists"}