Semstine/HR_mgt-Uganda

A HR management tool for Ugandan companies # TalentBridge Africa — HR Management Platform A full-stack HR management and recruitment SaaS platform built for East African companies, starting with Uganda. ## Features (MVP) | Module | Status | |--------|--------| | Company onboarding with AI suggestions | ✅ | | Job posting with AI description generation | ✅ | | Public job application form | ✅ | | Resume upload and text extraction | ✅ | | AI resume screening and scoring | ✅ | | Candidate pipeline tracking | ✅ | | Interview scheduling | ✅ | | AI-generated email communications with approval workflow | ✅ | | Offer letter generation (PDF) + digital signing | ✅ | | Employee profile management | ✅ | | Employee onboarding checklist | ✅ | | Performance review module | ✅ | | People analytics dashboard (15+ metrics, filters) | ✅ | | AI HR assistant (chat) | ✅ | | Role-based access control (8 roles) | ✅ | | Uganda/East Africa compliance module (NSSF, PAYE, TIN, contracts) | ✅ | | Payroll-aligned records + compensation change approvals | ✅ | | Cloud file storage abstraction (local / S3 / Supabase) | ✅ | | Duplicate candidate detection | ✅ | | Structured resume parsing (PDF + DOCX) | ✅ | | Audit logs | ✅ | ## Tech Stack - **Frontend**: Next.js 14 (App Router), Tailwind CSS, Recharts - **Backend**: Next.js API Routes - **Database**: PostgreSQL with Prisma ORM - **Auth**: NextAuth.js (JWT) with RBAC - **AI**: Anthropic Claude (claude-sonnet-4-6) - **PDF**: pdf-lib - **Email**: Nodemailer - **File parsing**: pdf-parse (PDF), Mammoth (DOCX) - **Storage**: Local filesystem (S3/Supabase-ready abstraction layer) --- ## Setup Instructions ### 1. Prerequisites - Node.js 18+ - PostgreSQL database (free options: Neon, Supabase, or local) - Anthropic API key (console.anthropic.com) ### 2. Install dependencies ```bash npm install ``` ### 3. Configure environment variables ```bash cp .env.example .env ``` Edit `.env` with your values: ```env # Required DATABASE_URL="postgresql://user:password@localhost:5432/talentbridge" NE …