🏠 ContractPlattform WhiteLabel

Multi-Tenant Real Estate Contract Management Platform

🚀 Quick Start

# 1. Start Database
cd docker && docker-compose up -d

# 2. Install Dependencies
npm install

# 3. Setup Environment
cp .env.example .env

# 4. Start Development Server
npm run dev

Server läuft auf: http://localhost:3000

📊 Status

Component	Status	Description
Core Engine	✅ Ready	Express + TypeScript
API Routes	✅ Ready	REST API mit Cache
sevDesk	✅ Implemented	Rechnungen, Kontakte
evcc	✅ Implemented	Wallbox, Ladevorgänge
Edge Cache	✅ Ready	CF Workers / Memory
MS Graph	🟡 Skeleton	OAuth noch nicht konfiguriert
ista	🔴 TODO	Nebenkostenabrechnung
plane.so	🔴 TODO	Projektmanagement

🔗 Quick Links

Link	Description
API Overview	REST API Dokumentation
Integrations	Externe Systeme
Architecture	System-Architektur
Konzept	Vollständiges Konzept

�️ Tech Stack

• Runtime: Node.js 20+
• Framework: Express.js
• Language: TypeScript 5.x
• Database: PostgreSQL + Prisma
• Cache: In-Memory / Cloudflare KV
• Testing: Vitest

📁 Project Structure

src/
├── main.ts              # Entry Point
├── api/                 # REST Routes
│   └── routes/
├── core/                # Business Logic
│   ├── services/
│   ├── types/
│   └── cache/
├── integrations/        # External APIs
│   ├── sevdesk.ts
│   ├── evcc.ts
│   └── msgraph.ts
└── middleware/          # Express Middleware

edge/                    # Cloudflare Workers
├── worker.ts
└── wrangler.toml

tests/                   # Vitest Tests

🧪 Testing

# Run all tests
npm test

# Run with coverage
npm test -- --coverage