mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-17 19:09:41 +02:00
7c5e9e3c49
Complete GDPR-compliant bot suite for Matrix: matrix-stats-bot (port 3312): - Analytics reports from Umami - Commands: !stats, !today, !week, !realtime, !users - Scheduled daily/weekly reports to Matrix room matrix-project-doc-bot (port 3313): - Project documentation with photos, voice, text - Voice transcription via OpenAI Whisper - Blog generation with 5 styles (casual, technical, tutorial, social, story) - Commands: !new, !projects, !switch, !status, !generate, !export - Uses PostgreSQL + S3 (MinIO) for storage Changes: - docker-compose.macmini.yml: Added both Matrix bots - health-check.sh: Added health checks for both bots Environment variables required: - MATRIX_STATS_BOT_TOKEN, MATRIX_PROJECT_DOC_BOT_TOKEN - OPENAI_API_KEY (for Project Doc Bot) https://claude.ai/code/session_01E3r5aFW3YLAhEJfsL2ryhv
122 lines
2.9 KiB
Markdown
122 lines
2.9 KiB
Markdown
# Matrix Project Doc Bot - Claude Code Guidelines
|
|
|
|
## Overview
|
|
|
|
Matrix Project Doc Bot collects photos, voice notes, and text for projects and generates blog posts. GDPR-compliant replacement for telegram-project-doc-bot.
|
|
|
|
## Tech Stack
|
|
|
|
- **Framework**: NestJS 10
|
|
- **Matrix**: matrix-bot-sdk
|
|
- **Database**: Drizzle ORM + PostgreSQL
|
|
- **Storage**: S3 (MinIO locally, Hetzner in production)
|
|
- **AI**: OpenAI (Whisper for transcription, GPT-4o-mini for generation)
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm start:dev # Development with hot reload
|
|
pnpm build # Production build
|
|
pnpm type-check # TypeScript check
|
|
pnpm db:push # Push schema to database
|
|
pnpm db:studio # Open Drizzle Studio
|
|
```
|
|
|
|
## Matrix Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `!new [Name]` | Create new project |
|
|
| `!projects` | List all projects |
|
|
| `!switch [ID]` | Switch to project |
|
|
| `!status` | Show project status |
|
|
| `!archive` | Archive current project |
|
|
| `!generate` | Generate blog post (casual) |
|
|
| `!generate [style]` | Generate with specific style |
|
|
| `!styles` | Show available styles |
|
|
| `!export` | Export last generation |
|
|
|
|
## Media Handling
|
|
|
|
- **Photos**: Saved to S3, stored in database
|
|
- **Voice**: Saved to S3, transcribed via Whisper
|
|
- **Text**: Stored directly in database
|
|
|
|
## Blog Styles
|
|
|
|
| Style | Description |
|
|
|-------|-------------|
|
|
| `casual` | Friendly, personal blog post |
|
|
| `technical` | Detailed technical report |
|
|
| `tutorial` | Step-by-step guide |
|
|
| `social` | Short social media post |
|
|
| `story` | Storytelling format |
|
|
|
|
## Environment Variables
|
|
|
|
```env
|
|
PORT=3313
|
|
|
|
# Matrix
|
|
MATRIX_HOMESERVER_URL=http://localhost:8008
|
|
MATRIX_ACCESS_TOKEN=syt_xxx
|
|
MATRIX_ALLOWED_USERS=@user:mana.how
|
|
MATRIX_STORAGE_PATH=./data/bot-storage.json
|
|
|
|
# Database
|
|
DATABASE_URL=postgresql://postgres:password@localhost:5432/project_doc_bot
|
|
|
|
# S3 Storage
|
|
S3_ENDPOINT=http://localhost:9000
|
|
S3_REGION=us-east-1
|
|
S3_ACCESS_KEY=minioadmin
|
|
S3_SECRET_KEY=minioadmin
|
|
S3_BUCKET=project-doc-bot
|
|
|
|
# OpenAI
|
|
OPENAI_API_KEY=sk-xxx
|
|
OPENAI_MODEL=gpt-4o-mini
|
|
OPENAI_WHISPER_MODEL=whisper-1
|
|
```
|
|
|
|
## Database Schema
|
|
|
|
```sql
|
|
-- projects table
|
|
CREATE TABLE projects (
|
|
id UUID PRIMARY KEY,
|
|
matrix_user_id TEXT NOT NULL,
|
|
name TEXT NOT NULL,
|
|
status TEXT DEFAULT 'active',
|
|
created_at TIMESTAMP DEFAULT NOW(),
|
|
updated_at TIMESTAMP DEFAULT NOW()
|
|
);
|
|
|
|
-- project_items table
|
|
CREATE TABLE project_items (
|
|
id UUID PRIMARY KEY,
|
|
project_id UUID REFERENCES projects(id),
|
|
type TEXT NOT NULL, -- photo, voice, text
|
|
content TEXT,
|
|
media_url TEXT,
|
|
media_mxc_url TEXT,
|
|
duration INTEGER,
|
|
created_at TIMESTAMP DEFAULT NOW()
|
|
);
|
|
|
|
-- generations table
|
|
CREATE TABLE generations (
|
|
id UUID PRIMARY KEY,
|
|
project_id UUID REFERENCES projects(id),
|
|
style TEXT NOT NULL,
|
|
content TEXT NOT NULL,
|
|
created_at TIMESTAMP DEFAULT NOW()
|
|
);
|
|
```
|
|
|
|
## Health Check
|
|
|
|
```bash
|
|
curl http://localhost:3313/health
|
|
```
|