🚀 WFlow - Freelance & Job Management Platform

A comprehensive freelance and job management platform connecting businesses with skilled workers

📋 Table of Contents

• Features
• Screenshots
• Architecture
• Tech Stack
• Getting Started
• Project Structure
• Key Components
• API Integration
• State Management
• Contributing
• License

✨ Features

🏢 For Businesses

• 📝 Job Posting: Create and manage job postings with detailed requirements
• 👥 Candidate Management: Review and manage job applications
• 📊 Excel Integration: Bulk upload tasks via Excel files
• 💼 Contract Management: Create, sign, and track contracts
• 💰 Payment System: Secure payment processing with balance management
• 📈 Progress Tracking: Monitor project progress with visual indicators

👷 For Workers

• 🔍 Job Search: Advanced search and filtering capabilities
• 📄 CV Management: Upload and manage multiple CVs
• ⭐ Bookmark Jobs: Save interesting job opportunities
• 💬 Real-time Chat: Communicate with employers
• 🎙️ Voice Messages: Send voice recordings in chat
• 📱 Identity Verification: AI-powered ID and face verification

🌟 General Features

• 🌐 Multi-language Support: Vietnamese and English localization
• 🔐 Secure Authentication: OAuth integration with Google Sign-In
• 📲 Push Notifications: Real-time notifications via Firebase
• 🎨 Modern UI/UX: Material Design with custom theming
• 📱 Cross-platform: Native iOS and Android support

📱 Screenshots

Home Screen	Job Search	Chat Interface	Profile

🏗️ Architecture

WFlow follows Clean Architecture principles with BLoC Pattern for state management:

lib/
├── 🎯 core/           # Core utilities and shared components
├── 📊 common/         # Common services (DI, localization, etc.)
├── ⚙️ configuration/  # App configuration and constants
├── 🧩 modules/        # Feature modules
│   ├── 🔐 auth/       # Authentication module
│   ├── 📖 introduction/ # Onboarding module
│   └── 🏠 main/       # Main app features
│       ├── 📡 data/   # Data layer (repositories, models)
│       ├── 🎯 domain/ # Business logic (entities, use cases)
│       └── 🎨 presentation/ # UI layer (screens, widgets, BLoC)

🛠️ Tech Stack

Frontend

• Flutter 3.x - Cross-platform UI framework
• Dart - Programming language
• BLoC Pattern - State management
• Get_It - Dependency injection
• Auto Route - Navigation management

Backend Integration

• HTTP/REST APIs - Backend communication
• Firebase - Authentication & Push notifications
• Stringee - Video/Voice calling integration

Key Packages

dependencies:
  flutter_bloc: ^8.1.3 # State management
  get_it: ^7.6.4 # Dependency injection
  cached_network_image: ^3.3.0 # Image caching
  file_picker: ^6.1.1 # File selection
  flutter_screenutil: ^5.9.0 # Responsive design
  voice_message_package: ^2.1.3 # Voice messaging
  stringee_flutter_plugin: ^0.8.8 # Video calls

🚀 Getting Started

Prerequisites

• Flutter SDK (3.0.0 or higher)
• Dart SDK (2.17.0 or higher)
• Android Studio / VS Code
• iOS development setup (for iOS builds)

Installation

1. Clone the repository

   git clone https://github.com/username/wflow.git
   cd wflow

2. Install FVM (Flutter Version Management)

   dart pub global activate fvm
   fvm install
   fvm use

3. Install dependencies

   fvm flutter pub get

4. Setup environment

   cp .env.example .env
   # Edit .env with your configuration

5. Run the application

   # Development
   fvm flutter run --flavor dev
   
   # Production
   fvm flutter run --flavor prod

Build Commands

# Android APK
make build-apk

# Android Bundle
make build-appbundle

# iOS
make build-ios

📁 Project Structure

wflow/
├── 📱 android/                 # Android-specific code
├── 🍎 ios/                     # iOS-specific code
├── 🐧 linux/                   # Linux desktop support
├── 🪟 windows/                 # Windows desktop support
├── 🖥️ macos/                   # macOS desktop support
├── 📦 assets/                  # Static assets
│   ├── 🎨 icons/              # App icons
│   ├── 🌍 languages/          # Localization files
│   └── 🎬 anim/               # Lottie animations
├── ⚙️ configs/                 # Configuration files
├── 📜 scripts/                 # Build and deployment scripts
└── 📚 lib/                     # Main application code

🔑 Key Components

🏠 Main Features

Job Management

• PostUseCase - Job posting operations
• ContractUseCase - Contract management
• UpPostBloc - Job posting state management

Messaging System

• MainChat - Chat interface
• Record - Voice recording
• BoxChat - Message input

Identity Verification

• AuthenticationsBloc - ID verification logic
• AuthenticationUseCase - Verification business logic

🔧 Core Services

Dependency Injection

// lib/common/injection.dart
final GetIt instance = GetIt.instance;

Localization

// lib/common/localization.dart
AppLocalization localization = instance.get<AppLocalization>();
String text = localization.translate('key');

🌐 API Integration

HTTP Client Configuration

// Base URL configuration
const String baseUrl = 'https://api.wflow.com';

// Request/Response models
class UpgradeBusinessRequest {
  final String email;
  final String phone;
  final String name;
  // ... other fields
}

File Upload

// File upload for business logos, CVs, etc.
final response = await fileUseCase.uploadFile(
  request: UploadFileRequest(
    folder: 'Business',
    file: selectedFile,
  ),
);

🎯 State Management

BLoC Pattern Implementation

// Example: Job posting BLoC
class UpPostBloc extends Bloc<UpPostEvent, UpPostState> {
  final PostUseCase postUseCase;

  UpPostBloc({required this.postUseCase}) : super(UpPostState()) {
    on<UpPostAddTaskEvent>(_addTask);
    on<UpPostSubmitEvent>(_submitPost);
  }

  Future<void> _addTask(UpPostAddTaskEvent event, Emitter emit) async {
    // Task addition logic
  }
}

State Classes

class UpPostState {
  final List<String> tasks;
  final bool isLoading;
  final String? error;

  const UpPostState({
    this.tasks = const [],
    this.isLoading = false,
    this.error,
  });
}

🔒 Security Features

• 🔐 JWT Token Management - Secure authentication
• 📱 Device Token Verification - Device-based security
• 🆔 AI-powered ID Verification - Face matching and document validation
• 🔒 Secure Storage - Encrypted local data storage

🌍 Internationalization

Supported Languages

• 🇻🇳 Vietnamese (vi)
• 🇺🇸 English (en)

Usage

Text(instance.get<AppLocalization>().translate('welcome') ?? 'Welcome')

🧪 Testing

# Run unit tests
flutter test

# Run integration tests
flutter test integration_test/

# Generate coverage report
flutter test --coverage

📱 Platform Support

Platform	Status	Version
🤖 Android	✅ Supported	API 21+
🍎 iOS	✅ Supported	iOS 11+
🐧 Linux	🚧 In Development	-
🪟 Windows	🚧 In Development	-
🖥️ macOS	🚧 In Development	-

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support

• 📧 Email: support@wflow.com
• 🌐 Website: wflow.site
• 📚 Documentation: docs.wflow.com

---

Made with ❤️ by the WFlow Team