1  # F003-governor_console.component.cspec
  2  
  3  metadata:
  4    id: F003
  5    name: governor_console
  6    version: 1.1.0
  7    domain: frontend
  8    stability: stable
  9    updated: 2026-01-15
 10    cascade_priority: 30
 11    roles:
 12      primary: [Dev]
 13      review: [Security, Arch]
 14    expertise:
 15      required: [react, typescript]
 16      helpful: [multisig, institutional]
 17    context_tags: [governor, institutional, minting, governance, admin]
 18  
 19  dependencies:
 20    upstream: [F001, F008, F009]
 21    downstream: []
 22  
 23  interface:
 24    types_ref: _registry/types.cspec
 25    types:
 26      governor: {role: central_bank, permissions: [mint, vote, whitelist]}
 27      mint_request: {amount: u128, recipient: address, reason: string}
 28      whitelist_entry: {id_code: string, status: active|revoked}
 29  
 30    functions:
 31      mint_alpha: {inputs: [amount, recipient], outputs: [tx_id]}
 32      create_proposal: {inputs: [proposal_data], outputs: [proposal_id]}
 33      vote_proposal: {inputs: [proposal_id, vote], outputs: [tx_id]}
 34      add_whitelist: {inputs: [id_code], outputs: [status]}
 35      remove_whitelist: {inputs: [id_code], outputs: [status]}
 36  
 37    events:
 38      - mint_executed
 39      - proposal_created
 40      - vote_cast
 41      - whitelist_updated
 42  
 43  spec:
 44    # === PURPOSE ===
 45    purpose: Minimal administrative interface for Central Bank Governors
 46  
 47    # === DESIGN PRINCIPLES ===
 48    design:
 49      aesthetic: "easy_button"
 50      principles:
 51        - minimal_clutter
 52        - large_touch_targets
 53        - confirmation_for_all_actions
 54        - clear_status_indicators
 55        - no_trading_features
 56  
 57    # === STRUCTURE ===
 58    structure:
 59      acdc-governor/:
 60        web/: primary_react
 61        mobile/: voting_capability_react_native
 62  
 63    # === SCREENS ===
 64    screens:
 65      dashboard:
 66        - status_overview
 67        - recent_activity
 68        - pending_actions
 69      mint:
 70        - mint_form
 71        - mint_confirm
 72        - mint_history
 73      governance:
 74        - proposals_list_alpha_delta
 75        - proposal_detail
 76        - vote_interface
 77        - create_proposal
 78      config:
 79        - multisig_management
 80        - whitelist_management
 81        - api_integrations
 82  
 83    # === MINTING WORKFLOW ===
 84    minting:
 85      flow:
 86        1: initiate_mint_request
 87        2: multisig_approval_if_configured
 88        3: confirm_with_2fa
 89        4: execute_mint
 90        5: display_confirmation
 91      safeguards:
 92        - amount_limits
 93        - recipient_validation
 94        - reason_required
 95        - audit_log
 96  
 97    # === GOVERNANCE ===
 98    governance:
 99      alpha_proposals:
100        - view_alpha_chain_proposals
101        - vote_as_governor (1_gov=1_vote)
102        - config_threshold_67_percent
103        - software_threshold_90_percent
104      joint_proposals:
105        - view_platform_wide_proposals
106        - vote_alpha_side (67%)
107        - requires_delta_approval_separately
108      # Note: Delta governance is separate - governors use wallet app if they hold DX
109  
110    # === WHITELIST MANAGEMENT ===
111    whitelist:
112      purpose: off_ramp_id_codes
113      operations:
114        - add_id_code
115        - revoke_id_code
116        - query_status
117      data_boundary:
118        ecosystem_sees: [id_code, validity_status]
119        governor_keeps: [kyc_data, bank_details, identity_mapping]
120  
121    # === SECURITY ===
122    security:
123      authentication: wallet_core_signature
124      multisig: optional_m_of_n
125      audit_log: all_actions_logged
126      access_control: governor_addresses_only
127  
128  changelog:
129    - version: 1.1.0
130      date: 2026-01-15
131      type: fix
132      description: "Removed Delta governance from governor console - governance systems are separate"
133      breaking: false
134  
135    - version: 1.0.0
136      date: 2026-01-14
137      type: initial
138      description: "Initial governor console spec from UI/UX Specification v1.0"
139      breaking: false