Add concept overview for Google suite hub

README.md

@@ -0,0 +1,69 @@
+# Google Suite Hub (demo)
+
+Repo zawiera działającą, lokalną wersję demo 4‑w‑1: Gmail, Google Tasks, Google Calendar oraz Habits. Obecnie dane są przykładowe (mock), ale architektura i UI są gotowe do podpięcia prawdziwych usług Google przez OAuth.
+
+## Co już działa
+- **Dashboard webowy** (Flask + Jinja) z kartami: Gmail, Tasks, Calendar, Habits.
+- **Przykładowe dane** po stronie backendu, żeby zobaczyć wygląd i układ aplikacji od razu po uruchomieniu.
+
+## Jak uruchomić lokalne demo
+1. Upewnij się, że masz Python 3.11+.
+2. Zainstaluj zależności:
+   ```bash
+   pip install -r requirements.txt
+   ```
+3. Uruchom serwer developerski:
+   ```bash
+   flask --app app run
+   ```
+4. Wejdź w przeglądarce na `http://localhost:5000` – zobaczysz połączony widok Gmail/Tasks/Calendar/Habits z mock danymi.
+
+> **Tip:** Kod szablonu jest w `templates/index.html`, a dane generuje `app.py` w funkcjach `mock_*`.
+
+## Architecture sketch
+- **Frontend**: Web UI (SPA or server-rendered) that hits a backend API after OAuth completes.
+- **Backend**: Handles OAuth code exchange, stores tokens securely, and calls Google APIs.
+- **Data storage**: A small database (e.g., SQLite/PostgreSQL) to persist user profiles, refresh tokens, and habit logs.
+- **Google APIs**: Gmail API, Google Tasks API, Google Calendar API via REST (e.g., google-api-python-client).
+
+## OAuth setup (required)
+1. Create a Google Cloud project.
+2. Enable Gmail API, Google Tasks API, and Google Calendar API.
+3. Configure OAuth consent screen and authorized redirect URIs.
+4. Create OAuth 2.0 Client ID (Web application) and note the **Client ID** and **Client secret**.
+5. Set environment variables for local development (example):
+   ```bash
+   export GOOGLE_CLIENT_ID="your-client-id"
+   export GOOGLE_CLIENT_SECRET="your-client-secret"
+   export OAUTH_REDIRECT_URI="http://localhost:8000/oauth/callback"
+   ```
+
+## Minimal flow (backend)
+1. Redirect the user to Google's OAuth URL with scopes:
+   - `https://www.googleapis.com/auth/gmail.readonly`
+   - `https://www.googleapis.com/auth/tasks.readonly`
+   - `https://www.googleapis.com/auth/calendar.readonly`
+2. Exchange the authorization code for access + refresh tokens.
+3. Persist tokens securely (per user) along with token expiry.
+4. Use access tokens to call the respective APIs:
+   - Gmail: `users.messages.list` for recent messages.
+   - Tasks: `tasks.list` for the default list.
+   - Calendar: `events.list` for upcoming events.
+5. Render aggregated data to the UI alongside locally stored habits.
+
+## Habits data model (local)
+- `habit` table: `id`, `user_id`, `name`, `cadence` (e.g., daily/weekly), `created_at`.
+- `habit_checkin` table: `id`, `habit_id`, `date`, `status` (done/skipped/partial).
+
+## Development checklist
+- [x] Wybrać framework (Flask) i zbudować UI demo.
+- [ ] Dodać endpointy OAuth (`/auth/login`, `/oauth/callback`).
+- [ ] Zaimplementować przechowywanie/odświeżanie tokenów.
+- [ ] Podłączyć klientów Google API (Gmail, Tasks, Calendar) zamiast mocków.
+- [ ] Dodać CRUD na Habits + check-iny.
+- [ ] Zintegrować realne dane z widokiem dashboardu.
+
+## Notes and constraints
+- Demo używa danych przykładowych; produkcyjnie trzeba skonfigurować Google Cloud project i sekrety.
+- Keep secrets out of version control; use environment variables or a secrets manager.
+- When adding code, avoid try/catch around imports to keep import failures visible.

app.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+from typing import List
+
+from flask import Flask, render_template
+
+app = Flask(__name__)
+
+
+@dataclass
+class Email:
+    sender: str
+    subject: str
+    received_at: datetime
+    snippet: str
+
+
+@dataclass
+class Task:
+    title: str
+    due: datetime | None
+    status: str
+
+
+@dataclass
+class CalendarEvent:
+    title: str
+    starts_at: datetime
+    ends_at: datetime
+    location: str | None = None
+
+
+@dataclass
+class Habit:
+    name: str
+    streak: int
+    note: str | None = None
+
+
+def mock_emails() -> List[Email]:
+    now = datetime.utcnow()
+    return [
+        Email("team@project.io", "Sprint review notes", now - timedelta(hours=1), "Nagranie i notatki z wczoraj"),
+        Email("billing@saas.com", "Faktura czerwiec", now - timedelta(hours=5), "Dziękujemy za płatność"),
+        Email("alerts@monitoring.io", "Status page update", now - timedelta(days=1), "Wszystkie systemy operacyjne"),
+    ]
+
+
+def mock_tasks() -> List[Task]:
+    tomorrow = datetime.utcnow() + timedelta(days=1)
+    return [
+        Task("Przygotować dema dla klienta", tomorrow, "in-progress"),
+        Task("Zaplanować posty na bloga", None, "todo"),
+        Task("Domknąć sprint", tomorrow + timedelta(days=1), "todo"),
+    ]
+
+
+def mock_events() -> List[CalendarEvent]:
+    today = datetime.utcnow().replace(hour=9, minute=0, second=0, microsecond=0)
+    return [
+        CalendarEvent("Status tygodniowy", today, today + timedelta(hours=1), "Meet"),
+        CalendarEvent("Demo klienta", today + timedelta(hours=2), today + timedelta(hours=3), "Zoom"),
+        CalendarEvent("1:1", today + timedelta(hours=4), today + timedelta(hours=4, minutes=30)),
+    ]
+
+
+def mock_habits() -> List[Habit]:
+    return [
+        Habit("Ćwiczenia", 5, "Poranny trening 20 min"),
+        Habit("Pisanie dziennika", 12, "3 rzeczy za które jesteś wdzięczny"),
+        Habit("Nauka", 7, "30 minut kursu"),
+    ]
+
+
+@app.route("/")
+def home():
+    return render_template(
+        "index.html",
+        emails=mock_emails(),
+        tasks=mock_tasks(),
+        events=mock_events(),
+        habits=mock_habits(),
+    )
+
+
+if __name__ == "__main__":
+    app.run(debug=True)

requirements.txt

@@ -0,0 +1 @@
+Flask==3.0.3

templates/index.html

@@ -0,0 +1,107 @@
+<!doctype html>
+<html lang="pl">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Google Suite Hub (demo)</title>
+    <style>
+      :root {
+        font-family: "Inter", system-ui, -apple-system, sans-serif;
+        background: #f7f8fa;
+        color: #111;
+      }
+      body {
+        margin: 0;
+        padding: 24px;
+      }
+      h1 {
+        margin-bottom: 4px;
+      }
+      .grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+        gap: 16px;
+        margin-top: 12px;
+      }
+      .card {
+        background: white;
+        border-radius: 12px;
+        padding: 16px;
+        box-shadow: 0 1px 4px rgba(0,0,0,0.08);
+      }
+      .label {
+        font-size: 12px;
+        font-weight: 700;
+        text-transform: uppercase;
+        letter-spacing: 0.08em;
+        color: #6b7280;
+        margin-bottom: 8px;
+      }
+      .item { margin-bottom: 10px; }
+      .item:last-child { margin-bottom: 0; }
+      .pill {
+        display: inline-block;
+        background: #eef2ff;
+        color: #4338ca;
+        padding: 4px 8px;
+        border-radius: 999px;
+        font-size: 12px;
+        font-weight: 600;
+      }
+      .muted { color: #6b7280; font-size: 14px; }
+    </style>
+  </head>
+  <body>
+    <h1>Google Suite Hub</h1>
+    <p class="muted">Prosty, działający demo-front: Gmail, Tasks, Calendar i Habits z przykładowymi danymi.</p>
+
+    <div class="grid">
+      <div class="card">
+        <div class="label">Gmail</div>
+        {% for email in emails %}
+        <div class="item">
+          <div><strong>{{ email.subject }}</strong></div>
+          <div class="muted">Od: {{ email.sender }} · {{ email.received_at.strftime('%H:%M %d.%m') }}</div>
+          <div class="muted">{{ email.snippet }}</div>
+        </div>
+        {% endfor %}
+      </div>
+
+      <div class="card">
+        <div class="label">Tasks</div>
+        {% for task in tasks %}
+        <div class="item">
+          <div><strong>{{ task.title }}</strong></div>
+          <div class="muted">
+            Status: <span class="pill">{{ task.status }}</span>
+            {% if task.due %} · Termin: {{ task.due.strftime('%d.%m %H:%M') }}{% endif %}
+          </div>
+        </div>
+        {% endfor %}
+      </div>
+
+      <div class="card">
+        <div class="label">Calendar</div>
+        {% for event in events %}
+        <div class="item">
+          <div><strong>{{ event.title }}</strong></div>
+          <div class="muted">
+            {{ event.starts_at.strftime('%d.%m %H:%M') }} – {{ event.ends_at.strftime('%H:%M') }}
+            {% if event.location %} · {{ event.location }}{% endif %}
+          </div>
+        </div>
+        {% endfor %}
+      </div>
+
+      <div class="card">
+        <div class="label">Habits</div>
+        {% for habit in habits %}
+        <div class="item">
+          <div><strong>{{ habit.name }}</strong></div>
+          <div class="muted">Seria: {{ habit.streak }} dni{% if habit.note %} · {{ habit.note }}{% endif %}</div>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+  </body>
+</html>