A comprehensive national-level digital government transformation system supporting the Republic of Sudan's $700M-$1.1B digital infrastructure initiative based on your detailed transformation blueprint.
The end-to-end system blueprint/spec is captured in sudan.md. Key parts are synced into implementation files:
src/config/oidConfig.js(OID tree + ministry branches)database/init.sql(local/dev PostgreSQL schema fordocker-compose.yml)scripts/deployment/*andscripts/health-check-all.sh(ops helpers)kong/kong.ymlandnginx/nginx.conf(local gateway/edge configs)
All backend services are wired in docker-compose.yml and exposed via Kong:
- Kong Proxy:
http://localhost:8000 - Kong Admin:
http://localhost:8001
Key API prefixes:
/api/identity→identity-service(3001)/api/v1/oid→oid-service(3002)/api/v1/audit→audit-service(3004)/api/agencies,/api/requests,/api/consent,/api/stats→agency-integration(3005)/api/ussd→ussd-service(3006)/api/ai→ai-service(3007)/api/infrastructure,/api/mining,/api/agriculture,/api/health,/api/education, … →public-api(3010)/api/v1/data-quality(3011),/api/v1/fraud(3012),/api/v1/reports(3013),/api/v1/compliance(3014),/api/v1/backup(3015),/api/v1/notifications(3016),/api/v1/access(3017),/api/v1/integration(3018),/api/v1/performance(3019),/api/v1/nile-water(3020),/api/v1/farming(3021),/api/v1/gold-treasures(3022),/api/v1/ports(3023),/api/v1/education(3024),/api/v1/healthcare(3025)
Deploy local:
cd sudan-main
docker compose up -d --build
./scripts/health-check-all.shThis implementation provides a complete digital government portal system supporting:
- 40+ million citizens across Sudan's 18 states
- 11 government ministries with specialized interfaces
- OID-based digital identity for secure, standardized identification
- Mobile-first design optimized for 80% mobile usage
- Bilingual support (Arabic/English) with RTL layout
- WCAG 2.1 AA accessibility compliance for inclusive access
/Users/fadil369/oid-sudan/
├── src/
│ ├── pages/
│ │ └── SudanGovPortal.jsx # Main government portal
│ ├── components/
│ │ ├── OIDIntegration.jsx # Identity system integration
│ │ ├── MobileGovDashboard.jsx # Mobile-optimized interface
│ │ ├── AccessibilityProvider.jsx # WCAG compliance framework
│ │ ├── HealthMinistryPortal.jsx # Healthcare department portal
│ │ ├── EducationMinistryPortal.jsx # Education department portal
│ │ ├── FinanceMinistryPortal.jsx # Finance & economics portal
│ │ ├── AgricultureMinistryPortal.jsx # Agriculture department portal
│ │ └── OidTreeIntegration.jsx # BrainSAIT OID system integration
│ ├── styles/
│ │ └── sudan-government.css # Comprehensive styling
│ ├── tests/
│ │ ├── SudanGovPortal.test.jsx # Main portal tests
│ │ ├── OIDIntegration.test.jsx # Identity system tests
│ │ ├── AccessibilityProvider.test.jsx # Accessibility tests
│ │ ├── globalSetup.js # Test environment setup
│ │ └── globalTeardown.js # Test cleanup
│ ├── __mocks__/
│ │ └── fileMock.js # File mocks for testing
│ ├── setupTests.js # Jest test configuration
│ └── package.json # Project dependencies
├── jest.config.js # Testing configuration
└── README.md # This documentation
- Dashboard Overview: Real-time system metrics and citizen statistics
- 11 Government Departments:
- Citizen Identity & Civil Registry
- Health & Population Systems
- Education Ministry
- Finance & Economy
- Agriculture Ministry
- Energy & Natural Resources
- Infrastructure & Urban Planning
- Justice & Legal Systems
- Foreign Affairs
- Labor & Employment
- Social Welfare
- Service Integration Hub: Cross-departmental service coordination
- Quick Actions Panel: Emergency services and rapid verification
- Real-time Status Monitoring: System health and service availability
- Complete Citizen Profiles: Based on OID
1.3.6.1.4.1.61026.2.XX.XXX.XXXXXXXXX.X - Multi-Modal Biometrics: Fingerprint, facial, iris, and voice recognition
- Digital Certificates: X.509 certificates with RSA-4096 encryption
- QR Code Generation: For rapid identity verification
- Document Management: Birth certificates, national ID, passport integration
- Service Permissions: Granular consent management for data sharing
- Real-time Verification: Instant identity validation across services
- Touch-Optimized Interface: 44px minimum touch targets
- Swipe Navigation: Native mobile gestures and interactions
- Progressive Web App: Offline capability and app-like experience
- Bottom Navigation: Easy one-handed access to core functions
- Quick Actions Speed Dial: Floating action button for emergency services
- Notification System: Real-time government alerts and updates
- Status Bar Integration: System connectivity and battery indicators
- WCAG 2.1 AA Standard: Complete compliance framework
- Visual Accessibility: High contrast, font scaling, color blindness support
- Motor Accessibility: Sticky keys, click delays, keyboard navigation
- Auditory Accessibility: Screen reader compatibility, text-to-speech
- Cognitive Accessibility: Simplified interfaces, extended timeouts
- Multi-Language Support: Arabic/English with cultural adaptations
- Assistive Technology: Full integration with screen readers and other tools
- Medical Records Management: Comprehensive health profiles with OID integration
- Appointment Booking: Integrated scheduling system across Sudan's healthcare network
- Telemedicine Integration: Remote consultation capabilities for rural areas
- Vaccination Tracking: COVID-19 and routine immunization records
- Emergency Medical Services: Direct access to urgent care
- Health Analytics: Personal health metrics and population health monitoring
- Student Records Management: Complete academic profiles for 8.5M students
- Digital Certification System: Secure, verifiable academic credentials
- School Administration: Management of 45K schools nationwide
- Teacher Portal: Professional development and resource management
- Parent/Guardian Access: Real-time academic progress monitoring
- Examination Management: Digital test administration and results
- Tax Management System: Comprehensive tax collection for 2.5M taxpayers
- Economic Analytics: Real-time economic indicators and forecasting
- Budget Allocation: Transparent government spending across ministries
- Payment Processing: Secure digital payment infrastructure
- Revenue Tracking: Real-time monitoring of government income
- Compliance Management: Automated tax compliance and reporting
- Farmer Registration: Digital profiles for 2.8M farmers nationwide
- Land Management: Comprehensive land registration and monitoring
- Crop Analytics: AI-powered crop yield predictions and optimization
- Weather Integration: Real-time weather data and farming recommendations
- Market Information: Live commodity prices and trading opportunities
- Livestock Management: Digital tracking of 58M head of livestock
- Seamless Integration: Direct connection to existing BrainSAIT OID infrastructure
- Neural AI Enhancement: Advanced AI capabilities for government services
- Obsidian Knowledge Base: Integrated knowledge management system
- Real-time Synchronization: Live data sync between systems
- Performance Monitoring: Comprehensive system health and performance metrics
- Advanced Analytics: AI-powered insights and service optimization
- Sudan Red:
#dc2626(Flag red) - Sudan White:
#ffffff(Flag white) - Sudan Black:
#000000(Flag black) - Sudan Blue:
#1e40af(Flag blue accent)
- Primary:
#0ea5e9(Trust blue) - Secondary:
#6366f1(Government purple) - Success:
#00e676(Approval green) - Warning:
#f59e0b(Attention amber) - Error:
#ef4444(Alert red)
- Arabic: Noto Sans Arabic, Amiri, Tahoma
- English: Inter, Roboto, Helvetica Neue
- Monospace: JetBrains Mono, Fira Code, Monaco
- Mobile: 320px - 768px (Primary focus)
- Tablet: 768px - 1024px
- Desktop: 1024px+
- Sub-3 second loading on 3G networks
- Lazy loading for non-critical components
- Service worker for offline functionality
- Compressed assets and optimized images
- Progressive enhancement for older devices
- 4.5:1 minimum contrast ratio for all text
- 44px minimum touch targets for interactive elements
- Keyboard navigation for all functionality
- Screen reader compatibility with ARIA landmarks
- Focus indicators clearly visible throughout
- Text alternatives for all images and icons
- Error identification and correction guidance
- Color blindness support with multiple filters
- Reduced motion options for vestibular sensitivities
- Text scaling up to 200% without horizontal scrolling
- Simple language and clear instructions
- Multiple input methods (touch, keyboard, voice)
- End-to-end encryption (AES-256)
- Biometric data hashing (SHA-256)
- Multi-factor authentication required
- Zero-knowledge architecture for privacy
- Blockchain audit trails for transparency
- GDPR compliance built-in
- Right to be forgotten implementation
- Consent management system
- Data portability features
- Privacy by design principles
- Right-to-Left (RTL) layout switching
- Arabic typography with proper font rendering
- Cultural date formats (Hijri/Gregorian)
- Number formatting (Arabic-Indic numerals)
- Government terminology in proper Arabic context
- Seamless language switching without page reload
- Content translation for all interface elements
- Localized error messages and help text
- Cultural sensitivity in design and content
- Regional adaptations for Sudan-specific needs
- Node.js 18+ and npm/yarn
- Modern browser with ES2020 support
- Mobile device or responsive design testing tools
- Git for version control
# Clone the repository
git clone https://github.com/Fadil369/sudan.git
cd sudan
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your configuration
# Start development server
npm run start
# Build for production
npm run build
# Run tests
npm test
# Run test coverage
npm run test:coverage
# Run linting
npm run lint
# Format code
npm run format# Create .env file with the following variables:
REACT_APP_OID_BASE=1.3.6.1.4.1.61026
REACT_APP_API_BASE_URL=https://api.sd.brainsait.com/v1
REACT_APP_BLOCKCHAIN_NETWORK=sudan-mainnet
REACT_APP_BIOMETRIC_SERVICE_URL=https://biometric.sd.brainsait.com
REACT_APP_ENCRYPTION_KEY=your-encryption-key-here# (Optional) Pre-pull third-party images with retries (helps with TLS handshake timeouts)
bash scripts/pull-images.sh
# Start local services (portal, redis, postgres, kong, prometheus, grafana, etc.)
docker compose up -d --build
# Quick health checks
./scripts/health-check-all.shDefault local endpoints:
- Portal:
http://localhost:3000 - Identity service:
http://localhost:3001/health - OID service:
http://localhost:3002/health - Agency integration:
http://localhost:3005/health - USSD service:
http://localhost:3006/health - AI service:
http://localhost:3007/health - Kong proxy:
http://localhost:8000 - Prometheus:
http://localhost:9090 - Grafana:
http://localhost:3008(admin password isGRAFANA_PASSWORDindocker-compose.yml)
If your machine intermittently fails to pull images with net/http: TLS handshake timeout, it’s usually an environment/network issue (Docker Hub reachability, DNS, VPN/proxy, etc.).
Try:
bash scripts/pull-images.sh(adds retries)export DOCKER_CLIENT_TIMEOUT=180 COMPOSE_HTTP_TIMEOUT=180- Pull manually once, then re-run
docker compose up -d --build:docker pull kong/kong:3.4.2docker pull postgres:15-alpinedocker pull redis:7-alpinedocker pull grafana/grafana:10.0.0
The system includes a robust testing framework covering:
- Unit Tests: Individual component functionality
- Integration Tests: Component interaction and data flow
- Accessibility Tests: WCAG 2.1 AA compliance verification
- Performance Tests: Load testing and optimization
- Security Tests: Authentication and authorization validation
# Run all tests
npm test
# Run tests with coverage report
npm run test:coverage
# Run tests in CI environment
npm run test:ci
# Run specific test file
npm test SudanGovPortal.test.jsx
# Run tests in watch mode
npm test --watch- Statements: 70%+ coverage
- Branches: 70%+ coverage
- Functions: 70%+ coverage
- Lines: 70%+ coverage
# Build optimized production bundle
npm run build
# Serve production build locally (testing)
npm run analyze
# Deploy to staging environment
npm run deploy:staging
# Deploy to production environment
npm run deploy:production# Multi-stage Docker build for optimal size
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
FROM node:18-alpine AS runtime
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]This repository includes Cloudflare deployment scaffolding in:
.github/workflows/deploy-cloudflare.ymlwrangler.toml(Pages project config)workers.toml(Worker API config)api/index.js
Configure the following GitHub secrets before enabling deployment:
CLOUDFLARE_API_TOKENCLOUDFLARE_ACCOUNT_IDCF_PAGES_PROJECT
Configure Cloudflare resources referenced in workers.toml:
- KV namespaces (
SESSIONS,CACHE,OID_REGISTRY,CITIZEN_PROFILES) - D1 databases (
DB,ANALYTICS_DB) - R2 buckets (
DOCUMENTS,MEDIA,AUDIT_LOGS) - Durable Objects (
SESSION_DO,RATE_LIMITER,CITIZEN_STREAM)
Recommended deployment flow:
npm run cf:preflightnpm run cf:secretsnpm run cf:deploy
# Example K8s deployment configuration
apiVersion: apps/v1
kind: Deployment
metadata:
name: sudan-digital-identity
spec:
replicas: 3
selector:
matchLabels:
app: sudan-digital-identity
template:
metadata:
labels:
app: sudan-digital-identity
spec:
containers:
- name: web
image: sudan-gov/digital-identity:latest
ports:
- containerPort: 3000
env:
- name: NODE_ENV
value: "production"- National Government Portal with comprehensive dashboard and 11 ministries
- OID-based Digital Identity System with biometric authentication
- Mobile-first Responsive Design optimized for 80% mobile usage
- Bilingual Arabic/English Support with RTL/LTR layouts
- WCAG 2.1 AA Accessibility Compliance for inclusive access
- Ministry-Specific Portals (Health, Education, Finance, Agriculture)
- BrainSAIT OID System Integration with neural AI capabilities
- Comprehensive Test Suite with Jest and React Testing Library
- Advanced Accessibility Provider with real-time adjustments
- Mobile-Optimized Dashboard with PWA capabilities
- Complete CSS Design System with Sudan national branding
- Professional Documentation and setup guides
- Remaining Ministry Portals (Energy, Infrastructure, Justice, Foreign Affairs, Labor, Social Welfare)
- Blockchain Integration for immutable audit trails and transparency
- Real-time Chat Support with multilingual AI assistance
- Advanced Analytics Dashboard with predictive government insights
- Load Testing & Performance Optimization for 40M+ concurrent users
- Multi-regional Deployment across Sudan's 18 states
- API Gateway Integration for third-party government services
- Offline-First PWA capabilities for remote areas
- Advanced Biometric Systems (voice, gait, behavioral patterns)
- Citizen Feedback System with sentiment analysis
This implementation directly supports your comprehensive digital transformation blueprint:
OID Structure: Implements the hierarchical 1.3.6.1.4.1.61026 structure (see src/config/oidConfig.js)
This system seamlessly integrates with the existing BrainSAIT infrastructure:
- Direct OID Mapping: Sudan's
1.3.6.1.4.1.61026.4.1.x(ministry branches) map to BrainSAIT's corresponding OID branches - Neural AI Enhancement: Leverages BrainSAIT's advanced AI capabilities for government services
- Obsidian Sync: Real-time knowledge management integration
- Performance Monitoring: Comprehensive system health and analytics
- Bi-directional Data Flow: Seamless data synchronization between systems
- Legacy Database Compatibility: Seamless integration with existing government databases
- API Gateway: RESTful APIs for third-party government service integration
- International Standards Compliance: ISO 27001, GDPR, WCAG 2.1 AA
- Blockchain Infrastructure: Immutable audit trails and transparency
- Mobile Payment Integration: Secure digital payment processing for government services
- Identity Verification: Multi-modal biometric authentication system
- Microservices Architecture: Scalable, maintainable service-oriented design
- Cloud-Native Deployment: Kubernetes orchestration for high availability
- Progressive Web App: Offline-first capabilities for remote areas
- Real-time Synchronization: WebSocket connections for live updates
- Advanced Caching: Redis-powered caching for optimal performance
- Security-First Design: End-to-end encryption and zero-trust architecture
This implementation positions Sudan as a digital government leader by providing:
- Unified citizen experience across all government services
- International compliance with accessibility and security standards
- Mobile-optimized delivery for maximum citizen reach
- Scalable architecture supporting national growth
- Cultural authenticity with proper Arabic language support
- Future-ready platform for emerging technologies
The system serves as a foundation for Sudan's broader digital transformation goals, enabling efficient government operations, improved citizen services, and enhanced transparency while maintaining security and privacy standards appropriate for a national digital identity system.
Built for the Republic of Sudan's Digital Transformation Initiative Supporting the $700M-$1.1B investment in national digital infrastructure