Pendent Platform Documentation

Complete documentation for the Pendent ATS Platform

---

📚 Documentation Index

Core Documentation

Document	Description
Architecture	System architecture, component diagrams, data flows
Roadmap	Development roadmap with phases and timelines
Technical Decisions	ADRs and rationale for technology choices
Database Schema	Complete database schema reference
Future Development	Detailed plans for upcoming features

---

🚀 Quick Links

For Developers

• Architecture Overview
• Module Structure
• Security Model

For Product Planning

• Current Features
• Phase 1: Core Enhancements
• Phase 2: AI & Automation

For System Design

• AI Interview System
• Email System
• Webhook System
• Real-time Notifications

---

📂 Repository Structure

pendent-platform/
├── pendent-dashboard-be/     # Backend API (this repo)
├── pendent-dashboard-fe/     # HR Dashboard UI
├── jobs-pendent-fe/          # Public Job Portal
└── ats-scoring-engine/       # AI Scoring Package

---

🏗️ Architecture at a Glance

┌─────────────────────────────────────────────────────────┐
│                    PENDENT PLATFORM                      │
├─────────────────────────────────────────────────────────┤
│                                                          │
│   Dashboard FE ─────┐                                   │
│   (Next.js)         │                                   │
│                     ├──────► Dashboard BE               │
│   Jobs Portal ──────┘       (Express + Prisma)         │
│   (Next.js)                        │                    │
│                                    │                    │
│                     ┌──────────────┼──────────────┐     │
│                     │              │              │     │
│                     ▼              ▼              ▼     │
│                PostgreSQL      MinIO         OpenAI    │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

🎯 Key Features (v1.0)

Implemented ✅

• Authentication: Better Auth with sessions, 2FA, API keys
• Organizations: Multi-tenant with custom workflows
• Jobs: Full lifecycle with AI description generation
• Candidates: Stage-based workflow with actions
• ATS Scoring: AI-powered resume scoring with presets
• Shortlisting: Manual, bulk, and threshold-based
• Referrals: Employee referral tracking with bonuses
• Notifications: In-app notification system
• Analytics: Dashboard metrics and reporting
• Activity Logs: Full audit trail

Planned 🔜

• Real-time: WebSocket/SSE notifications
• Email: Transactional emails with templates
• AI Interviews: Automated video screening
• Assessments: Built-in coding and skill tests
• Integrations: LinkedIn, Greenhouse, Slack

---

📊 Technology Stack

Layer	Technology
Backend	Express.js, TypeScript
Database	PostgreSQL, Prisma ORM
Auth	Better Auth
AI	OpenAI GPT-4, Custom ATS Engine
Storage	MinIO (S3-compatible)
Frontend	Next.js 15, React 19, TailwindCSS

---

📝 Contributing

See each document for specific areas:

• Architecture changes → TECHNICAL_DECISIONS.md
• New features → ROADMAP.md
• System design → FUTURE_DEVELOPMENT.md

---

📞 Contact

For questions about this documentation, please reach out to the engineering team.