🎯 What it does
CareerSignal is built around one idea: turn professional visibility into career opportunities. For an AI/Data candidate, that means consistently producing quality content, building a targeted network, and tracking every opportunity — all with minimal manual effort.
The platform links four loops together: create professional signal → turn that signal into better conversations → track opportunities and follow-ups → feed everything with structured technical watch.
⚙️ Core Engines
- Generate Medium articles and LinkedIn posts from a topic, URL, PDF, or GitHub repo
- QA loop with critique-refine before publication
- Multi-provider LLM support (Claude, OpenAI)
- LinkedIn content calendar with editable date, time, content and hashtags
- Approve / reject / re-open workflow
- Time-aware autopublish worker
- Search LinkedIn profiles and recruiter targets
- Profile enrichment via scraping
- Generate personalized connection notes
- Outreach status tracking with rate limits
- Search and deduplicate LinkedIn job postings
- SQLite-backed persistence for every opportunity
- Status and notes tracking per saved job
- Dedicated Streamlit UI page
- Collect articles from RSS feeds and scraped sources
- Summarize technical content with LLMs
- Suggest LinkedIn posts from watch articles
🏗️ Architecture
The repo is in active transition from a working prototype to a clean layered architecture. The target design separates business logic from runtime adapters and external integrations.
Every workflow carries a run_id. Every sensitive action leaves a persistent trace. SQLite is the source of truth — JSON files are transitional legacy being progressively migrated.
📊 Implementation Status
| Feature | Status |
|---|---|
| LinkedIn Scheduling + autopublish worker | ✓ Done |
| Jobs Tracker with SQLite persistence | ✓ Done |
| FastAPI layer (health, db-init, jobs, autopublish) | ✓ Done |
| Content Engine (Medium + LinkedIn generation) | ✓ Done |
| Networking Engine (outreach + profile scraping) | ✓ Done |
| Docker + GitHub Actions CI/CD | ✓ Done |
| Migrate scheduling/outreach to SQLite | → Next |
| Recruiter enrichment in Jobs Tracker | → Next |
| Workflow run persistence + audit trails | → Next |
| Analytics dashboards | Later |
| Multi-user support + authentication | Later |