Developer Onboarding Guide

Willkommen bei Cartly! Dieses Dokument hilft neuen Entwicklern, schnell produktiv zu werden.

Company Overview

Cartly ist eine AI-native ERP+POS SaaS-Plattform für Fashion-Einzelhändler (1–5 Filialen) im DACH-Raum.

• Website: cartly.example.com (in Entwicklung)
• Stage: Pre-MVP / Technical Groundwork
• Stack: Full-Stack (Frontend + Backend, PWA)
• Team: Remote-first,agentengestützt

Organisatorische Struktur

Chief of Staff (CoS)
└── CPTO (Chief Product & Technology Officer)
    ├── DEV (Development)
    ├── QA (Quality Assurance)
    ├── PM (Product Management)
    └── Documentation

Account Setup

1. PaperclipAI Zugang

PaperclipAI ist unsere operative Plattform für Task Management und Agenten-Koordination.

• URL: http://paperclip.local:3100
• Company: Cartly (f9a8031f)
• Dein Agent: wird bei Onboarding durch CPTO erstellt
• Dokumentation: https://docs.paperclip.ing

2. Tooling

Erwartete Tools:

• Git + GitHub
• Node.js 20+ / Python 3.12+
• Docker (für lokale Entwicklung)
• IDE mit TypeScript Support (VS Code empfohlen)

3. Kommunikation

• Telegram Supergroup: https://t.me/+-Hu6PYfDJ9IxOGVi
• Forum Topics: General (#1), AI (#2), Smart Home (#3), Cars (#4), Research (#5), Anwalt (#6), Newsletter (#7), Cron-Jobs (#11)

Tech Stack (Phase 1)

Alle technischen Entscheidungen sind in ADRs dokumentiert:

• Frontend: React 18 + TypeScript + Vite (PWA)
• UI: Radix UI + Tailwind CSS
• Backend: Node.js + Fastify + TypeScript
• ORM: Prisma
• Database: PostgreSQL 16 (Supabase / Neon)
• Cache/Session: Redis (Upstash)
• Auth: JWT + HTTP-only Cookies
• Search: Meilisearch
• AI: OpenRouter
• Infra: Docker + Railway (MVP) → EKS (Scale)
• CI/CD: GitHub Actions
• Monitoring: Sentry + Highlight.io

Details: ADR-001 Tech Stack

Brand & CI

Unsere Corporate Identity ist in knowledge/brand/SPEC.md dokumentiert.

Wichtige Punkte:

• Fonts: Outfit (Headings), JetBrains Mono (Code/Prices)
• Farben: Primary #1A1A2E, Accent #E94560
• CSS Variables: --cartly-* für alle Design-Tokens
• Dark Mode: via [data-theme="dark"] Attribut

Dokumentation

Alle technischen Dokumente leben unter knowledge/:

knowledge/
├── PRDs/              # Product Requirements
├── ADRs/               # Architecture Decisions
├── architecture/      # Architektur-Übersicht
├── onboarding/         # Dieses Dokument
├── runbooks/           # Betriebs-Runbooks
└── brand/             # CI Specification

Arbeitsweise

Issues & Tasks

• Alle Tasks werden über PaperclipAI verwaltet
• Issues haben Prefix CAR- (z.B. CAR-1, CAR-2)
• Status: todo → in_progress → in_review → done

Code Review

• Alle PRs müssen von mindestens einem Team-Member reviewed werden
• CPTO ist final Approver für architekturelle Entscheidungen

Documentation

• Nach jedem Feature-Release: Dokumentation innerhalb von 48h aktualisieren
• ADRs für alle technischen Entscheidungen erstellen

Nächste Schritte

1. ✅ PaperclipAI Zugang einrichten (lass dich von CPTO hinzufügen)
2. ✅ GitHub Repo clonen (URL kommt von DEV Agent)
3. ✅ Brand SPEC.md lesen
4. ✅ PRD-001 durchlesen
5. ✅ Mit CPTO und DEV Agent Issues für erste Woche klären

Kontakt

Rolle	Agent ID	Beschreibung
CPTO	b999c0b2	Architektur & Technologie
DEV	9f66dba7	Development Lead
QA	8d0de613	Quality Assurance
PM	95ed75cd	Product Management
Documentation	a66674bf	Technische Dokumentation