Files
Webklar-Kundenbereich/server/services/invoiceNinja.js
Kenso Grimm 177ee6a13d feat: Admin-Bereich im Kundenportal (Ticketsystem-Login, Projektsuche, Kundenverwaltung)
- Login: Appwrite-User mit Label 'admin' (Ticketsystem-Mitarbeiter) bekommen
  eine Admin-Session und landen auf /admin.html
- Admin-Dashboard: Statistik-Uebersicht, Projektsuche ueber alle Projekte
  (inkl. Preview-/Gitea-Links, Vorschau ohne Kunden-Login), Kundenliste mit
  Portal-Status, letztem Login und Projektanzahl
- Kundennummer (code) direkt im Admin-Bereich pflegbar
- 'Als Kunde ansehen': Admin sieht das Portal exakt wie der Kunde (Banner
  mit Rueckweg zur Admin-Uebersicht)
- Kunden-Dashboard: neue Bereiche 'Meine Rechnungen' (InvoiceNinja inkl.
  Link ins Rechnungsportal) und 'Was wurde gemacht' (Tickets + Worksheets
  aus dem Ticketsystem, ohne interne Akquise-Tickets); Kundennummer im Header
- Admin-API /api/portal-admin/* (Session-basiert), Kunden-API /api/invoices
  und /api/activity
- appwriteClient: uebrig gebliebene Debug-Instrumentierung entfernt

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 17:09:39 +00:00

151 lines
4.6 KiB
JavaScript

import { config } from '../config.js'
function getPrimaryContact(client) {
const contacts = client?.contacts || []
return contacts.find((c) => c.is_primary) || contacts[0] || {}
}
export function sanitizeInvoiceClient(client) {
const contact = getPrimaryContact(client)
const baseUrl = config.invoiceNinja.url
return {
id: client.id,
number: client.number || '',
displayName: client.display_name || client.name || '',
companyName: client.name || '',
website: client.website || '',
phone: contact.phone || client.phone || '',
email: contact.email || '',
contactFirstName: contact.first_name || '',
contactLastName: contact.last_name || '',
address1: client.address1 || '',
address2: client.address2 || '',
city: client.city || '',
state: client.state || '',
postalCode: client.postal_code || '',
countryId: client.country_id || '',
vatNumber: client.vat_number || '',
idNumber: client.id_number || '',
balance: Number(client.balance ?? 0),
paidToDate: Number(client.paid_to_date ?? 0),
publicNotes: client.public_notes || '',
privateNotes: client.private_notes || '',
editUrl: `${baseUrl}/clients/${client.id}/edit`,
}
}
const INVOICE_STATUS_LABELS = {
1: 'Entwurf',
2: 'Offen',
3: 'Teilzahlung',
4: 'Bezahlt',
5: 'Storniert',
6: 'Storniert',
}
export function sanitizeInvoice(inv) {
const today = new Date().toISOString().slice(0, 10)
const balance = Number(inv.balance ?? 0)
const statusId = Number(inv.status_id ?? 0)
const overdue = balance > 0 && Boolean(inv.due_date) && inv.due_date < today && statusId !== 5
const invitationKey = inv.invitations?.[0]?.key || ''
return {
id: inv.id,
number: inv.number || '',
date: inv.date || '',
dueDate: inv.due_date || '',
amount: Number(inv.amount ?? 0),
balance,
statusId,
status: overdue ? 'Überfällig' : INVOICE_STATUS_LABELS[statusId] || 'Offen',
overdue,
poNumber: inv.po_number || '',
publicNotes: inv.public_notes || '',
// Link ins InvoiceNinja-Kundenportal (Rechnung ansehen/zahlen)
portalUrl: invitationKey ? `${config.invoiceNinja.url}/client/invoice/${invitationKey}` : '',
}
}
/** Rechnungen eines InvoiceNinja-Clients (fuer Kundenportal + Admin-Ansicht). */
export async function listInvoicesForClient(clientId, { includeDrafts = false } = {}) {
const token = config.invoiceNinja.apiToken
if (!token) {
const error = new Error('INVOICE_NINJA_API_TOKEN ist nicht konfiguriert')
error.status = 503
throw error
}
if (!clientId) return []
const url = new URL(`${config.invoiceNinja.url}/api/v1/invoices`)
url.searchParams.set('client_id', String(clientId))
url.searchParams.set('per_page', '100')
url.searchParams.set('sort', 'date|desc')
const response = await fetch(url, {
headers: {
'X-API-TOKEN': token,
'X-Requested-With': 'XMLHttpRequest',
Accept: 'application/json',
},
})
const data = await response.json().catch(() => ({}))
if (!response.ok) {
const error = new Error(data.message || 'Invoice Ninja API Fehler')
error.status = response.status === 401 ? 502 : response.status
throw error
}
return (data.data || [])
.filter((inv) => !inv.is_deleted)
.map(sanitizeInvoice)
.filter((inv) => includeDrafts || inv.statusId !== 1)
}
export async function listInvoiceNinjaClients() {
const token = config.invoiceNinja.apiToken
if (!token) {
const error = new Error('INVOICE_NINJA_API_TOKEN ist nicht konfiguriert')
error.status = 503
throw error
}
const clients = []
let page = 1
let totalPages = 1
while (page <= totalPages) {
const url = new URL(`${config.invoiceNinja.url}/api/v1/clients`)
url.searchParams.set('per_page', '100')
url.searchParams.set('page', String(page))
url.searchParams.set('include', 'contacts')
const response = await fetch(url, {
headers: {
'X-API-TOKEN': token,
'X-Requested-With': 'XMLHttpRequest',
Accept: 'application/json',
},
})
const data = await response.json().catch(() => ({}))
if (!response.ok) {
const error = new Error(data.message || 'Invoice Ninja API Fehler')
error.status = response.status === 401 ? 502 : response.status
throw error
}
const batch = (data.data || []).filter((c) => !c.is_deleted)
clients.push(...batch.map(sanitizeInvoiceClient))
totalPages = Number(data.meta?.pagination?.total_pages || 1)
page += 1
}
return clients.sort((a, b) =>
(a.displayName || a.companyName).localeCompare(b.displayName || b.companyName, 'de')
)
}