Athena — mahmoud-consultancy/README.md

InterimPlaza Recruitment Platform

IT recruitment platform — InterimPlaza is the product label under Mahmoud Consultancy B.V. GloryLabs is the development agency that builds it (see root CLAUDE.md → Corporate Structure).


🤖 For Claude Code Agents - START HERE

[[CURRENT_TASK]]Agents: Read this file first!

Single source of truth for the current task, blockers, and next actions.

What this file contains:

  • 🎯 Current session/task with detailed instructions
  • 🔥 Immediate actions (in priority order)
  • 🚧 Current blockers
  • 📁 Links to detailed documentation
  • ✅ Progress tracking

Agents should:

  1. Read CURRENT_TASK.md before starting any work
  2. Follow the current task instructions
  3. Update CURRENT_TASK.md after completing
  4. Commit changes

📚 Complete Documentation

[[docs/interimplaza/README]] ← InterimPlaza Documentation Home

8 Comprehensive Documents (98,000+ words):

📋 Planning & Requirements

  • [[docs/interimplaza/Planning/INTERIMPLAZA_REQUIREMENTS_MOSCOW]] - MoSCoW (152 requirements)
  • [[docs/interimplaza/Planning/INTERIMPLAZA_COMPLETE_REQUIREMENTS]] - Dutch (eisen & wensen)
  • [[docs/interimplaza/Planning/INTERIMPLAZA_SPRINT_PLAN]] - Sprint 1-9 + 87 SRE practices

📝 Execution & Tasks

  • [[docs/interimplaza/Execution/INTERIMPLAZA_MASTER_TODO_CHECKLIST]] - All remaining work
  • [[docs/interimplaza/Execution/CLAUDE_CODE_SESSION_PLAN]] - 25 Claude Code sessions

🔧 Implementation Guides

  • [[docs/interimplaza/Implementation/SENTIOR_87_SOURCES_IMPLEMENTATION]] - 87 job sources (€73K/year ROI)
  • [[docs/interimplaza/Implementation/EMAIL_SERVICE_CONFIGURATION]] - 6 email templates

📊 Status & Reports

  • [[docs/interimplaza/Reports/INTERIMPLAZA_FINAL_SUMMARY_OCT26]] - Executive summary (95% complete)
  • [[docs/interimplaza/Reports/DOCUMENTATION_INDEX]] - Navigation guide

🎯 Project Status: 96% Complete

| Component | Status | Notes | |-----------|--------|-------| | Backend API | ✅ 96% | Database persistence fixed | | Frontend UI | ✅ 92% | Tests improved (74% pass rate) | | CV Builder | ✅ 100% | Fully functional | | Email System | ✅ 100% | 6 templates ready | | Admin Dashboard | ✅ 95% | Analytics pending | | Job Scraping | ✅ 90% | Flextender operational (170 jobs) | | Testing | ⚠️ 74% | 53/72 tests passing | | Documentation | ✅ 100% | Sentior sprint plan added | | Kubernetes Helm | ✅ 100% | Ready to deploy |

Recent Updates (Session 8):

  • ✅ Fixed TypeScript compilation errors
  • ✅ Improved test suite (65% → 74% pass rate)
  • ✅ Enhanced pre-commit hook (less strict)
  • ✅ Created 8-week Sentior sprint plan (€73K/year potential)

Next: K8s local deploy (1-2 hours) → Analytics (2 hours) → E2E testing (4 hours)


🚀 Quick Start

Local Development

Option 1: Docker Compose (Simpler)

docker-compose up -d

Option 2: Kubernetes with Helm (Production-like) NEW!

# See K8S_LOCAL_QUICKSTART.md for full guide

# Quick deploy
helm install glorylabs ./helm/recruitment-platform \
  -f ./helm/recruitment-platform/values-local.yaml \
  -n glorylabs-local --create-namespace

# Access
kubectl port-forward -n glorylabs-local svc/glorylabs-recruitment-platform-frontend 4200:80
open http://localhost:4200

Kubernetes Guide: [[K8S_LOCAL_QUICKSTART]]

Access Application

  • Frontend: http://localhost:4200 (or 4210)
  • Backend API: http://localhost:8090 (or 8080)
  • Swagger Docs: http://localhost:8090/swagger-ui/index.html

🔥 Critical Next Actions

See [[CURRENT_TASK]] for details:

  1. Deploy to local K8s (1-2 hours) - Helm charts ready ⏳ NEXT
  2. Complete analytics (2 hours) - Dashboard queries
  3. E2E testing (4 hours) - Full user journeys
  4. Sentior 87 sources (8 weeks) - Long-term project (optional)
  5. Production deployment (1-2 weeks) - After local K8s testing

📁 Project Structure

mahmoud-consultancy/
├── README.md                  ← You are here
├── CURRENT_TASK.md            ← Agent reference (what to do next)
├── K8S_LOCAL_QUICKSTART.md    ← Kubernetes deployment guide
│
├── docs/interimplaza/         ← All documentation (Obsidian vault)
│   ├── README.md              ← Documentation home
│   ├── Planning/              ← Requirements & sprints
│   ├── Execution/             ← TODO & sessions
│   ├── Implementation/        ← Technical guides
│   └── Reports/               ← Status & summaries
│
├── helm/                      ← Kubernetes Helm charts
│   └── recruitment-platform/  ← Complete charts (FE + BE + DB)
│
├── scripts/                   ← Automation scripts (16 total)
│   └── EXTRACT_SENTIOR_SOURCES.sh
│
├── backend/                   ← Java Spring Boot API
├── frontend/                  ← Angular application
└── bin/                       ← Archive (old files)

🛠️ Technology Stack

Backend: Java 17, Spring Boot 3.3.5, PostgreSQL, Redis Frontend: Angular 18+, TypeScript Infrastructure: Docker, Kubernetes, Helm, Nginx CI/CD: GitHub Actions Monitoring: Prometheus, Grafana


📞 Support

Developer: GloryLabs Client: Mahmoud Consultancy B.V. (InterimPlaza) Contact: support@glorylabs.nl


Navigation:

  • For Agents: Read [[CURRENT_TASK]] first
  • For Developers: See [[docs/interimplaza/README]]
  • For K8s Deployment: See [[K8S_LOCAL_QUICKSTART]]

© 2025 GloryLabs - Part of Mahmoud Consultancy B.V.

Reacties

Nog geen reacties