EV Power / Engineering Docs
v2.2.0-PROD
Portal SRS SDD Compliance
EV POWER MOBILE PLATFORM • vn.evpower.charging

Engineering Specifications & Architecture Portal

Authoritative technical documentation governing system requirements, high-performance mobile architecture, and open source software licensing for the EV Power electric vehicle charging application across Vietnam.

Runtime: Expo SDK ~58.0.19 Framework: React Native 0.88.0 (Bridgeless) Architecture: Fabric TurboModules Protocols: OCPP 1.6-J / 2.0.1 Currency Rate: 1 EVP = 1,000 VND Storage: AES-256 SecureStore
Official Engineering Specifications PRODUCTION BASELINE 2.2.0
IEEE Std 830-1998 Approved Baseline

Software Requirements Specification (SRS)

Authoritative contractual specification governing 8 core subsystems, optical QR code recognition, 5-phase charging state machine, RFID charge cards, EVP wallet ledger, and statutory VAT invoicing.

  • 5-Step Charging Session Lifecycle & Telemetry Polling
  • AC Cyan Power Beam vs DC Emerald Shimmer Flow
  • Double-Entry EVP Ledger (1 EVP = 1,000 VND)
  • Physical RFID Charge Cards (charge-card) Lifecycle
  • Full Requirements Traceability Matrix (RTM)
Read Specification
IEEE Std 1016-2009 Architecture Approved

Software Design Description (SDD)

Comprehensive low-level design describing Clean Layered Architecture, decoupled Expo Router topology, Zustand multi-session isolation, Reanimated UI worklets (~15 FPS), and In-Tree Fabric overlays.

  • Clean Layered Architecture & Data Flow (Fig 2.1)
  • Dedicated Charging Routes: connect, session, setup
  • StoppingChargeOverlay In-Tree Absolute Viewport Pattern
  • Cold-Pressed Watercolor Paper Material Architecture
  • DEF-05/13/14/25 State Machine Resiliency Invariants
Read Architecture
SBOM & License Audit Zero Copyleft Risk

Open Source Software (OSS) Compliance

Software Bill of Materials (SBOM) and intellectual property licensing audit across all 60 dependencies (59 open source + 1 in-house proprietary SDK), verifying 100% permissive open source licenses and complete commercial compliance.

  • 60-Package Dependency Catalog & Version Matrix
  • 100% Permissive Licenses: MIT, Apache-2.0, BSD-2-Clause
  • 0% Copyleft Risk (GPL/AGPL clean)
  • PCI-DSS SAQ A Exemption for VNPay WebView
  • Cryptography EAR 740.17(b)(2) Self-Classification
View Compliance Report
Key Architecture Pillars SYSTEM OVERVIEW

Charging Engine

5-phase finite state machine with contactor interlocks, live 10s telemetry polling, AC power beam flow (PowerFlowBar), DC emerald shimmer, and in-tree settlement blur.

EVP Digital Wallet

Double-entry point ledger with invariant 1 EVP = 1,000 VND, minimum 100 EVP charging rule, VNPay in-app webview integration, and immutable transaction audit trail.

RFID & Fleet Garage

Physical RFID card catalog (charge-card), scratch card PIN redemption, multi-vehicle fleet garage, VIN association, and per-vehicle session spending ceilings.

Bridgeless & Materials

React Native 0.88 Bridgeless Mode, Reanimated worklets (65ms / ~15 FPS), tactile card surfaces, and frosted ambient glow.

Platform Specifications Matrix RUNTIME SPECIFICATIONS
Architecture Layer Technology Baseline Standard & Implementation Details
Mobile Framework Expo SDK ~58.0.19 • React Native 0.88.0 React Native Bridgeless Mode with Fabric TurboModules architecture (zero legacy bridge overhead).
File Navigation Expo Router ~58.0.26 Decoupled file-based routing, deep link URI resolution, nested tabs, modal sheets, normalized parameter aliases.
State & Cache Zustand 5 • TanStack Query 5.62 Client state isolation with composite keys (${chargeBoxCode}_${connectorNo}), 30s staleTime, 5m gcTime, zero unmount eviction.
Network & Mutex Axios 1.7.7 • Dual-Instance Public/Protected split, dynamic microservice path construction, thread-safe 401 token refresh queue with rotatedByOtherFlow.
Security & Enclave Expo SecureStore ~58.0.2 Hardware-backed iOS Keychain & Android KeyStore AES-256 cryptographic token persistence.