Welcome to the Arctyk ITSM Team¶

Welcome! This onboarding guide will help you get up to speed with Arctyk ITSM development. Whether you're a new team member or a contributor, this section will guide you through everything you need to know.

Quick Start Checklist¶

• Read through team structure to understand roles and responsibilities
• Set up your development environment
• Get access to required tools and services
• Make your first contribution
• Join our communication channels (Slack/Discord)

What is Arctyk ITSM?¶

Arctyk ITSM is a modern, Jira-inspired IT Service Management platform built with Django. It provides:

• Ticket Management - Create, track, and resolve IT tickets
• Project Organization - Group tickets into projects
• Asset Tracking - Manage IT assets and inventory
• Workflow Automation - Automated ticket routing and status transitions
• Integrations - Slack, Teams, Email notifications
• RESTful API - Programmatic access to all features

Core Technologies¶

Arctyk ITSM is built with:

• Backend: Django 5.2.9 LTS (Python 3.11+)
• Database: PostgreSQL 15+
• Task Queue: Celery with Redis
• Frontend: Django Templates, SCSS, vanilla JavaScript
• Deployment: Docker, Docker Compose
• CI/CD: GitHub Actions

Development Philosophy¶

We follow these principles:

1. Developer Experience First - Make it easy to contribute
2. Code Quality - Maintain high standards with linting and tests
3. Documentation - Document as you code
4. Iterative Improvement - Small, focused changes over large rewrites
5. Security - Security is everyone's responsibility

Getting Help¶

• Documentation: Start here first
• GitHub Issues: Report bugs or request features
• Discord: Real-time chat with the team
• Code Review: Ask questions during PR reviews

Next Steps¶

1. Understand the team structure
2. Set up your development environment
3. Make your first contribution

Welcome aboard! 🚀