# -*- coding: utf-8 -*- # Copyright 2026 Nexa Systems Inc. # License OPL-1 (Odoo Proprietary License v1.0) import base64 import logging from datetime import timedelta from odoo import models, fields, api, _ from odoo.exceptions import UserError _logger = logging.getLogger(__name__) class FusionClockReport(models.Model): _name = 'fusion.clock.report' _description = 'Clock Period Report' _order = 'date_end desc, employee_id' _rec_name = 'name' name = fields.Char( string='Report Name', compute='_compute_name', store=True, ) date_start = fields.Date(string='Period Start', required=True, index=True) date_end = fields.Date(string='Period End', required=True, index=True) schedule_type = fields.Selection( [ ('weekly', 'Weekly'), ('biweekly', 'Bi-Weekly'), ('semi_monthly', 'Semi-Monthly'), ('monthly', 'Monthly'), ], string='Schedule Type', ) state = fields.Selection( [ ('draft', 'Draft'), ('generated', 'Generated'), ('sent', 'Sent'), ], string='Status', default='draft', index=True, ) employee_id = fields.Many2one( 'hr.employee', string='Employee', index=True, help="Empty = batch report for all employees.", ) is_batch = fields.Boolean( string='Batch Report', compute='_compute_is_batch', store=True, ) company_id = fields.Many2one( 'res.company', string='Company', default=lambda self: self.env.company, required=True, ) # Computed totals total_hours = fields.Float(string='Total Worked Hours', compute='_compute_totals', store=True) net_hours = fields.Float(string='Net Hours', compute='_compute_totals', store=True) total_breaks = fields.Float(string='Total Breaks (min)', compute='_compute_totals', store=True) total_penalties = fields.Integer(string='Penalty Count', compute='_compute_totals', store=True) days_worked = fields.Integer(string='Days Worked', compute='_compute_totals', store=True) attendance_ids = fields.Many2many( 'hr.attendance', 'fusion_clock_report_attendance_rel', 'report_id', 'attendance_id', string='Attendance Records', ) # PDF report_pdf = fields.Binary(string='Report PDF', attachment=True) report_pdf_filename = fields.Char(string='PDF Filename') @api.depends('employee_id', 'date_start', 'date_end') def _compute_name(self): for rec in self: if rec.employee_id: rec.name = f"{rec.employee_id.name} - {rec.date_start} to {rec.date_end}" else: rec.name = f"Batch Report - {rec.date_start} to {rec.date_end}" @api.depends('employee_id') def _compute_is_batch(self): for rec in self: rec.is_batch = not bool(rec.employee_id) @api.depends('attendance_ids', 'attendance_ids.worked_hours', 'attendance_ids.x_fclk_net_hours', 'attendance_ids.x_fclk_break_minutes') def _compute_totals(self): for rec in self: atts = rec.attendance_ids rec.total_hours = sum(a.worked_hours or 0.0 for a in atts) rec.net_hours = sum(a.x_fclk_net_hours or 0.0 for a in atts) rec.total_breaks = sum(a.x_fclk_break_minutes or 0.0 for a in atts) rec.total_penalties = self.env['fusion.clock.penalty'].search_count([ ('employee_id', '=', rec.employee_id.id), ('date', '>=', rec.date_start), ('date', '<=', rec.date_end), ]) if rec.employee_id else 0 # Count unique dates dates = set() for a in atts: if a.check_in: dates.add(a.check_in.date()) rec.days_worked = len(dates) def action_generate_report(self): """Generate the PDF report for this record.""" self.ensure_one() self._collect_attendance_records() self._generate_pdf() self.state = 'generated' def action_send_report(self): """Send the report via email.""" self.ensure_one() if self.state != 'generated': raise UserError(_("Please generate the report first.")) self._send_report_email() self.state = 'sent' def _collect_attendance_records(self): """Link attendance records for the period and employee.""" self.ensure_one() domain = [ ('check_in', '>=', fields.Datetime.to_datetime(self.date_start)), ('check_in', '<', fields.Datetime.to_datetime(self.date_end + timedelta(days=1))), ('check_out', '!=', False), ] if self.employee_id: domain.append(('employee_id', '=', self.employee_id.id)) else: domain.append(('employee_id.company_id', '=', self.company_id.id)) attendances = self.env['hr.attendance'].search(domain) self.attendance_ids = [(6, 0, attendances.ids)] def _generate_pdf(self): """Render the QWeb report to PDF and store it.""" self.ensure_one() if self.employee_id: report_ref = 'fusion_clock.action_report_clock_employee' else: report_ref = 'fusion_clock.action_report_clock_batch' report = self.env['ir.actions.report']._get_report_from_name(report_ref) if not report: # Fallback to employee report report_ref = 'fusion_clock.action_report_clock_employee' pdf_content, _ = self.env['ir.actions.report']._render_qweb_pdf( report_ref, [self.id] ) filename = f"clock_report_{self.date_start}_{self.date_end}" if self.employee_id: filename += f"_{self.employee_id.name.replace(' ', '_')}" filename += ".pdf" self.write({ 'report_pdf': base64.b64encode(pdf_content), 'report_pdf_filename': filename, }) def _send_report_email(self): """Send the report via mail template.""" self.ensure_one() if self.employee_id: template = self.env.ref('fusion_clock.mail_template_clock_employee_report', raise_if_not_found=False) else: template = self.env.ref('fusion_clock.mail_template_clock_batch_report', raise_if_not_found=False) if template: template.send_mail(self.id, force_send=True) else: _logger.warning("Fusion Clock: Mail template not found for report %s", self.id) @api.model def _cron_generate_period_reports(self): """Cron: Generate reports when a pay period ends.""" ICP = self.env['ir.config_parameter'].sudo() auto_generate = ICP.get_param('fusion_clock.auto_generate_reports', 'True') if auto_generate != 'True': return schedule_type = ICP.get_param('fusion_clock.pay_period_type', 'biweekly') period_start_str = ICP.get_param('fusion_clock.pay_period_start', '') today = fields.Date.today() period_start, period_end = self._calculate_current_period(schedule_type, period_start_str, today) # Only generate if yesterday was the end of a period if period_end != today - timedelta(days=1): return _logger.info("Fusion Clock: Generating reports for period %s to %s", period_start, period_end) companies = self.env['res.company'].search([]) for company in companies: employees = self.env['hr.employee'].search([ ('company_id', '=', company.id), ('x_fclk_enable_clock', '=', True), ]) # Generate individual reports for employee in employees: existing = self.search([ ('employee_id', '=', employee.id), ('date_start', '=', period_start), ('date_end', '=', period_end), ], limit=1) if not existing: report = self.create({ 'date_start': period_start, 'date_end': period_end, 'schedule_type': schedule_type, 'employee_id': employee.id, 'company_id': company.id, }) try: report.action_generate_report() # Auto-send if configured send_employee = ICP.get_param('fusion_clock.send_employee_reports', 'True') if send_employee == 'True': report.action_send_report() except Exception as e: _logger.error("Fusion Clock: Error generating report for %s: %s", employee.name, e) # Generate batch report existing_batch = self.search([ ('employee_id', '=', False), ('date_start', '=', period_start), ('date_end', '=', period_end), ('company_id', '=', company.id), ], limit=1) if not existing_batch: batch = self.create({ 'date_start': period_start, 'date_end': period_end, 'schedule_type': schedule_type, 'employee_id': False, 'company_id': company.id, }) try: batch.action_generate_report() batch.action_send_report() except Exception as e: _logger.error("Fusion Clock: Error generating batch report: %s", e) @api.model def _calculate_current_period(self, schedule_type, period_start_str, reference_date): """Calculate the period start/end dates based on schedule type.""" from dateutil.relativedelta import relativedelta import datetime if period_start_str: try: anchor = fields.Date.from_string(period_start_str) except Exception: anchor = reference_date.replace(day=1) else: anchor = reference_date.replace(day=1) if schedule_type == 'weekly': days_diff = (reference_date - anchor).days period_num = days_diff // 7 period_start = anchor + timedelta(days=period_num * 7) period_end = period_start + timedelta(days=6) elif schedule_type == 'biweekly': days_diff = (reference_date - anchor).days period_num = days_diff // 14 period_start = anchor + timedelta(days=period_num * 14) period_end = period_start + timedelta(days=13) elif schedule_type == 'semi_monthly': if reference_date.day <= 15: period_start = reference_date.replace(day=1) period_end = reference_date.replace(day=15) else: period_start = reference_date.replace(day=16) # Last day of month next_month = reference_date.replace(day=28) + timedelta(days=4) period_end = next_month - timedelta(days=next_month.day) elif schedule_type == 'monthly': period_start = reference_date.replace(day=1) next_month = reference_date.replace(day=28) + timedelta(days=4) period_end = next_month - timedelta(days=next_month.day) else: # Default biweekly days_diff = (reference_date - anchor).days period_num = days_diff // 14 period_start = anchor + timedelta(days=period_num * 14) period_end = period_start + timedelta(days=13) return period_start, period_end