Files
Webklar-Kundenbereich/server/services/gitWorksheet.js
Kenso Grimm d4bd510dcd feat: Kundenportal-Ausbau - Tabs, Projekt-Einblicke, Git-Zeiterfassung, Rechnungen, Chat
Kunden-Dashboard:
- Tab-Navigation: Projekte | Was wurde gemacht | Rechnungen | Chat
- Projekt-Details pro Projekt: letzte Git-Commits (Titel+Beschreibung),
  Projektgroesse, Datei-Uebersicht (Top-Level aggregiert), Ticket-Arbeiten
- Rechnungen: gestylte Liste mit Status-Pillen, Ansehen/Zahlen-Link,
  PDF-Download ueber Server-Proxy (IDOR-geschuetzt)
- Chat mit dem Webklar-Team (Polling, Ungelesen-Badge, viewAs blockiert)

Admin-Dashboard:
- Chat-Tab: Konversationsliste + Thread + Antwortfeld, Ungelesen-Badge

Backend:
- giteaAdmin: getRepoInfo, listRepoCommits, getRepoTreeSummary
- projectInsights: 5-min-Cache, Invalidierung per Gitea-Webhook
- /api/projects/:id/git|files|work mit Ownership-Check (404)
- /api/chat/* (Kunde) + /api/portal-admin/chats/* (Admin), portalMessages-Collection
- mailer: E-Mail-Benachrichtigung an Admins bei Kundennachricht (15-min-Throttle)
- gitWorksheet: dd.mm.yyyy, voller Commit-Body, startTime leer (Zeit-Nachtrag),
  Auto-Webpage-Ticket bei Push auf Projekt ohne Ticket (ensureProjectTicket)
- customerActivity: Git-Push-Eintraege fuer Kunden sichtbar

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 18:01:24 +00:00

137 lines
4.1 KiB
JavaScript

import { config } from '../config.js'
import {
listDocuments,
getDocument,
createDocument,
Query,
ID,
} from './appwriteAdmin.js'
const WSID_START = 100000
// worksheets.details ist auf 4000 Zeichen begrenzt
const DETAILS_MAX_LENGTH = 3900
function formatToday() {
// dd.mm.yyyy - gleiches Format wie CreateWorksheetModal der Ticketsystem-SPA
const d = new Date()
const day = String(d.getDate()).padStart(2, '0')
const m = String(d.getMonth() + 1).padStart(2, '0')
return `${day}.${m}.${d.getFullYear()}`
}
function formatTimeNow() {
const d = new Date()
return `${String(d.getHours()).padStart(2, '0')}${String(d.getMinutes()).padStart(2, '0')}`
}
async function generateNextWsid() {
const docs = await listDocuments(config.collections.worksheets, [
Query.orderDesc('wsid'),
Query.limit(1),
])
const highest = docs[0]?.wsid ? parseInt(docs[0].wsid, 10) : WSID_START - 1
return String(Math.max(WSID_START, highest + 1))
}
async function gitWorksheetExists(woid, commitSha) {
if (!commitSha) return false
const docs = await listDocuments(config.collections.worksheets, [
Query.equal('woid', woid),
Query.limit(100),
])
const marker = `Commit: ${commitSha.slice(0, 7)}`
return docs.some((doc) => doc.details?.includes(marker) || doc.details?.includes(commitSha))
}
function formatCommitLines(commits, repoFullName) {
if (!Array.isArray(commits) || commits.length === 0) {
return '- (keine Commit-Details im Webhook)'
}
return commits
.map((commit) => {
const sha = (commit.id || commit.sha || '').slice(0, 7)
// Commit-Titel + Beschreibung (Body) uebernehmen
const [title, ...bodyLines] = String(commit.message || '').trim().split('\n')
const author = commit.author?.name || commit.committer?.name || 'Unbekannt'
const url = commit.url || `${config.gitea.baseUrl}/${repoFullName}/commit/${commit.id || commit.sha}`
const body = bodyLines
.map((line) => line.trim())
.filter(Boolean)
.map((line) => ` ${line}`)
.join('\n')
return `- [${sha}](${url}): ${title} (${author})${body ? `\n${body}` : ''}`
})
.join('\n')
}
export async function createGitPushWorksheet({
ticketId,
repoFullName,
branch,
commits = [],
pusher,
commitSha,
}) {
if (!ticketId) return null
let workorder
try {
workorder = await getDocument(config.collections.workorders, ticketId)
} catch {
console.warn('[gitWorksheet] Workorder nicht gefunden:', ticketId)
return null
}
const woid = workorder.woid
if (!woid) return null
if (await gitWorksheetExists(woid, commitSha)) {
return { skipped: true, reason: 'duplicate_commit' }
}
const wsid = await generateNextWsid()
const pusherName = pusher?.full_name || pusher?.username || pusher?.login || 'Gitea'
const latestCommit = commits[commits.length - 1] || commits[0]
let details = [
`Git Push auf \`${repoFullName}\` (Branch: ${branch})`,
`Commit: ${commitSha?.slice(0, 7) || latestCommit?.id?.slice(0, 7) || '?'}`,
'',
formatCommitLines(commits, repoFullName),
].join('\n')
if (details.length > DETAILS_MAX_LENGTH) {
details = `${details.slice(0, DETAILS_MAX_LENGTH)}\n… (gekuerzt)`
}
// Endzeit = Push-Zeitpunkt. Startzeit bleibt leer und wird im Ticketsystem
// nachgetragen ("Zeit nachtragen") - erst dann zaehlt die Arbeitszeit.
const today = formatToday()
const worksheet = await createDocument(
config.collections.worksheets,
{
wsid,
woid: String(woid),
workorderId: ticketId,
employeeId: 'gitea',
employeeName: pusherName,
employeeShort: 'GIT',
serviceType: 'GIT',
oldStatus: workorder.status || '',
newStatus: workorder.status || '',
oldResponseLevel: workorder.response || '',
newResponseLevel: workorder.response || '',
totalTime: 0,
startDate: today,
startTime: '',
endDate: today,
endTime: formatTimeNow(),
details,
isComment: true,
createdAt: new Date().toISOString(),
},
ID.unique()
)
return { created: true, wsid, worksheetId: worksheet.$id }
}