title: Sprint 5 - Knowledge Base Implementation date: 2025-10-15 status: Planned tags: [sprint5, knowledge-base, content, planning]

Sprint 5: Knowledge Base & Resource Center

Overview

Sprint 5 focuses on building a comprehensive Knowledge Base to educate candidates about detachering, provide CV/application tips, and differentiate InterimPlaza from competitors.

Duration: 4 weeks (Nov 2024 - Dec 2024) Priority: High - Competitive differentiator Dependencies: Sprint 4 completion (UI polish, deployment)

📊 Sprint Goals

Primary Objectives

1. ✅ Build complete Knowledge Base backend infrastructure
2. ✅ Create user-friendly KB frontend with search/filtering
3. ✅ Write comprehensive content for all categories
4. ✅ Implement admin CMS for content management
5. ✅ Integrate with existing platform navigation

Success Metrics

• [ ] 50+ knowledge base articles published
• [ ] All 6 content categories populated with quality content
• [ ] Search functionality working with <1s response time
• [ ] Admin can create/edit/publish articles without code changes
• [ ] Mobile-responsive KB interface
• [ ] Analytics showing article views and ratings

🏗️ Technical Architecture

Backend Components

1. Article Entity

@Entity
public class Article {
    @Id
    private Long id;
    private String title;
    private String slug; // URL-friendly identifier
    private String summary; // Short description
    @Lob
    private String content; // Full markdown content
    @Enumerated(EnumType.STRING)
    private ArticleCategory category;
    private String author;
    private LocalDateTime publishedAt;
    private LocalDateTime updatedAt;
    private boolean published;
    private int viewCount;
    private double avgRating;
    @ElementCollection
    private List<String> tags;
    private String metaDescription; // SEO
    private String featuredImage;
}

2. Article Categories (Enum)

• DETACHERING_INFO - Over Detachering & Interim
• BUREAU_COMPARISON - InterimPlaza vs Andere Bureaus
• CV_TIPS - CV & Sollicitatietips
• MARKET_INFO - Marktinformatie
• FAQ - Veelgestelde Vragen
• SUCCESS_STORIES - Succesverhalen

3. Article Rating Entity

@Entity
public class ArticleRating {
    @Id
    private Long id;
    @ManyToOne
    private Article article;
    @ManyToOne
    private User user; // Optional - can be anonymous
    private int rating; // 1-5 stars
    private boolean helpful; // thumbs up/down
    private String feedback; // Optional comment
    private LocalDateTime createdAt;
}

4. Article Bookmark Entity

@Entity
public class ArticleBookmark {
    @Id
    private Long id;
    @ManyToOne
    private Article article;
    @ManyToOne
    private User user;
    private LocalDateTime createdAt;
}

REST API Endpoints

Public Endpoints (No Auth Required)

GET    /api/kb/articles                    - List all published articles
GET    /api/kb/articles/{slug}             - Get single article by slug
GET    /api/kb/articles/category/{category}- Get articles by category
GET    /api/kb/articles/search?q={query}   - Search articles
GET    /api/kb/categories                  - Get all categories with counts
GET    /api/kb/articles/{id}/related       - Get related articles
POST   /api/kb/articles/{id}/view          - Increment view count

Authenticated Endpoints

POST   /api/kb/articles/{id}/rate          - Rate an article
POST   /api/kb/articles/{id}/bookmark      - Bookmark article
GET    /api/kb/bookmarks                   - Get user's bookmarks
DELETE /api/kb/bookmarks/{id}              - Remove bookmark

Admin Endpoints (ADMIN role only)

POST   /api/admin/kb/articles              - Create new article
PUT    /api/admin/kb/articles/{id}         - Update article
DELETE /api/admin/kb/articles/{id}         - Delete article
POST   /api/admin/kb/articles/{id}/publish - Publish/unpublish
GET    /api/admin/kb/articles              - Get all articles (including drafts)
GET    /api/admin/kb/analytics             - Get KB analytics

🎨 Frontend Components

1. Knowledge Base Home Component

Route: /kennisbank or /knowledge-base

Features:

• Category cards with article counts
• Featured articles carousel
• Popular articles widget
• Recent articles list
• Search bar (prominent)
• Quick links to FAQ

Layout:

┌─────────────────────────────────────────┐
│  🔍 Search Knowledge Base               │
├─────────────────────────────────────────┤
│  📚 Categories                          │
│  ┌──────┐ ┌──────┐ ┌──────┐            │
│  │ Cat1 │ │ Cat2 │ │ Cat3 │            │
│  │ 15   │ │ 23   │ │ 12   │            │
│  └──────┘ └──────┘ └──────┘            │
├─────────────────────────────────────────┤
│  ⭐ Featured Articles                   │
│  - How to write the perfect IT CV      │
│  - ZZP vs Detachering: What's better?  │
├─────────────────────────────────────────┤
│  📖 Recent Articles                     │
│  List of 10 most recent articles        │
└─────────────────────────────────────────┘

2. Article List Component

Route: /kennisbank/categorie/{category}

Features:

• Filtered by category
• Search within category
• Tag filtering
• Sort by (newest, popular, rating)
• Pagination
• Article cards with summary

3. Article Detail Component

Route: /kennisbank/{slug}

Features:

• Full article content (markdown rendered)
• Table of contents (auto-generated from headings)
• Breadcrumb navigation
• Related articles sidebar
• Share buttons (LinkedIn, Twitter, Email)
• Rating widget (5 stars)
• Bookmark button
• Print-friendly view
• Author info
• Published/updated dates
• Tags
• Comment section (optional)

4. Search Results Component

Route: /kennisbank/zoeken?q={query}

Features:

• Full-text search results
• Highlighted search terms
• Filter by category
• Sort options
• Pagination

5. Admin KB Management Component

Route: /admin/kennisbank

Features:

• WYSIWYG markdown editor
• Article preview
• Category selector
• Tag input
• Publish/draft toggle
• Featured image upload
• SEO meta fields
• Analytics per article

📝 Content Structure

Category 1: Over Detachering & Interim (15-20 articles)

Beginner Articles:

1. "Wat is detachering? Complete uitleg voor IT'ers"
2. "ZZP vs Payroll vs Detachering: De verschillen"
3. "Voordelen van detachering voor IT professionals"
4. "Hoe werkt detachering in de praktijk?"
5. "Rechten en plichten als gedetacheerde"

Advanced Articles: 6. "Tarieven onderhandelen: Tips voor detacheerders" 7. "Contractvormen in de detacheringsbranche" 8. "Belastingvoordelen van detachering" 9. "Pensioen en verzekeringen bij detachering" 10. "Van ZZP naar detachering: De overstap"

Market Insights: 11. "Trends in IT detachering 2025" 12. "Detachering vs vast dienstverband: Voordelen" 13. "Hoeveel verdienen gedetacheerde IT'ers?"

Category 2: InterimPlaza vs Andere Bureaus (10-15 articles)

Comparison Articles:

1. "InterimPlaza vs Brunel: Wat zijn de verschillen?"
2. "InterimPlaza vs Yacht: Welk bureau past bij jou?"
3. "InterimPlaza vs Ordina: Een eerlijke vergelijking"
4. "Waarom kiezen IT'ers voor InterimPlaza?"
5. "Wat wij anders doen dan grote bureaus"

Transparency Articles: 6. "Onze tariefstructuur volledig uitgelegd" 7. "Geen lock-ins: Waarom wij geen lange contracten eisen" 8. "Directe communicatie met opdrachtgevers" 9. "Onze fee-structuur: Transparant en eerlijk" 10. "Succesverhalen van onze kandidaten"

Value Proposition: 11. "5 redenen om voor InterimPlaza te kiezen" 12. "Wat onze klanten over ons zeggen" 13. "Onze werkwijze: Van sollicitatie tot plaatsing"

Category 3: CV & Sollicitatietips (20-25 articles)

CV Writing:

1. "De perfecte IT CV schrijven in 2025"
2. "CV template voor Java developers"
3. "CV template voor Frontend developers"
4. "CV template voor DevOps engineers"
5. "Welke skills moet je benadrukken als IT'er?"
6. "Veelgemaakte fouten in IT CV's"
7. "Hoe lang moet je CV zijn?"
8. "Foto op je CV: Wel of niet?"
9. "Hobby's vermelden: Zinvol of overbodig?"

Application Tips: 10. "De perfecte motivatiebrief schrijven" 11. "LinkedIn profiel optimaliseren voor IT'ers" 12. "Sollicitatiegesprek: 20 veelgestelde vragen" 13. "Salaris onderhandelen: Do's and don'ts" 14. "Referenties regelen: Hoe doe je dat?" 15. "Portfolio opbouwen als developer"

CarriereTijger Integration: 16. "Solliciteren via e-mail: De ultieme gids" 17. "Netwerken voor IT professionals" 18. "Personal branding voor developers" 19. "Van junior naar senior: Career path planning" 20. "Hoe blijf je relevant in IT?"

Category 4: Marktinformatie (15-20 articles)

Salary Information:

1. "IT tarieven 2025: Overzicht per specialisatie"
2. "Junior vs medior vs senior: Tarief verschillen"
3. "Java developer tarieven in Nederland"
4. "React developer: Wat kun je verdienen?"
5. "DevOps engineer: Marktconform tarief"
6. "Regionale verschillen in IT tarieven"

Market Trends: 7. "Meest gevraagde IT skills in 2025" 8. "Groeiende technologieën: Waar investeren?" 9. "Remote werk: Impact op tarieven" 10. "Vraag en aanbod in IT markt Q4 2024" 11. "AI en automation: Impact op IT banen"

Regional Info: 12. "IT markt Amsterdam vs Rotterdam" 13. "Remote IT jobs: Kansen en uitdagingen" 14. "IT jobs in de Randstad: Overzicht" 15. "Buitenlandse IT opdrachten: Wat je moet weten"

Category 5: Veelgestelde Vragen (30+ articles)

Application Process:

1. "Hoe werkt het sollicitatieproces?"
2. "Hoe lang duurt de plaatsingsprocedure?"
3. "Kan ik op meerdere vacatures solliciteren?"
4. "Wat gebeurt er na mijn sollicitatie?"
5. "Krijg ik altijd een reactie?"

Contracts & Terms: 6. "Wat staat er in mijn contract?" 7. "Opzegtermijn: Hoe zit dat?" 8. "Kan ik een contract aanpassen?" 9. "Wat als opdracht voortijdig stopt?" 10. "Proeftijd: Hoe werkt dat?"

Payments & Admin: 11. "Wanneer krijg ik mijn salaris?" 12. "Hoe werkt de urenstaat?" 13. "Onkostenvergoeding: Wat mag ik declareren?" 14. "Belasting: Wat moet ik weten?" 15. "Pensioenopbouw bij detachering"

Training & Development: 16. "Is er opleidingsbudget beschikbaar?" 17. "Certificeringen: Worden die vergoed?" 18. "Doorgroeimogelijkheden binnen detachering" 19. "Coaching en begeleiding tijdens opdracht"

Practical Questions: 20. "Kan ik mijn eigen laptop gebruiken?" 21. "Reiskosten: Wat wordt vergoed?" 22. "Thuiswerken: Is dat mogelijk?" 23. "Vacantiedagen: Hoeveel heb ik recht op?"

Category 6: Succesverhalen (10-15 articles)

Case Studies:

1. "Van junior naar senior in 2 jaar: Mark's verhaal"
2. "ZZP naar detachering: Waarom Lisa de switch maakte"
3. "International opdracht via InterimPlaza: John's experience"
4. "Mijn eerste IT opdracht: Sarah's journey"
5. "Van opdracht naar vast: Patrick's verhaal"

Testimonials: 6. "Waarom ik alleen nog via InterimPlaza werk" 7. "De beste beslissing van mijn carrière" 8. "Hoe InterimPlaza mij hielp mijn droomjob te vinden"

Before/After: 9. "Van werkzoekend naar 3 aanbiedingen in 2 weken" 10. "Salarisstijging van 30%: Hoe het gebeurde"

🚀 Implementation Plan

Week 1: Backend Development

Days 1-2: Database & Entities

• [ ] Create Article entity with all fields
• [ ] Create ArticleRating entity
• [ ] Create ArticleBookmark entity
• [ ] Set up repositories
• [ ] Database migrations

Days 3-5: API Development

• [ ] Article CRUD service
• [ ] Search functionality (full-text)
• [ ] Rating system
• [ ] Bookmark system
• [ ] Admin endpoints
• [ ] Public endpoints
• [ ] Unit tests

Week 2: Frontend Components

Days 1-2: KB Home & Navigation

• [ ] Knowledge Base home component
• [ ] Category overview cards
• [ ] Search bar component
• [ ] Navigation integration

Days 3-5: Article Components

• [ ] Article list component
• [ ] Article detail component
• [ ] Search results component
• [ ] Rating widget
• [ ] Bookmark functionality
• [ ] Related articles sidebar

Week 3: Admin CMS

Days 1-3: Admin Interface

• [ ] Admin KB management component
• [ ] Markdown editor integration (e.g., ngx-markdown-editor)
• [ ] Article preview
• [ ] Image upload
• [ ] Category/tag management
• [ ] Publish workflow

Days 4-5: Analytics & Optimization

• [ ] Article analytics dashboard
• [ ] Search optimization
• [ ] Performance testing
• [ ] Mobile responsiveness

Week 4: Content Creation & Testing

Days 1-3: Content Writing

• [ ] Write 20 articles across all categories
• [ ] Create article templates
• [ ] Add images and formatting
• [ ] SEO optimization

Days 4-5: QA & Launch

• [ ] Cross-browser testing
• [ ] Mobile testing
• [ ] Content review
• [ ] SEO check
• [ ] Soft launch
• [ ] Documentation

📊 Analytics & Metrics

Track These Metrics:

1. Article Performance

   • Views per article
   • Average time on page
   • Bounce rate
   • Rating distribution
   • Helpful votes

2. User Engagement

   • Search queries
   • Most viewed categories
   • Bookmarks per user
   • Share counts
   • Comment activity

3. Content Gaps

   • Failed searches (no results)
   • Low-rated articles
   • Requested topics (via feedback)

🔗 Integration Points

Navigation Updates

• Add "Kennisbank" to main navigation
• Add KB link to footer
• Add KB widget to homepage
• Add "Learn More" links on job detail pages

Search Integration

• Include KB articles in global search
• Show KB results alongside jobs
• Related KB articles on job pages

User Journey

• New users → Suggested KB articles
• After application → Related tips
• Email newsletters → Featured articles

⚠️ Considerations & Risks

Technical Risks

• Search Performance: Full-text search on large content
  • Mitigation: Use database indexes, consider Elasticsearch for >1000 articles
• Content Management: Non-technical users need to edit content
  • Mitigation: User-friendly WYSIWYG editor, training
• Mobile Performance: Rich content on mobile
  • Mitigation: Lazy loading, image optimization

Content Risks

• Content Quality: Maintaining high-quality, accurate information
  • Mitigation: Editorial review process, regular audits
• Outdated Information: Market info changes frequently
  • Mitigation: Content review schedule, update reminders
• Legal Compliance: Advice must be legally sound
  • Mitigation: Legal review for sensitive topics, disclaimers

🎯 Success Criteria

Sprint 5 is successful when:

• ✅ All 6 categories have at least 5 articles each
• ✅ Admin can create/publish articles without developer help
• ✅ Search returns relevant results in <1 second
• ✅ KB is accessible from main navigation
• ✅ Mobile KB interface is fully responsive
• ✅ Analytics are tracking views and ratings
• ✅ At least 10 articles have content from CarriereTijger best practices
• ✅ All articles follow consistent formatting and tone

📋 Dependencies

Requires from Sprint 4:

• ✅ Admin navigation working
• ✅ UI components and design system finalized
• ✅ User authentication system complete
• ✅ File upload functionality (for images)

Blocks:

• Nothing - KB is independent feature
• Can be deployed separately if needed

💡 Future Enhancements (Post-Sprint 5)

Phase 2 Features:

• [ ] Comment system on articles
• [ ] Article suggestions based on user behavior
• [ ] Email digest of new articles
• [ ] Print-friendly article format
• [ ] PDF export of articles
• [ ] Multi-language support (EN/NL)
• [ ] Video content integration
• [ ] Interactive calculators (salary, tax)
• [ ] Chatbot trained on KB content

Advanced Features:

• [ ] AI-powered article recommendations
• [ ] Auto-translation of articles
• [ ] Voice search
• [ ] Article versioning and history
• [ ] Community contributions
• [ ] Expert Q&A section

📝 Notes

Content Sources:

• CarriereTijger (application tips)
• Tweakers forum discussions (market insights)
• Industry reports (salary data)
• Legal advisors (contract info)
• Internal expertise (detachering specifics)

SEO Strategy:

• Target long-tail keywords (e.g., "java developer salaris nederland")
• Create pillar content for each category
• Internal linking between articles
• Regular content updates for freshness
• Schema markup for rich snippets

Competitive Advantage:

• Most interim bureaus don't have extensive KB
• Positions InterimPlaza as thought leader
• Builds trust with transparent information
• Improves organic search traffic
• Reduces support inquiries

Last Updated: 2025-10-15 Status: Planning Phase Next Review: After Sprint 4 completion