MasterBook update

docs/V01_gemini/03_Dev_Environment_Runbook.md

@@ -22,3 +22,38 @@ docker compose up -d
 
     OpenAPI 404: A helyes cím /api/v2/openapi.json.
 
+# 03. Development Environment Runbook
+
+## 3.1. System Initialization (Bootstrap)
+Ha az adatbázis üres (vagy törölve lett), az első SuperAdmin felhasználót manuálisan kell létrehozni, mivel a regisztrációs végpontok védettek vagy nem adnak admin jogot.
+
+### 3.1.1. SuperAdmin Létrehozása (Recommended)
+A jelszó hash-elési eltérések elkerülése érdekében használjuk a Python scriptet a konténeren belül:
+
+```bash
+docker exec -it service_finder_api python3 -c "
+import bcrypt
+import asyncio
+from sqlalchemy import text
+from app.db.session import SessionLocal
+
+async def bootstrap_admin():
+    # 1. Jelszó generálás
+    password = 'InitialPassword123'.encode('utf-8')
+    hashed = bcrypt.hashpw(password, bcrypt.gensalt()).decode('utf-8')
+    
+    async with SessionLocal() as db:
+        # 2. Person és User létrehozása/Frissítése
+        # (A script feltételezi, hogy a Person rekord már létezik vagy itt hozod létre)
+        sql = text(\"\"\"
+            UPDATE data.users 
+            SET hashed_password = :h, role = 'superadmin', is_active = true, preferred_language = 'hu'
+            WHERE email = 'admin@servicefinder.hu'
+        \"\"\")
+        await db.execute(sql, {'h': hashed})
+        await db.commit()
+        print('✅ SuperAdmin Ready')
+
+if __name__ == '__main__':
+    asyncio.run(bootstrap_admin())
+"