docs: add structure.md, update files.md, rewrite README for GitHub, add favicon, replace debug prints with logging, remove stale src/ copy and empty dirs

apps/coordinator-api/src/app/routers/exchange.py

@@ -8,6 +8,9 @@ import uuid
 import time
 import json
 import os
+import logging
+
+logger = logging.getLogger(__name__)
 
 from ..schemas import ExchangePaymentRequest, ExchangePaymentResponse
 from ..services.bitcoin_wallet import get_wallet_balance, get_wallet_info
@@ -109,7 +112,7 @@ async def confirm_payment(
         from ..services.blockchain import mint_tokens
         mint_tokens(payment['user_id'], payment['aitbc_amount'])
     except Exception as e:
-        print(f"Error minting tokens: {e}")
+        logger.error("Error minting tokens: %s", e)
         # In production, handle this error properly
     
     return {

apps/coordinator-api/src/app/routers/governance.py

@@ -7,6 +7,9 @@ from pydantic import BaseModel, Field
 from typing import Optional, Dict, Any, List
 from datetime import datetime, timedelta
 import json
+import logging
+
+logger = logging.getLogger(__name__)
 
 from ..schemas import UserProfile
 from ..storage import SessionDep
@@ -349,7 +352,7 @@ async def execute_parameter_change(target: Dict[str, Any], background_tasks):
     """Execute a parameter change proposal"""
     
     # This would update system parameters
-    print(f"Executing parameter change: {target}")
+    logger.info("Executing parameter change: %s", target)
     # Implementation would depend on the specific parameters
 
 
@@ -357,7 +360,7 @@ async def execute_protocol_upgrade(target: Dict[str, Any], background_tasks):
     """Execute a protocol upgrade proposal"""
     
     # This would trigger a protocol upgrade
-    print(f"Executing protocol upgrade: {target}")
+    logger.info("Executing protocol upgrade: %s", target)
     # Implementation would involve coordinating with nodes
 
 
@@ -365,7 +368,7 @@ async def execute_fund_allocation(target: Dict[str, Any], background_tasks):
     """Execute a fund allocation proposal"""
     
     # This would transfer funds from treasury
-    print(f"Executing fund allocation: {target}")
+    logger.info("Executing fund allocation: %s", target)
     # Implementation would involve treasury management
 
 
@@ -373,7 +376,7 @@ async def execute_policy_change(target: Dict[str, Any], background_tasks):
     """Execute a policy change proposal"""
     
     # This would update system policies
-    print(f"Executing policy change: {target}")
+    logger.info("Executing policy change: %s", target)
     # Implementation would depend on the specific policy