updated docs

This commit is contained in:
2026-04-14 10:32:05 -03:00
parent 2e5a304181
commit a80b72a9b1
67 changed files with 3260 additions and 5005 deletions

View File

@@ -0,0 +1,55 @@
# Google Vein
Status: **building**
Connects soleprint to Google services. OAuth2 flow is implemented. Sheets read access works. Calendar and Drive are next.
---
## What Works
**OAuth2 authentication** -- full flow with authorization URL generation, code exchange, token refresh, and user identity extraction. Supports both identity (OpenID Connect) and API access scopes.
**Google Sheets** -- read-only access to spreadsheet data.
## Configuration
Create a `.env` file in the vein directory:
```env
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:12000/artery/google/oauth/callback
API_PORT=8003
```
You need a Google Cloud project with OAuth consent screen configured and credentials created.
## OAuth Scopes
Identity scopes (default):
- `openid`
- `userinfo.email`
- `userinfo.profile`
API scopes (added when needed):
- `spreadsheets.readonly`
- `drive.readonly`
## What's Coming
- Calendar integration
- Drive file browsing and download
- Full Sheets write support
Configuration details will be added as these integrations mature.
## Running Standalone
```bash
cd soleprint/artery/veins/google
python run.py
# Runs on port 8003
```