All projects
Next.js
FastAPI
Node.js
LangChain
LangGraph
Prisma
Drizzle
shadcn/ui
Zustand
NextAuth
motion
Tailwind CSS v4
PostgreSQL (Neon)
ChromaDB
Qdrant
MongoDB
Docker
AWS
Vercel
Cloudflare
LangSmith
Sentry
B-RAG
An agentic document intelligence and research platform built with LangGraph and LangChain, featuring multimodal processing, vector search, citation-aware AI chat, and a context-rich assistant for AI, solutions architecture, and full-stack development.
Next.jsFastAPINode.jsLangChainLangGraphPrismaDrizzleBeBetter-Auth
shadcn/uiZustandNextAuthmotionTailwind CSS v4PostgreSQL (Neon)ChromaDBQdrantMongoDBDockerAWSVercelCloudflareLangSmithSentry01 / System Architecture
Architecture Decision
Current
Why this architecture
- Cloudflare handles WAF and DDoS at the edge — no extra infrastructure cost, no additional attack surface to manage.
- HTTPS access is restricted to Cloudflare IPs only, so the origin server is never directly exposed to the public internet.
- Frontend requests are only accepted from the single domain https://brag.bobbyugbebor.store/ — an extra layer of security that rejects any traffic from unauthorized origins.
- The application layer is completely stateless and hosting-agnostic — it can run on a VPS, a container, or a bare-metal box with zero code changes.
- Built for under 100 concurrent users, which means a single instance handles the load comfortably with room to spare.
- As demand grows, the architecture can evolve incrementally — adding load balancers, auto-scaling, or migrating to serverless — without rewriting the application layer.
02 / Quality Assurance
Testing & Reliability
Performance
Acceptance
Performance
Acceptance
Test Cases
K6 by Grafana
Load test targeting the retrieval endpoint (/query/stream) with 10 concurrent virtual users over 5 minutes. Validates response times and error rates under normal operating conditions.
1 / 2
Workload Profile
1m10 VUs
3m10 VUs
1m0 VUs
Thresholds
http_req_duration p(95)< 5000ms
http_req_duration p(99)< 6000ms
http_req_failedrate < 0.05
checksrate > 0.95
Summary
Requests
515
1.69/s
Checks
1030
0 failed
Iterations
515
Virtual Users
1–10
Results
| Metric | Avg | Med | P95 | P99 |
|---|---|---|---|---|
| http_req_duration | 3772.47 | 3701.31 | 4875.46 | 5698.71 |
03 / Architecture Gallery
B-RAG
Click image to expand · 1 / 7
04 / Deployment
CI/CD Pipeline
01
Branch to feature
development02
Feature work & test
feature03
Merge to development
feature04
Test on development
development05
Merge to main
development06
Deploy to production
main01
Branch to feature
development02
Feature work & test
feature03
Merge to development
feature04
Test on development
development05
Merge to main
development06
Deploy to production
mainBranch from development to feature → develop & test → merge to development → run test suite → merge to main → GitHub Actions runs tests → deploy to AWS (backend), Vercel (frontend), Cloudflare (CDN/DNS).
05 / Updates
Features to be Implemented
Backlog
2Worker with RQ
P1Integrating workers for processing jobs with Redis Queue as a Broker.
backenddecoupling
3Node.js backend for file-conversion/management
P1Build a separate service for managing file conversion and management, decoupling from b-rag
backendnodejs
58 pts
To Do
1Configure Loki
P0Set up log aggregation pipeline
observability
55 pts
In Progress
1Implement request metrics
P0Add latency and request count metrics
observability
33 pts
Review
1Set up Grafana dashboards
P1Create monitoring dashboards
observability
55 pts
Done
2Set up Prometheus endpoint
P0Implement metrics collection in API routes
observability
5Research best practices
P2Study observability patterns and anti-patterns
observability
27 pts
06 / Technology Stack
Technologies
FrameworksNext.jsFastAPINode.js
Next.jsFastAPINode.jsLibrariesLangChainLangGraphPrismaDrizzle
Better-Authshadcn/uiZustandNextAuthmotionTailwind CSS v4
LangChainLangGraphPrismaDrizzleBetter-Authshadcn/uiZustandNextAuthmotionTailwind CSS v4DataBasesPostgreSQL (Neon)ChromaDBQdrantMongoDB
PostgreSQL (Neon)ChromaDBQdrantMongoDBInfrastructuresDockerAWSVercelCloudflare
DockerAWSVercelCloudflareObservabilitiesLangSmithSentry
LangSmithSentry