Flutter Python FastAPI License Platform

Defense Contracting Opportunities Platform - Your comprehensive mobile solution for navigating federal contracting opportunities, powered by real-time data from SAM.gov and USAspending.gov.

• 🔍 Smart Opportunity Discovery: AI-powered search and filtering of federal contracting opportunities
• 📊 NAICS Dashboard: Comprehensive industry analytics with trend visualization
• 💬 AI Copilot: Intelligent assistant for contract guidance and insights
• 🔐 Enterprise Security: Biometric authentication, certificate pinning, and encrypted data storage
• 📱 Offline-First: Full functionality with intelligent caching and sync
• 🎨 Modern UI/UX: Material Design 3 with adaptive theming

• SAM.gov API: Real-time contract opportunities and entity data
• USAspending.gov: Historical spending analytics and trends
• Live ETL Pipeline: Automated data processing and enrichment
• Smart Caching: Optimized offline access with background sync

• Personalized Dashboard: Customizable widgets and saved searches
• Advanced Filtering: Multi-criteria search with NAICS code support
• Push Notifications: Real-time alerts for matching opportunities
• Profile Management: Secure user preferences and settings
• Data Usage Tracking: Monitor API consumption and cache status

lib/
├── core/ # Core utilities and services
│ ├── network/ # API client and network management
│ ├── security/ # Security services (biometric, encryption)
│ ├── theme/ # App theming and styling
│ └── widgets/ # Reusable UI components
├── features/ # Feature modules (Clean Architecture)
│ ├── authentication/ # User auth and session management
│ ├── dashboard/ # Home and profile screens
│ ├── opportunities/ # Contract opportunity browsing
│ ├── naics_dashboard/ # Industry analytics
│ └── chat/ # AI Copilot integration
└── main.dart # Application entry point

backend/
├── api/ # API endpoints and routes
├── core/ # Core business logic
├── database/ # Database models and migrations
├── external/ # External API clients (SAM.gov, USAspending)
├── services/ # Business services and ETL
└── main.py # FastAPI application

• Frontend: Flutter 3.24.5, Dart 3.5.4
• Backend: Python 3.11+, FastAPI 0.115+
• Database: SQLite (local), PostgreSQL (production-ready)
• State Management: flutter_bloc
• Networking: dio with retry logic
• Security: local_auth, flutter_secure_storage, certificate pinning
• Caching: Hive for offline-first architecture

• Flutter SDK: 3.24.5 or higher
• Dart SDK: 3.5.4 or higher
• Python: 3.11 or higher
• Git: Latest version
• IDE: VS Code or Android Studio (recommended)

git clone https://github.com/JBWolfFlow/DCOP.git
cd DCOP

# Navigate to backend directory
cd backend
# Create virtual environment
python -m venv venv
# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Create .env file
cp .env.example .env
# Edit .env with your API keys and configuration
# Initialize database
python scripts/init_production_db.py
# Start backend server
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Return to project root
cd ..
# Install Flutter dependencies
flutter pub get
# Run code generation
flutter pub run build_runner build --delete-conflicting-outputs
# Start the app
flutter run

Create a backend/.env file with the following:

# API Keys
SAM_GOV_API_KEY=your_sam_gov_api_key_here
USASPENDING_API_KEY=your_usaspending_api_key_here
# Database
DATABASE_URL=sqlite:///./dcop.db
# Security
SECRET_KEY=your_secret_key_here
JWT_SECRET_KEY=your_jwt_secret_here
JWT_ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
# API Configuration
API_BASE_URL=http://localhost:8000
CORS_ORIGINS=["http://localhost:3000","http://localhost:8080"]
# Feature Flags
ENABLE_CACHING=true
ENABLE_OFFLINE_MODE=true
CACHE_TTL_HOURS=24

# Flutter tests
flutter test
# Backend tests
cd backend
pytest
# Integration tests
flutter test integration_test/

# Generate coverage report
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html

# Build APK
flutter build apk --release
# Build App Bundle (recommended for Play Store)
flutter build appbundle --release

# Build for iOS
flutter build ios --release
# Archive for App Store
# Open Xcode and use Product > Archive

• Biometric Authentication: Face ID, Touch ID, fingerprint support
• Certificate Pinning: Prevents man-in-the-middle attacks
• Encrypted Storage: Sensitive data encrypted at rest
• Secure API Communication: HTTPS with TLS 1.3
• Token-Based Auth: JWT with refresh token rotation
• Input Validation: Comprehensive sanitization and validation

For security concerns, please email: security@dcop.app

We welcome contributions! Please see our CONTRIBUTING.md for details on:

• Code of Conduct
• Development workflow
• Pull request process
• Coding standards
• Testing requirements

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

• Lead Developer: @JBWolfFlow
• Collaborator: @hoover950

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@dcop.app

• Core opportunity search and filtering
• NAICS dashboard with analytics
• AI Copilot integration
• Offline-first architecture
• Biometric authentication
• iOS TestFlight release
• Android Play Store beta

• Advanced search with ML recommendations
• Contract award predictions
• Team collaboration features
• Enhanced analytics dashboard
• Multi-language support

• Web platform support
• Desktop applications (macOS, Windows, Linux)
• API for third-party integrations
• Enterprise SSO support
• Advanced reporting and exports

Current Version: Beta 0.9.0
Status: Active Development
Last Updated: January 2025

• ✅ Implemented offline-first caching system
• ✅ Enhanced NAICS dashboard with trend charts
• ✅ Added biometric authentication
• ✅ Integrated SAM.gov and USAspending APIs
• ✅ Completed security hardening
• 🚧 Preparing for TestFlight/Play Store beta release

• SAM.gov: Federal contract opportunity data
• USAspending.gov: Federal spending analytics
• Flutter Team: Amazing cross-platform framework
• FastAPI: High-performance Python web framework
• Open Source Community: Countless libraries and tools

GitHub stars GitHub forks GitHub watchers