How sebai-dhia/leadforge works
Leadforge is a freelancer-facing lead-generation web application. A user signs in, describes their service and target area, then starts searches; n8n finds businesses, the API stores and ranks leads, and the user reviews drafts and tracks outreach. The README documents the search, contact-lookup, and message-draft workflow integrations and their external providers. Several backend and workflow implementations were not sampled, so those relationships are shown only where the README supports them; unsampled subsystem internals are represented by their existing source directories.
Main entry points: SearchController.java Search and lead API · app.ts Angular web app · workflow-src n8n workflows · AdminService.java Admin services
Components 23
Web application
- Angular web app
app/frontend/src/app/app.ts - Sign-in and onboarding
app/frontend/src/app/features/login/login.ts - Search area picker
app/frontend/src/app/features/searches/searches.ts - Lead review and tracking
app/frontend/src/app/features/leads/leads.ts - Profile and preferences
app/frontend/src/app/features/profile/profile.ts - Admin dashboard
app/frontend/src/app/features/admin/admin.ts
Identity and accounts
- Authentication API
app/backend/src/main/java/com/leadfinder/auth/AuthController.java - User and session services
app/backend/src/main/java/com/leadfinder/auth/ActiveSessionRegistry.java
Lead discovery and outreach
- Search and lead API
app/backend/src/main/java/com/leadfinder/search/SearchController.java - Lead deduplication and enrichment
app/backend/src/main/java/com/leadfinder/search/LeadService.java - n8n workflows
app/workflow-src - Geoapify places
- Serper web search
- Gemini drafting
- Lead and search records
app/backend/src/main/java/com/leadfinder/search/LeadRepository.java
API platform
- PostgreSQL
- Runtime settings
app/backend/src/main/java/com/leadfinder/settings/RuntimeSettings.java - Usage limits and metering
app/backend/src/main/java/com/leadfinder/usage/UsageService.java - Admin services
app/backend/src/main/java/com/leadfinder/admin/AdminService.java
Reminders and alerts
- Telegram reminders
app/backend/src/main/java/com/leadfinder/telegram/FollowUpReminder.java - Admin alerting
app/backend/src/main/java/com/leadfinder/alert/AlertService.java - Telegram service
app/backend/src/main/java/com/leadfinder/telegram/TelegramBot.java
Other components
- Freelancer
Connections 28
- Freelancer → Angular web app: uses
README.md - Angular web app → Sign-in and onboarding: routes to
- Angular web app → Search area picker: routes to
- Angular web app → Lead review and tracking: routes to
- Angular web app → Profile and preferences: routes to
- Angular web app → Admin dashboard: routes to
- Sign-in and onboarding → Authentication API: authenticates through
README.md - Authentication API → User and session services: manages sessions
app/backend/src/main/java/com/leadfinder/auth/AuthController.java - User and session services → PostgreSQL: reads and writes
- Search area picker → Search and lead API: submits search
README.md - Lead review and tracking → Search and lead API: requests leads
README.md - Profile and preferences → Search and lead API: uses API
- Admin dashboard → Admin services: uses API
- Search and lead API → n8n workflows: dispatches search
README.md - n8n workflows → Search and lead API: returns results
README.md - n8n workflows → Geoapify places: finds places
README.md - n8n workflows → Serper web search: searches web
README.md - n8n workflows → Gemini drafting: drafts messages
README.md - Search and lead API → Lead deduplication and enrichment: processes leads
- Lead deduplication and enrichment → Lead and search records: deduplicates and saves
app/backend/src/main/java/com/leadfinder/search/LeadService.java - Search and lead API → PostgreSQL: persists searches
- Search and lead API → Usage limits and metering: checks limits
- Runtime settings → PostgreSQL: loads overrides
app/backend/src/main/java/com/leadfinder/settings/RuntimeSettings.java - Admin services → User and session services: summarizes users
app/backend/src/main/java/com/leadfinder/admin/AdminService.java - Admin services → Usage limits and metering: summarizes usage
app/backend/src/main/java/com/leadfinder/admin/AdminService.java - Telegram reminders → Telegram service: sends reminders
- Usage limits and metering → Admin alerting: reports global caps
app/backend/src/main/java/com/leadfinder/usage/UsageService.java - Admin alerting → Telegram service: sends alert
app/backend/src/main/java/com/leadfinder/alert/AlertService.java