first push

2026-06-04 16:20:56 -05:00
parent a663de4f29
commit 392ae7bbe3
111 changed files with 5312 additions and 0 deletions
@@ -0,0 +1,74 @@
+---
+type: project
+status: active
+source: git.alwisp.com
+repo: jason/email
+repo_url: https://git.alwisp.com/jason/email
+language: HTML
+branch: main
+tags: [repo, jason]
+updated: 2026-05-29
+---
+
+# email
+
+**Repository:** [jason/email](https://git.alwisp.com/jason/email) · branch `main` · HTML
+
+## Summary
+
+Self-hosted Dockerized Google Workspace email signature manager — syncs users from Google Directory and pushes HTML signatures directly to Gmail via API
+
+## Current status
+
+Active. Synced from Gitea on 2026-05-29.
+
+## Documentation overview
+
+# Email Signature Manager
+
+A self-hosted, Dockerized Google Workspace email signature manager.
+Runs as a single container — designed for Unraid but works on any Docker host.
+See [INSTALL.md](INSTALL.md) for Unraid-specific instructions.
+
+## Features
+
+- **Automated Directory Sync** — Pulls user data from Google Workspace Directory API
+- **HTML Signature Renderer** — Per-user signatures via Handlebars templates
+- **Gmail API Integration** — Pushes signatures directly to Gmail (web + mobile)
+- **Nightly Sync** — Automated batch push via configurable cron schedule
+- **Web Admin UI** — Management dashboard with live template editor
+- **Template Versioning** — Save multiple versions and recall them later
+- **Test Mode** — Single-user push for safe testing and onboarding
+- **Audit Logging** — SQLite-backed history of every push event
+- **Secure Access** — Basic auth protected management interface
+- **Self-Hosted** — Single container with internal SQLite, no external DB needed
+
+---
+
+## Logo & Image Hosting
+
+All images referenced in the signature template must be publicly accessible via HTTPS.
+The default logo URL is:
+```
+https://alwisp.com/uploads/logo.png
+```
+Upload your logo and any other signature images to `https://alwisp.com/uploads/` and
+reference them by full URL in the template. The logo URL can also be changed live
+in the Template Editor UI without rebuilding the container.
+
+---
+
+## Environment Variables
+
+All secrets and configuration are passed as **environment variables at runtime**.
+No `.env` file is committed to this repo — see `.env.example` for all variable names.
+
+| Variable | Description | Default |
+|---|---|---|
+| `GOOGLE_ADMIN_EMAIL` | Workspace admin email (e.g. jason@messagepoint.tv) | *(required)* |
+
+…(truncated — see repo)
+
+## Notes
+
+- Project file auto-created from repo documentation.