Kwaku Danso
3f8bc58ca9
Phase 1 — Core API (Go): - Events, guests, tokens, RSVPs CRUD on PostgreSQL via pgx/v5 - HMAC-signed per-guest tokens with format validation - Health endpoint with DB ping, slog JSON logging, graceful shutdown Phase 2 — NATS + Fraud Engine: - NATS JetStream pub/sub with explicit-ack consumers - Python/FastAPI fraud engine with heuristic risk scoring (fingerprint mismatch, IP change, missing signals, repeated access) - gRPC sync scoring with 250ms fail-open timeout - Per-guest baseline tracking; risk bands low/medium/high/block Phase 3 — Notifications + Frontend: - Notification worker scaffolding (Twilio/SES stubs, retry/backoff) - Nuxt 3 frontend with Tailwind dark theme + brand green - Live monitor via WebSocket with auto-reconnect - Activity history endpoint backfills monitor with RSVPs + scored access checks (including blocked attempts) UX polish: - Marketing-friendly landing page (hero mockup, how-it-works, features, use cases, testimonials, FAQ, final CTA) - Animated layered card mockups on landing + new-event page - Plus-ones stepper, RSVP status badges, filter buttons - Friendly access-check labels (Verified/Review/Suspicious/Blocked) - Dashboard hydration fix via ClientOnly wrapper Infrastructure: - docker-compose for full local dev (postgres, nats, api, fraud-engine, notifier, frontend) - Multi-stage Dockerfiles, non-root UID 1000 - Integration tests with testcontainers-go Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
35 lines
648 B
Protocol Buffer
35 lines
648 B
Protocol Buffer
syntax = "proto3";
|
|
|
|
package guestguard.fraud.v1;
|
|
|
|
option go_package = "github.com/alchemistkay/guestguard/internal/fraudpb;fraudpb";
|
|
|
|
service FraudService {
|
|
rpc Score(ScoreRequest) returns (ScoreResponse);
|
|
}
|
|
|
|
message ScoreRequest {
|
|
string event_id = 1;
|
|
string guest_id = 2;
|
|
string token_id = 3;
|
|
string access_log_id = 4;
|
|
map<string, string> fingerprint = 5;
|
|
string ip_address = 6;
|
|
string user_agent = 7;
|
|
string referrer = 8;
|
|
}
|
|
|
|
message ScoreResponse {
|
|
int32 score = 1;
|
|
Risk risk = 2;
|
|
repeated string reasons = 3;
|
|
}
|
|
|
|
enum Risk {
|
|
RISK_UNSPECIFIED = 0;
|
|
RISK_LOW = 1;
|
|
RISK_MEDIUM = 2;
|
|
RISK_HIGH = 3;
|
|
RISK_BLOCK = 4;
|
|
}
|