@hed-hog/lms 0.0.330 → 0.0.338

package/dist/enterprise/enterprise.service.js

@@ -81,6 +81,7 @@ let EnterpriseService = class EnterpriseService {
                         id: true,
                         name: true,
                         type: true,
+                        avatar_id: true,
                     },
                 },
                 _count: {
@@ -135,6 +136,140 @@ let EnterpriseService = class EnterpriseService {
         await this.assertEnterpriseExists(id);
         return this.prisma.enterprise.update({ where: { id }, data: dto });
     }
+    async getOverview(id) {
+        const enterprise = await this.getById(id);
+        if (!enterprise)
+            return null;
+        const eventModel = this.prisma.enterprise_student_license_event;
+        const now = new Date();
+        const timelineStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 11, 1));
+        const [studentRows, scheduledClasses, licenseEvents, recentCourses, recentClasses, recentStudents, recentAdmins,] = await Promise.all([
+            this.prisma.enterprise_student.findMany({
+                where: { enterprise_id: id },
+                select: {
+                    person_id: true,
+                    status: true,
+                    created_at: true,
+                    person: { select: { id: true, name: true } },
+                },
+            }),
+            this.prisma.enterprise_class_group.findMany({
+                where: {
+                    enterprise_id: id,
+                    course_class_group: { status: { in: ['open', 'ongoing'] } },
+                },
+                select: {
+                    created_at: true,
+                    course_class_group: {
+                        select: {
+                            id: true,
+                            code: true,
+                            title: true,
+                            status: true,
+                            capacity: true,
+                            course: { select: { title: true } },
+                            _count: {
+                                select: {
+                                    course_enrollment: {
+                                        where: { status: { not: 'cancelled' } },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            }),
+            eventModel
+                ? eventModel
+                    .findMany({
+                    where: { enterprise_id: id },
+                    orderBy: { created_at: 'asc' },
+                    select: {
+                        person_id: true,
+                        event_type: true,
+                        previous_status: true,
+                        next_status: true,
+                        created_at: true,
+                        person: { select: { id: true, name: true } },
+                    },
+                })
+                    .catch(() => [])
+                : Promise.resolve([]),
+            this.prisma.enterprise_course.findMany({
+                where: { enterprise_id: id },
+                take: 5,
+                orderBy: { created_at: 'desc' },
+                select: {
+                    created_at: true,
+                    course: { select: { id: true, title: true } },
+                },
+            }),
+            this.prisma.enterprise_class_group.findMany({
+                where: { enterprise_id: id },
+                take: 5,
+                orderBy: { created_at: 'desc' },
+                select: {
+                    created_at: true,
+                    course_class_group: {
+                        select: {
+                            id: true,
+                            code: true,
+                            title: true,
+                            course: { select: { title: true } },
+                        },
+                    },
+                },
+            }),
+            this.prisma.enterprise_student.findMany({
+                where: { enterprise_id: id },
+                take: 5,
+                orderBy: { created_at: 'desc' },
+                select: {
+                    created_at: true,
+                    person: { select: { id: true, name: true } },
+                },
+            }),
+            this.prisma.enterprise_user.findMany({
+                where: { enterprise_id: id },
+                take: 5,
+                orderBy: { created_at: 'desc' },
+                select: {
+                    created_at: true,
+                    role: true,
+                    user: { select: { id: true, name: true } },
+                },
+            }),
+        ]);
+        const used = studentRows.length;
+        const limit = enterprise.licenseLimit;
+        const available = limit === null ? null : Math.max(limit - used, 0);
+        const percent = limit && limit > 0 ? Math.min(100, Math.round((used / limit) * 100)) : 0;
+        const capacity = scheduledClasses.reduce((sum, row) => { var _a, _b; return sum + Math.max((_b = (_a = row.course_class_group) === null || _a === void 0 ? void 0 : _a.capacity) !== null && _b !== void 0 ? _b : 0, 0); }, 0);
+        const seatsUsed = scheduledClasses.reduce((sum, row) => { var _a, _b, _c; return sum + ((_c = (_b = (_a = row.course_class_group) === null || _a === void 0 ? void 0 : _a._count) === null || _b === void 0 ? void 0 : _b.course_enrollment) !== null && _c !== void 0 ? _c : 0); }, 0);
+        return {
+            account: enterprise,
+            kpis: {
+                students: enterprise.studentsCount,
+                classes: enterprise.classesCount,
+                courses: enterprise.coursesCount,
+                administrators: enterprise.adminsCount + enterprise.managersCount,
+                portalEnabled: enterprise.portalEnabled,
+            },
+            licenseUsage: {
+                used,
+                limit,
+                available,
+                percent,
+            },
+            scheduledSeats: {
+                used: seatsUsed,
+                open: Math.max(capacity - seatsUsed, 0),
+                capacity,
+            },
+            licenseTimeline: this.buildLicenseTimeline(studentRows, licenseEvents, timelineStart, now),
+            activities: this.buildEnterpriseActivities(licenseEvents, recentCourses, recentClasses, recentStudents, recentAdmins),
+        };
+    }
     async delete(id) {
         await this.assertEnterpriseExists(id);
         return this.prisma.enterprise.delete({ where: { id } });
@@ -149,6 +284,154 @@ let EnterpriseService = class EnterpriseService {
             throw new common_1.NotFoundException(`Enterprise #${id} not found`);
         return exists;
     }
+    async recordLicenseEvent(params) {
+        var _a, _b;
+        const eventModel = this.prisma.enterprise_student_license_event;
+        if (!eventModel)
+            return;
+        try {
+            await eventModel.create({
+                data: {
+                    enterprise_id: params.enterpriseId,
+                    person_id: params.personId,
+                    event_type: params.eventType,
+                    previous_status: (_a = params.previousStatus) !== null && _a !== void 0 ? _a : null,
+                    next_status: (_b = params.nextStatus) !== null && _b !== void 0 ? _b : null,
+                },
+            });
+        }
+        catch (_c) {
+            // The YAML/DB apply step may not have run yet in older environments.
+        }
+    }
+    monthKey(date) {
+        const year = date.getUTCFullYear();
+        const month = String(date.getUTCMonth() + 1).padStart(2, '0');
+        return `${year}-${month}`;
+    }
+    monthLabel(date) {
+        return date.toLocaleDateString('pt-BR', {
+            month: 'short',
+            year: '2-digit',
+            timeZone: 'UTC',
+        });
+    }
+    buildLicenseTimeline(studentRows, eventRows, start, end) {
+        const eventsByPerson = new Set(eventRows
+            .filter((event) => event.event_type === 'assigned')
+            .map((event) => event.person_id));
+        const syntheticEvents = studentRows
+            .filter((student) => !eventsByPerson.has(student.person_id))
+            .map((student) => ({
+            person_id: student.person_id,
+            event_type: 'assigned',
+            previous_status: null,
+            next_status: 'active',
+            created_at: student.created_at,
+        }));
+        const allEvents = [...eventRows, ...syntheticEvents].sort((a, b) => a.created_at.getTime() - b.created_at.getTime());
+        let running = 0;
+        for (const event of allEvents) {
+            if (event.created_at >= start)
+                break;
+            running += this.getLicenseEventDelta(event);
+            running = Math.max(running, 0);
+        }
+        const points = [];
+        const cursor = new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), 1));
+        while (cursor <= end) {
+            const key = this.monthKey(cursor);
+            const monthEvents = allEvents.filter((event) => this.monthKey(event.created_at) === key);
+            const assigned = monthEvents.filter((event) => this.getLicenseEventDelta(event) > 0).length;
+            const revoked = monthEvents.filter((event) => this.getLicenseEventDelta(event) < 0).length;
+            for (const event of monthEvents) {
+                running += this.getLicenseEventDelta(event);
+                running = Math.max(running, 0);
+            }
+            points.push({
+                period: key,
+                label: this.monthLabel(cursor),
+                used: running,
+                assigned,
+                revoked,
+            });
+            cursor.setUTCMonth(cursor.getUTCMonth() + 1);
+        }
+        return points;
+    }
+    getLicenseEventDelta(event) {
+        if (event.event_type === 'assigned')
+            return 1;
+        if (event.event_type === 'revoked')
+            return -1;
+        if (event.event_type === 'status_changed') {
+            const wasActive = event.previous_status !== 'inactive';
+            const isActive = event.next_status !== 'inactive';
+            if (!wasActive && isActive)
+                return 1;
+            if (wasActive && !isActive)
+                return -1;
+        }
+        return 0;
+    }
+    buildEnterpriseActivities(licenseEvents, courses, classes, students, admins) {
+        return [
+            ...licenseEvents.slice(-10).map((event) => {
+                var _a, _b, _c, _d;
+                return ({
+                    id: `license-${(_b = (_a = event.person) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 'unknown'}-${event.created_at.getTime()}`,
+                    type: event.event_type,
+                    title: event.event_type === 'revoked'
+                        ? 'Licenca removida'
+                        : 'Licenca atribuida',
+                    description: (_d = (_c = event.person) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : 'Aluno',
+                    createdAt: event.created_at,
+                });
+            }),
+            ...courses.map((row) => {
+                var _a, _b, _c, _d;
+                return ({
+                    id: `course-${(_b = (_a = row.course) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 'unknown'}-${row.created_at.getTime()}`,
+                    type: 'course',
+                    title: 'Curso vinculado',
+                    description: (_d = (_c = row.course) === null || _c === void 0 ? void 0 : _c.title) !== null && _d !== void 0 ? _d : 'Curso',
+                    createdAt: row.created_at,
+                });
+            }),
+            ...classes.map((row) => {
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                return ({
+                    id: `class-${(_b = (_a = row.course_class_group) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 'unknown'}-${row.created_at.getTime()}`,
+                    type: 'class',
+                    title: 'Turma vinculada',
+                    description: (_j = (_f = (_d = (_c = row.course_class_group) === null || _c === void 0 ? void 0 : _c.code) !== null && _d !== void 0 ? _d : (_e = row.course_class_group) === null || _e === void 0 ? void 0 : _e.title) !== null && _f !== void 0 ? _f : (_h = (_g = row.course_class_group) === null || _g === void 0 ? void 0 : _g.course) === null || _h === void 0 ? void 0 : _h.title) !== null && _j !== void 0 ? _j : 'Turma',
+                    createdAt: row.created_at,
+                });
+            }),
+            ...students.map((row) => {
+                var _a, _b, _c, _d;
+                return ({
+                    id: `student-${(_b = (_a = row.person) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 'unknown'}-${row.created_at.getTime()}`,
+                    type: 'student',
+                    title: 'Aluno adicionado',
+                    description: (_d = (_c = row.person) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : 'Aluno',
+                    createdAt: row.created_at,
+                });
+            }),
+            ...admins.map((row) => {
+                var _a, _b, _c;
+                return ({
+                    id: `admin-${(_b = (_a = row.user) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 'unknown'}-${row.created_at.getTime()}`,
+                    type: 'admin',
+                    title: 'Administrador adicionado',
+                    description: ((_c = row.user) === null || _c === void 0 ? void 0 : _c.name) ? `${row.user.name} (${row.role})` : row.role,
+                    createdAt: row.created_at,
+                });
+            }),
+        ]
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, 12);
+    }
     async resolveRoleId(slug) {
         var _a;
         const role = await this.prisma.role.findUnique({
@@ -218,6 +501,7 @@ let EnterpriseService = class EnterpriseService {
                             id: true,
                             name: true,
                             last_login_at: true,
+                            photo_id: true,
                             user_identifier: {
                                 where: { type: 'email' },
                                 select: { value: true },
@@ -235,16 +519,17 @@ let EnterpriseService = class EnterpriseService {
             pageSize,
             lastPage: Math.max(1, Math.ceil(total / pageSize)),
             data: rows.map((r) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h;
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
                 return ({
                     id: r.id,
                     userId: r.user_id,
                     personId: r.person_id,
                     name: (_b = (_a = r.user) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : null,
                     email: (_f = (_e = (_d = (_c = r.user) === null || _c === void 0 ? void 0 : _c.user_identifier) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.value) !== null && _f !== void 0 ? _f : null,
+                    photoId: (_h = (_g = r.user) === null || _g === void 0 ? void 0 : _g.photo_id) !== null && _h !== void 0 ? _h : null,
                     role: r.role,
                     status: r.status,
-                    lastAccessAt: (_h = (_g = r.user) === null || _g === void 0 ? void 0 : _g.last_login_at) !== null && _h !== void 0 ? _h : null,
+                    lastAccessAt: (_k = (_j = r.user) === null || _j === void 0 ? void 0 : _j.last_login_at) !== null && _k !== void 0 ? _k : null,
                 });
             }),
         };
@@ -336,6 +621,16 @@ let EnterpriseService = class EnterpriseService {
                             status: true,
                             level: true,
                             offering_type: true,
+                            course_image: {
+                                where: { image_type: { slug: 'course-logo' } },
+                                take: 1,
+                                select: {
+                                    file_id: true,
+                                    file: {
+                                        select: { id: true },
+                                    },
+                                },
+                            },
                         },
                     },
                 },
@@ -348,17 +643,19 @@ let EnterpriseService = class EnterpriseService {
             pageSize,
             lastPage: Math.max(1, Math.ceil(total / pageSize)),
             data: rows.map((r) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                return ({
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+                const courseLogo = (_c = (_b = (_a = r.course) === null || _a === void 0 ? void 0 : _a.course_image) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : null;
+                return {
                     id: r.id,
                     courseId: r.course_id,
                     contractedAt: r.contracted_at,
-                    title: (_b = (_a = r.course) === null || _a === void 0 ? void 0 : _a.title) !== null && _b !== void 0 ? _b : null,
-                    slug: (_d = (_c = r.course) === null || _c === void 0 ? void 0 : _c.slug) !== null && _d !== void 0 ? _d : null,
-                    status: (_f = (_e = r.course) === null || _e === void 0 ? void 0 : _e.status) !== null && _f !== void 0 ? _f : null,
-                    level: (_h = (_g = r.course) === null || _g === void 0 ? void 0 : _g.level) !== null && _h !== void 0 ? _h : null,
-                    modality: (_k = (_j = r.course) === null || _j === void 0 ? void 0 : _j.offering_type) !== null && _k !== void 0 ? _k : null,
-                });
+                    title: (_e = (_d = r.course) === null || _d === void 0 ? void 0 : _d.title) !== null && _e !== void 0 ? _e : null,
+                    slug: (_g = (_f = r.course) === null || _f === void 0 ? void 0 : _f.slug) !== null && _g !== void 0 ? _g : null,
+                    status: (_j = (_h = r.course) === null || _h === void 0 ? void 0 : _h.status) !== null && _j !== void 0 ? _j : null,
+                    level: (_l = (_k = r.course) === null || _k === void 0 ? void 0 : _k.level) !== null && _l !== void 0 ? _l : null,
+                    modality: (_o = (_m = r.course) === null || _m === void 0 ? void 0 : _m.offering_type) !== null && _o !== void 0 ? _o : null,
+                    logoFileId: (_r = (_q = (_p = courseLogo === null || courseLogo === void 0 ? void 0 : courseLogo.file) === null || _p === void 0 ? void 0 : _p.id) !== null && _q !== void 0 ? _q : courseLogo === null || courseLogo === void 0 ? void 0 : courseLogo.file_id) !== null && _r !== void 0 ? _r : null,
+                };
             }),
         };
     }
@@ -425,7 +722,43 @@ let EnterpriseService = class EnterpriseService {
                             start_date: true,
                             end_date: true,
                             capacity: true,
-                            course: { select: { id: true, title: true, slug: true } },
+                            _count: {
+                                select: {
+                                    course_enrollment: {
+                                        where: {
+                                            status: { not: 'cancelled' },
+                                        },
+                                    },
+                                },
+                            },
+                            instructor: {
+                                select: {
+                                    id: true,
+                                    person: {
+                                        select: {
+                                            name: true,
+                                            avatar_id: true,
+                                        },
+                                    },
+                                },
+                            },
+                            course: {
+                                select: {
+                                    id: true,
+                                    title: true,
+                                    slug: true,
+                                    course_image: {
+                                        where: { image_type: { slug: 'course-logo' } },
+                                        take: 1,
+                                        select: {
+                                            file_id: true,
+                                            file: {
+                                                select: { id: true },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
                         },
                     },
                 },
@@ -438,20 +771,26 @@ let EnterpriseService = class EnterpriseService {
             pageSize,
             lastPage: Math.max(1, Math.ceil(total / pageSize)),
             data: rows.map((r) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
-                return ({
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16;
+                const courseLogo = (_d = (_c = (_b = (_a = r.course_class_group) === null || _a === void 0 ? void 0 : _a.course) === null || _b === void 0 ? void 0 : _b.course_image) === null || _c === void 0 ? void 0 : _c[0]) !== null && _d !== void 0 ? _d : null;
+                return {
                     id: r.id,
                     courseClassGroupId: r.course_class_group_id,
-                    code: (_b = (_a = r.course_class_group) === null || _a === void 0 ? void 0 : _a.code) !== null && _b !== void 0 ? _b : null,
-                    title: (_d = (_c = r.course_class_group) === null || _c === void 0 ? void 0 : _c.title) !== null && _d !== void 0 ? _d : null,
-                    status: (_f = (_e = r.course_class_group) === null || _e === void 0 ? void 0 : _e.status) !== null && _f !== void 0 ? _f : null,
-                    deliveryMode: (_h = (_g = r.course_class_group) === null || _g === void 0 ? void 0 : _g.delivery_mode) !== null && _h !== void 0 ? _h : null,
-                    startDate: (_k = (_j = r.course_class_group) === null || _j === void 0 ? void 0 : _j.start_date) !== null && _k !== void 0 ? _k : null,
-                    endDate: (_m = (_l = r.course_class_group) === null || _l === void 0 ? void 0 : _l.end_date) !== null && _m !== void 0 ? _m : null,
-                    capacity: (_p = (_o = r.course_class_group) === null || _o === void 0 ? void 0 : _o.capacity) !== null && _p !== void 0 ? _p : null,
-                    courseTitle: (_s = (_r = (_q = r.course_class_group) === null || _q === void 0 ? void 0 : _q.course) === null || _r === void 0 ? void 0 : _r.title) !== null && _s !== void 0 ? _s : null,
-                    courseSlug: (_v = (_u = (_t = r.course_class_group) === null || _t === void 0 ? void 0 : _t.course) === null || _u === void 0 ? void 0 : _u.slug) !== null && _v !== void 0 ? _v : null,
-                });
+                    code: (_f = (_e = r.course_class_group) === null || _e === void 0 ? void 0 : _e.code) !== null && _f !== void 0 ? _f : null,
+                    title: (_h = (_g = r.course_class_group) === null || _g === void 0 ? void 0 : _g.title) !== null && _h !== void 0 ? _h : null,
+                    status: (_k = (_j = r.course_class_group) === null || _j === void 0 ? void 0 : _j.status) !== null && _k !== void 0 ? _k : null,
+                    deliveryMode: (_m = (_l = r.course_class_group) === null || _l === void 0 ? void 0 : _l.delivery_mode) !== null && _m !== void 0 ? _m : null,
+                    startDate: (_p = (_o = r.course_class_group) === null || _o === void 0 ? void 0 : _o.start_date) !== null && _p !== void 0 ? _p : null,
+                    endDate: (_r = (_q = r.course_class_group) === null || _q === void 0 ? void 0 : _q.end_date) !== null && _r !== void 0 ? _r : null,
+                    capacity: (_t = (_s = r.course_class_group) === null || _s === void 0 ? void 0 : _s.capacity) !== null && _t !== void 0 ? _t : null,
+                    enrolledCount: (_w = (_v = (_u = r.course_class_group) === null || _u === void 0 ? void 0 : _u._count) === null || _v === void 0 ? void 0 : _v.course_enrollment) !== null && _w !== void 0 ? _w : 0,
+                    instructorId: (_z = (_y = (_x = r.course_class_group) === null || _x === void 0 ? void 0 : _x.instructor) === null || _y === void 0 ? void 0 : _y.id) !== null && _z !== void 0 ? _z : null,
+                    instructorName: (_3 = (_2 = (_1 = (_0 = r.course_class_group) === null || _0 === void 0 ? void 0 : _0.instructor) === null || _1 === void 0 ? void 0 : _1.person) === null || _2 === void 0 ? void 0 : _2.name) !== null && _3 !== void 0 ? _3 : null,
+                    instructorAvatarId: (_7 = (_6 = (_5 = (_4 = r.course_class_group) === null || _4 === void 0 ? void 0 : _4.instructor) === null || _5 === void 0 ? void 0 : _5.person) === null || _6 === void 0 ? void 0 : _6.avatar_id) !== null && _7 !== void 0 ? _7 : null,
+                    courseTitle: (_10 = (_9 = (_8 = r.course_class_group) === null || _8 === void 0 ? void 0 : _8.course) === null || _9 === void 0 ? void 0 : _9.title) !== null && _10 !== void 0 ? _10 : null,
+                    courseSlug: (_13 = (_12 = (_11 = r.course_class_group) === null || _11 === void 0 ? void 0 : _11.course) === null || _12 === void 0 ? void 0 : _12.slug) !== null && _13 !== void 0 ? _13 : null,
+                    logoFileId: (_16 = (_15 = (_14 = courseLogo === null || courseLogo === void 0 ? void 0 : courseLogo.file) === null || _14 === void 0 ? void 0 : _14.id) !== null && _15 !== void 0 ? _15 : courseLogo === null || courseLogo === void 0 ? void 0 : courseLogo.file_id) !== null && _16 !== void 0 ? _16 : null,
+                };
             }),
         };
     }
@@ -490,6 +829,12 @@ let EnterpriseService = class EnterpriseService {
                 await this.prisma.enterprise_student.create({
                     data: { enterprise_id: enterpriseId, person_id, status: 'active' },
                 });
+                await this.recordLicenseEvent({
+                    enterpriseId,
+                    personId: person_id,
+                    eventType: 'assigned',
+                    nextStatus: 'active',
+                });
             }
         }
         return link;
@@ -531,6 +876,7 @@ let EnterpriseService = class EnterpriseService {
                         select: {
                             id: true,
                             name: true,
+                            avatar_id: true,
                             contact: {
                                 where: { contact_type: { code: 'EMAIL' }, is_primary: true },
                                 select: { value: true },
@@ -548,12 +894,13 @@ let EnterpriseService = class EnterpriseService {
             pageSize,
             lastPage: Math.max(1, Math.ceil(total / pageSize)),
             data: rows.map((r) => {
-                var _a, _b, _c, _d, _e, _f;
+                var _a, _b, _c, _d, _e, _f, _g, _h;
                 return ({
                     id: r.id,
                     personId: r.person_id,
                     name: (_b = (_a = r.person) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : null,
                     email: (_f = (_e = (_d = (_c = r.person) === null || _c === void 0 ? void 0 : _c.contact) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.value) !== null && _f !== void 0 ? _f : null,
+                    avatarId: (_h = (_g = r.person) === null || _g === void 0 ? void 0 : _g.avatar_id) !== null && _h !== void 0 ? _h : null,
                     status: r.status,
                     createdAt: r.created_at,
                 });
@@ -561,6 +908,7 @@ let EnterpriseService = class EnterpriseService {
         };
     }
     async addStudent(enterpriseId, dto) {
+        var _a;
         await this.assertEnterpriseExists(enterpriseId);
         const person = await this.prisma.person.findUnique({
             where: { id: dto.person_id },
@@ -574,34 +922,58 @@ let EnterpriseService = class EnterpriseService {
         });
         if (duplicate)
             throw new common_1.ConflictException(`Person #${dto.person_id} is already a student of enterprise #${enterpriseId}`);
-        return this.prisma.enterprise_student.create({
+        const created = await this.prisma.enterprise_student.create({
             data: Object.assign({ enterprise_id: enterpriseId }, dto),
         });
+        await this.recordLicenseEvent({
+            enterpriseId,
+            personId: dto.person_id,
+            eventType: 'assigned',
+            nextStatus: (_a = dto.status) !== null && _a !== void 0 ? _a : 'pending',
+        });
+        return created;
     }
     async updateStudent(enterpriseId, personId, dto) {
         await this.assertEnterpriseExists(enterpriseId);
         const existing = await this.prisma.enterprise_student.findFirst({
             where: { enterprise_id: enterpriseId, person_id: personId },
-            select: { id: true },
+            select: { id: true, status: true },
         });
         if (!existing)
             throw new common_1.NotFoundException(`Person #${personId} is not a student of enterprise #${enterpriseId}`);
-        return this.prisma.enterprise_student.update({
+        const updated = await this.prisma.enterprise_student.update({
             where: { id: existing.id },
             data: dto,
         });
+        if (dto.status && dto.status !== existing.status) {
+            await this.recordLicenseEvent({
+                enterpriseId,
+                personId,
+                eventType: 'status_changed',
+                previousStatus: existing.status,
+                nextStatus: dto.status,
+            });
+        }
+        return updated;
     }
     async removeStudent(enterpriseId, personId) {
         await this.assertEnterpriseExists(enterpriseId);
         const existing = await this.prisma.enterprise_student.findFirst({
             where: { enterprise_id: enterpriseId, person_id: personId },
-            select: { id: true },
+            select: { id: true, status: true },
         });
         if (!existing)
             throw new common_1.NotFoundException(`Person #${personId} is not a student of enterprise #${enterpriseId}`);
-        return this.prisma.enterprise_student.delete({
+        const deleted = await this.prisma.enterprise_student.delete({
             where: { id: existing.id },
         });
+        await this.recordLicenseEvent({
+            enterpriseId,
+            personId,
+            eventType: 'revoked',
+            previousStatus: existing.status,
+        });
+        return deleted;
     }
     // ─── Stats / options ──────────────────────────────────────────────────────────
     async getStats() {
@@ -795,7 +1167,7 @@ let EnterpriseService = class EnterpriseService {
         return profiles;
     }
     mapEnterprise(e, extra) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
         const { _count, person } = e;
         const pc = (_a = extra === null || extra === void 0 ? void 0 : extra.personCompany) !== null && _a !== void 0 ? _a : null;
         return {
@@ -814,18 +1186,19 @@ let EnterpriseService = class EnterpriseService {
                 ? {
                     id: person.id,
                     name: person.name,
-                    tradeName: (_f = pc === null || pc === void 0 ? void 0 : pc.trade_name) !== null && _f !== void 0 ? _f : null,
-                    industry: (_g = pc === null || pc === void 0 ? void 0 : pc.industry) !== null && _g !== void 0 ? _g : null,
-                    website: (_h = pc === null || pc === void 0 ? void 0 : pc.website) !== null && _h !== void 0 ? _h : null,
-                    lifecycleStage: (_j = pc === null || pc === void 0 ? void 0 : pc.account_lifecycle_stage) !== null && _j !== void 0 ? _j : null,
+                    avatarId: (_f = person.avatar_id) !== null && _f !== void 0 ? _f : null,
+                    tradeName: (_g = pc === null || pc === void 0 ? void 0 : pc.trade_name) !== null && _g !== void 0 ? _g : null,
+                    industry: (_h = pc === null || pc === void 0 ? void 0 : pc.industry) !== null && _h !== void 0 ? _h : null,
+                    website: (_j = pc === null || pc === void 0 ? void 0 : pc.website) !== null && _j !== void 0 ? _j : null,
+                    lifecycleStage: (_k = pc === null || pc === void 0 ? void 0 : pc.account_lifecycle_stage) !== null && _k !== void 0 ? _k : null,
                 }
                 : null,
-            usersCount: (_k = _count === null || _count === void 0 ? void 0 : _count.enterprise_user) !== null && _k !== void 0 ? _k : 0,
-            studentsCount: (_l = extra === null || extra === void 0 ? void 0 : extra.studentsCount) !== null && _l !== void 0 ? _l : 0,
-            managersCount: (_m = extra === null || extra === void 0 ? void 0 : extra.managersCount) !== null && _m !== void 0 ? _m : 0,
-            adminsCount: (_o = extra === null || extra === void 0 ? void 0 : extra.adminsCount) !== null && _o !== void 0 ? _o : 0,
-            coursesCount: (_p = _count === null || _count === void 0 ? void 0 : _count.enterprise_course) !== null && _p !== void 0 ? _p : 0,
-            classesCount: (_q = _count === null || _count === void 0 ? void 0 : _count.enterprise_class_group) !== null && _q !== void 0 ? _q : 0,
+            usersCount: (_l = _count === null || _count === void 0 ? void 0 : _count.enterprise_user) !== null && _l !== void 0 ? _l : 0,
+            studentsCount: (_m = extra === null || extra === void 0 ? void 0 : extra.studentsCount) !== null && _m !== void 0 ? _m : 0,
+            managersCount: (_o = extra === null || extra === void 0 ? void 0 : extra.managersCount) !== null && _o !== void 0 ? _o : 0,
+            adminsCount: (_p = extra === null || extra === void 0 ? void 0 : extra.adminsCount) !== null && _p !== void 0 ? _p : 0,
+            coursesCount: (_q = _count === null || _count === void 0 ? void 0 : _count.enterprise_course) !== null && _q !== void 0 ? _q : 0,
+            classesCount: (_r = _count === null || _count === void 0 ? void 0 : _count.enterprise_class_group) !== null && _r !== void 0 ? _r : 0,
         };
     }
 };