Imported from TekupDK/tekup (archive/tekup-org-archived-2025-10-22/AGENTS.md). Install upstream with npx skills add TekupDK/tekup --skill tekup-org-archived-2025-10-22. Copyright stays with the author.

Tekup-org AI Agent Context

Project Overview

Tekup is a unified platform providing multi-tenant SaaS solutions with a monorepo architecture. The Job Scheduling System for Danish Cleaning Industry has been completed and is now ready for production deployment with Docker containerization.

Architecture & Tech Stack

Frontend

• Framework: Next.js 15.5.2 with TypeScript 5.6.3
• Styling: Tailwind CSS 4.1.1 with Danish cleaning industry design system
• Features: Responsive design, custom SVG icons, gradient backgrounds, mobile-first approach
• Components: Complete scheduling system with 12 integrated modules

Backend

• Framework: Node.js with Express/Fastify (ready for implementation)
• Database: Mock data system implemented, ready for PostgreSQL/MySQL integration
• API: RESTful endpoints design planned with OpenAPI/Swagger documentation
• Integration: AgentScope backend for AI features

Development Environment

• Container: Docker multi-stage build with production optimization
• Environment: Environment variables configured for different stages
• Version Control: Git with clean commit history
• Build System: pnpm workspace with standalone Next.js builds

Current Status - COMPLETED ✅

• ✅ Complete Job Scheduling System: 12-module enterprise platform for Danish cleaning industry
• ✅ Docker Containerization: Production-ready deployment with nginx reverse proxy
• ✅ Danish Localization: Full Danish language support and business compliance
• ✅ AgentScope Integration: Backend AI processing ready
• ✅ Shared Design System: Tailwind CSS 4.1.1 with responsive components
• 🚧 Backend API: Ready for implementation (Next priority)
• 🚧 Authentication: User management system needed
• 🚧 Database Integration: Replace mock data with real persistence

Completed Job Scheduling Platform Modules

Core Business Modules ✅

1. Job Calendar System - Complete scheduling interface with Danish calendar integration
2. Team Management - Employee profiles, skills tracking, availability management
3. Customer Portal - Client interface with booking and communication features
4. Route Optimization - Intelligent routing for cleaning teams across Denmark
5. Recurring Jobs - Automated scheduling for repeat customers
6. Analytics Dashboard - KPI tracking, revenue analysis, performance metrics
7. Quality Control - Inspection checklists, photo documentation, ratings
8. Inventory Management - Cleaning supplies, equipment tracking, auto-reordering
9. Employee Scheduling - Shift management, overtime tracking, availability planning
10. Customer Communication - SMS/Email notifications, feedback system, templates

Technical Implementation ✅

• Foundation Setup: TypeScript interfaces for Danish cleaning industry
• Final Integration: All modules working together with responsive navigation

Next Development Priorities

Immediate (Required for Production)

1. Backend API Implementation

   • NestJS backend with PostgreSQL/MySQL database
   • Authentication and authorization system
   • RESTful API endpoints for all job scheduling operations
   • Data validation and business logic implementation

2. Database Integration

   • Replace mock data with real database persistence
   • Prisma ORM setup with migration system
   • Data seeding for initial development/testing
   • Backup and recovery procedures

3. Authentication System

   • JWT-based authentication
   • Role-based access control (Admin, Team Leader, Cleaner, Customer)
   • Session management and security
   • Password reset and user management

Medium Priority

4. API Integration

   • Replace frontend mock data with real API calls
   • HTTP client setup with error handling
   • Loading states and data caching
   • Offline functionality considerations

5. Testing Implementation

   • Unit tests for business logic
   • Component tests for UI modules
   • E2E tests for critical workflows
   • API integration testing

6. Production Infrastructure

   • Environment configuration management
   • Monitoring and logging systems
   • Error tracking and alerting
   • Performance optimization and caching

Advanced Features

7. CI/CD Pipeline

   • GitHub Actions workflows
   • Automated testing and deployment
   • Docker registry integration
   • Staging and production environments

8. Advanced Integrations

   • Payment processing for Danish market
   • SMS/Email service providers
   • Calendar integrations (Google, Outlook)
   • Accounting system integration (e-conomic, Dinero)

Technical Implementation Completed ✅

Component Architecture

• Modular Design: Each business module as independent React component
• Shared Types: Comprehensive TypeScript interfaces for Danish cleaning industry
• Responsive Navigation: 12-tab system with horizontal scroll for mobile
• State Management: Local state with hooks, ready for Redux/Zustand integration
• Mock Data System: Realistic Danish business data for development/demo

Styling System

• Tailwind CSS 4.1.1: Utility-first approach with custom configurations
• Custom Icons: SVG icon system replacing external dependencies
• Gradient Design: Modern gradient backgrounds and card layouts
• Mobile-First: Responsive design tested across device sizes
• Danish UX: Language and cultural considerations in interface design

Docker Production Setup ✅

• Multi-stage Build: Optimized production container with minimal size
• Standalone Mode: Next.js standalone output for efficient Docker deployment
• Environment Config: Production-ready environment variable management
• Nginx Proxy: Reverse proxy setup for production scaling
• Docker Compose: Orchestration files for different deployment scenarios

AI Assistant Guidelines

When Working with Completed Job Scheduling System

• Build on Existing: The 12-module system is complete and functional
• Focus on Backend: Priority should be on API development and database integration
• Maintain Quality: Follow established patterns and Danish localization standards
• Docker Ready: Use existing Docker setup for deployment testing

Code Enhancement Patterns

• TypeScript First: Maintain strict typing throughout all new development
• Danish Standards: Follow local business practices and compliance requirements
• Responsive Design: Ensure all new features work across device sizes
• Component Reuse: Leverage existing UI patterns and styling systems

Database Development (Next Priority)

• Schema Design: Create Prisma schemas matching existing TypeScript interfaces
• Migration Strategy: Plan staged migration from mock data to real persistence
• Data Relationships: Maintain referential integrity for jobs, customers, employees
• Performance: Index strategy for Danish address/postal code lookups

API Development Guidelines

• RESTful Design: Follow established patterns with proper HTTP methods
• Validation: Server-side validation matching frontend TypeScript types
• Error Handling: Consistent error responses with Danish language support
• Documentation: OpenAPI/Swagger documentation for all endpoints
• Security: JWT authentication with role-based access control

Production Deployment

• Environment Management: Separate configs for development, staging, production
• Monitoring Setup: Logging, metrics, and error tracking for Danish market
• Backup Strategy: Regular data backups with disaster recovery procedures
• Scaling Considerations: Horizontal scaling preparation for multi-tenant architecture

File Structure Status

apps/
├── tekup-crm-web/              # ✅ COMPLETED - Job Scheduling System
│   ├── components/scheduling/  # ✅ All 12 modules implemented
│   ├── lib/types/             # ✅ Danish cleaning industry types
│   ├── app/scheduling/        # ✅ Main scheduling interface
│   ├── Dockerfile             # ✅ Production-ready container
│   └── docker-compose.yml     # ✅ Orchestration setup
├── tekup-crm-api/             # 🚧 NEXT - Backend API needed
└── agentscope-backend/        # ✅ AI processing ready

packages/
├── ui/                        # ✅ Shared Tailwind components
├── types/                     # ✅ TypeScript definitions
└── api-client/               # 🚧 HTTP client for API integration

Development Commands

• pnpm dev: Start development servers
• pnpm --filter tekup-crm-web dev: Run job scheduling frontend
• docker-compose up: Production container testing
• pnpm build: Build optimized production bundles

Quality Standards Maintained ✅

• TypeScript: Strict typing with industry-specific interfaces
• Responsive Design: Mobile-first approach with horizontal scroll navigation
• Danish Localization: Complete language and business process support
• Performance: Optimized Docker builds and efficient React components
• Code Quality: Clean, maintainable component architecture

Remember: The Job Scheduling System is production-ready for Danish cleaning companies. Focus now shifts to backend development and database integration to complete the full-stack solution.