Εφαρμογή του μοτίβου κατασκευής για δυναμικές αναφορές

Παρακάτω είναι μια σταδιακή υλοποίηση χρησιμοποιώντας TypeScript και το Directus SDK. Υποθέστε ότι έχουμε μια τάξη προϊόντων και μια που ενορχηστρώνει την κατασκευή.

1. Καθορίστε το προϊόν

Το προϊόν μπορεί να είναι ένα απλό δοχείο για τμήματα (κεφαλής, σώμα, υποσέλιδο) που αργότερα θα σειριαστεί.

class Report {
 header: string;
 body: string;
 footer: string;
 constructor() {
 this.header = '';
 this.body = '';
 this.footer = '';
 }
 output(): string {
 return `${this.header}\n${this.body}\n${this.footer}`;
 }
}

2. Διεπαφή κατασκευής

interface IReportBuilder {
 reset(): void;
 buildHeader(meta: any): void;
 buildBody(data: any[]): void;
 buildFooter(summary: any): void;
 getReport(): Report;
}

3. Κατασκευαστές σκυροδέματος

Για μια έκθεση CSV:

class CsvReportBuilder implements IReportBuilder {
 private report: Report;
 constructor() { this.report = new Report(); }
 reset(): void { this.report = new Report(); }
 buildHeader(meta: any): void {
 this.report.header = `Report generated: ${meta.generatedAt}`;
 }
 buildBody(data: any[]): void {
 const headers = Object.keys(data[0] || {}).join(',');
 const rows = data.map(row => Object.values(row).join(',')).join('\n');
 this.report.body = `${headers}\n${rows}`;
 }
 buildFooter(summary: any): void {
 this.report.footer = `Total records: ${summary.total}`;
 }
 getReport(): Report { return this.report; }
}

Για μια έκθεση HTML :

class HtmlReportBuilder implements IReportBuilder {
 // Similar structure but builds HTML tags
 buildHeader(meta: any): void {
 this.report.header = `
Report
${meta.generatedAt}
`;
 }
 buildBody(data: any[]): void {
 let table = '' + Object.keys(data[0]).map(k => ``).join('') + '';
 data.forEach(item => {
 table += '' + Object.values(item).map(v => ``).join('') + '';
 });
 table += '
${k}
${v}
';
 this.report.body = table;
 }
 buildFooter(summary: any): void {
 this.report.footer = ``;
 }
 getReport(): Report { return this.report; }
}

4. Η κλάση του διευθυντή

Ο σκηνοθέτης δέχεται έναν κατασκευαστή, παίρνει δεδομένα από τον Directus και καλεί τα βήματα σε τάξη.

class ReportDirector {
 private builder: IReportBuilder;

 setBuilder(builder: IReportBuilder): void {
 this.builder = builder;
 }

 async constructReport(sdk: Directus, collection: string, filters: any): Promise<Report> {
 this.builder.reset();
 // Fetch metadata and data from Directus (simplified)
 const items = await sdk.items(collection).readByQuery({ filter: filters, limit: -1 });
 const meta = { generatedAt: new Date().toISOString() };
 const summary = { total: items.length };

 this.builder.buildHeader(meta);
 this.builder.buildBody(items);
 this.builder.buildFooter(summary);
 return this.builder.getReport();
 }
}

Σημείωση: Σε μια πραγματική εφαρμογή επιχειρήσεων, θα ενέσετε τον πελάτη Directus και θα χειριστείτε την pagination, πρόσβαση με βάση τους ρόλους, και χειρισμό σφαλμάτων.

Παράδειγμα περίπτωσης χρήσης: Multi-Format Report Generation

Φανταστείτε μια επιχείρηση που χρησιμοποιεί Directus για να αποθηκεύσει τα στοιχεία πωλήσεων, την ανάδραση πελατών και τις οικονομικές προβλέψεις.

async function generateReport(req, res) {
 const director = new ReportDirector();
 const builder = req.query.format === 'csv' ? new CsvReportBuilder() : new HtmlReportBuilder();
 director.setBuilder(builder);
 const report = await director.constructReport(sdk, 'sales', {
 date: { _between: [req.query.start, req.query.end] }
 });
 res.setHeader('Content-Type', req.query.format === 'csv' ? 'text/csv' : 'text/html');
 res.send(report.output());
}

Αυτή η προσέγγιση κλιμακώνεται για να χειριστεί σύνθετες αναφορές όπου ο διευθυντής μπορεί να συλλέξει πρόσθετα δεδομένα από πολλαπλές συλλογές Directus (π.χ., ], ) και να τα περάσει στον κατασκευαστή, ανάλογα με τις ανάγκες.

Απομόχλευση ροών Directus και προσαρμοσμένων τελικών σημείων

Για σενάρια χωρίς server ή χωρίς κώδικα, μπορείτε να οικοδομήσετε ένα Directus Flow που ενεργοποιεί ένα Webhook ή προσαρμοσμένο τελικό σημείο χρησιμοποιώντας τη λογική Builder Pattern. Ο Διευθυντής θα τρέξει μέσα σε μια επέκταση Directus (π.χ., ένα Custom Endpoint ή ένα Hook). Αυτό κρατά την παραγωγή αναφοράς μέσα στο οικοσύστημα Directus, χρησιμοποιώντας την αυθεντικότητα και τις άδειες ⁇ όλων του.

• Τελωνείο τελικό σημείο ⁇ Γράψτε μια ενότητα TypeScript που υλοποιεί τον Διευθυντή και τους κατασκευαστές, που εκτίθενται μέσω .
• Flows ⁇ Παραγωγή αναφοράς ενεργοποίησης σε πρόγραμμα (cron) ή μετά από ενημέρωση δεδομένων. Η ροή καλεί το προσαρμοσμένο τελικό σημείο με τις απαιτούμενες παραμέτρους.
• Αρχείο Ανεβάζει[ ⁇ Η τελική αναφορά μπορεί να αποθηκευτεί ως περιουσιακό στοιχείο Directus (συλλογή αρχείων) για μεταγενέστερες λήψεις από τους χρήστες.

Μάθετε περισσότερα για τις επεκτάσεις Directus: Directus Extensions Documentation και για το ίδιο το μοτίβο Builder: Refactoring Guru ⁇ Builder Pattern.

Προχωρημένες Προσεγγίσεις

Χειρισμός μεγάλων συνόλων δεδομένων

Οι εκθέσεις επιχειρήσεων μπορεί να περιλαμβάνουν χιλιάδες εγγραφές. Το μοτίβο του κατασκευαστή μπορεί να συνδυαστεί με τεχνικές streaming: οι ροές του κατασκευαστή για τις διαχωρισμένες απαντήσεις Directus API και προσαρτώνται σε ένα ρεύμα (π.χ., χρησιμοποιώντας τις ροές Node.js ). Ο διευθυντής θα πρέπει να παρακολουθεί την πρόοδο και να ματαιώνει αν ο χρήστης ακυρώσει.

Εντοπισμός και εμπορικό σήμα

Οι κατασκευαστές σκυροδέματος μπορούν να δεχτούν μια τοπική ή εμπορική διαμόρφωση. Για παράδειγμα, [[LFT:18]] μπορούν να φορτώσουν ένα πρότυπο περιεχομένου Directus αποθηκευμένο (μέσω του χαρακτηριστικού [[LFT:19]]]) για την παραγωγή πολυγλωσσικών αναφορών.”

Μονάδα δοκιμής του διευθυντή

Mock the Directus SDK: εγχέετε ένα ψεύτικο που επιστρέφει προκαθορισμένα δεδομένα. Στη συνέχεια επαληθεύστε ότι η έξοδος αναφοράς ταιριάζει με την αναμενόμενη δομή. Κάθε βήμα οικοδόμος μπορεί να δοκιμαστεί σε απομόνωση με περιπτώσεις άκρων (κενά δεδομένα, ελλείποντα πεδία).

Συμπέρασμα

Το Builder Pattern προσφέρει μια ισχυρή, κλιμακούμενη προσέγγιση για τη δημιουργία σύνθετων δυναμικών αναφορών στο λογισμικό επιχειρήσεων που τρέχει στο Directus. Διαχωρίζοντας τη δημιουργία αναφορών σε διακριτά βήματα ⁇ κεφαλής, σώμα, υποσέλιδο ⁇ και την ανάθεση τους σε συγκεκριμένους κατασκευαστές, οι οργανισμοί αποκτούν ευελιξία για να υποστηρίξουν νέες μορφές χωρίς να αγγίζουν τη λογική πυρήνα. Ο ρόλος ενορχήστρωσης του Διευθυντή ευθυγραμμίζεται τακτοποιημένα με τα δεδομένα του Directus ⁇ πρώτη φιλοσοφία, επιτρέποντας στους προγραμματιστές να επικεντρωθούν στους επιχειρηματικούς κανόνες και την παρουσίαση. Είτε χρειάζεστε άμεσες εξαγωγές CSV, στυλ HTML ταμπλό, ή έγγραφα PDF, το Builder Pattern σε συνδυασμό με την επεκτασιμότητα Directus παρέχει μια καθαρή, διατηρητέα αρχιτεκτονική για απαιτητικές απαιτήσεις αναφοράς επιχειρήσεων.

Για περαιτέρω ανάγνωση, βλέπε Directus Collections and Items API για να κατανοηθεί πώς να δομούν τα δεδομένα για τις αναφορές, και Gang of Four book για την περιγραφή κανονικού μοτίβου.