Files
Condopay/types.ts
2025-12-11 21:13:01 +01:00

234 lines
5.2 KiB
TypeScript

export interface Condo {
id: string;
name: string;
address?: string;
streetNumber?: string; // Civico
city?: string; // Città
province?: string; // Provincia
zipCode?: string; // CAP
notes?: string; // Note
iban?: string;
paypalClientId?: string; // PayPal Client ID for receiving payments
defaultMonthlyQuota: number;
image?: string; // Optional placeholder for logo
}
export interface Family {
id: string;
condoId: string; // Link to specific condo
name: string;
unitNumber: string; // Internal apartment number (Interno)
stair?: string; // Scala
floor?: string; // Piano
notes?: string; // Note
contactEmail?: string;
balance: number; // Calculated balance (positive = credit, negative = debt)
customMonthlyQuota?: number; // Optional override for default quota
}
export interface Payment {
id: string;
familyId: string;
amount: number;
datePaid: string; // ISO Date string
forMonth: number; // 1-12
forYear: number;
notes?: string;
}
export interface SmtpConfig {
host: string;
port: number;
user: string;
pass: string;
secure: boolean;
fromEmail: string;
}
export interface AppFeatures {
multiCondo: boolean;
tickets: boolean;
payPal: boolean;
notices: boolean;
reports: boolean;
extraordinaryExpenses: boolean;
condoFinancialsView: boolean; // Toggle for User read-only access to Condo Expenses
}
export interface AlertDefinition {
id: string;
subject: string;
body: string;
daysOffset: number; // Number of days
offsetType: 'before_next_month' | 'after_current_month';
sendHour: number; // 0-23
active: boolean;
lastSent?: string; // ISO Date of last execution
}
export type NoticeIconType = 'info' | 'warning' | 'maintenance' | 'event';
export interface Notice {
id: string;
condoId: string;
title: string;
content: string;
type: NoticeIconType;
link?: string;
date: string; // ISO Date
active: boolean;
targetFamilyIds?: string[]; // Array of family IDs. If empty/null, it means "ALL"
}
export interface NoticeRead {
userId: string;
noticeId: string;
readAt: string;
}
export interface AppSettings {
// Global settings only
currentYear: number; // The active fiscal year (could be per-condo, but global for simplicity now)
smtpConfig?: SmtpConfig;
features: AppFeatures;
}
export enum PaymentStatus {
PAID = 'PAID',
UNPAID = 'UNPAID', // Past due
UPCOMING = 'UPCOMING', // Future
PENDING = 'PENDING'
}
export interface MonthStatus {
monthIndex: number; // 0-11
status: PaymentStatus;
payment?: Payment;
}
export interface User {
id: string;
email: string;
name?: string;
role?: 'admin' | 'poweruser' | 'user';
phone?: string;
familyId?: string | null;
receiveAlerts?: boolean;
}
export interface AuthResponse {
token: string;
user: User;
}
// --- TICKETS ---
export enum TicketStatus {
OPEN = 'OPEN',
IN_PROGRESS = 'IN_PROGRESS',
SUSPENDED = 'SUSPENDED', // New State
RESOLVED = 'RESOLVED',
CLOSED = 'CLOSED' // Closed without resolution (Archived/WontFix)
}
export enum TicketPriority {
LOW = 'LOW',
MEDIUM = 'MEDIUM',
HIGH = 'HIGH',
URGENT = 'URGENT'
}
export enum TicketCategory {
MAINTENANCE = 'MAINTENANCE', // Manutenzione
ADMINISTRATIVE = 'ADMINISTRATIVE', // Amministrativa
NOISE = 'NOISE', // Disturbo/Rumori
CLEANING = 'CLEANING', // Pulizie
OTHER = 'OTHER' // Altro
}
export interface TicketAttachment {
id: string;
ticketId: string;
fileName: string;
fileType: string; // MIME type
data: string; // Base64 Data URI
}
export interface TicketComment {
id: string;
ticketId: string;
userId: string;
userName: string;
text: string;
createdAt: string;
isAdminResponse: boolean;
}
export interface Ticket {
id: string;
condoId: string;
userId: string;
title: string;
description: string;
status: TicketStatus;
priority: TicketPriority;
category: TicketCategory;
createdAt: string;
updatedAt: string;
attachments?: TicketAttachment[];
comments?: TicketComment[];
userName?: string; // Joined field
userEmail?: string; // Joined field
}
// --- EXTRAORDINARY EXPENSES ---
export interface ExpenseItem {
id?: string;
description: string;
amount: number;
}
export interface ExpenseShare {
id?: string;
familyId: string;
percentage: number;
amountDue: number;
amountPaid: number;
status: 'PAID' | 'PARTIAL' | 'UNPAID';
familyName?: string; // Joined
}
export interface ExtraordinaryExpense {
id: string;
condoId: string;
title: string;
description: string;
startDate: string;
endDate?: string;
contractorName: string;
totalAmount: number;
items: ExpenseItem[];
shares?: ExpenseShare[]; // For detail view
attachments?: { id: string, fileName: string, fileType: string, data: string }[];
createdAt: string;
}
// --- CONDO ORDINARY EXPENSES (USCITE) ---
export interface CondoExpense {
id: string;
condoId: string;
description: string;
supplierName: string;
amount: number;
paymentDate: string | null; // Null if not paid yet
status: 'PAID' | 'UNPAID' | 'SUSPENDED';
paymentMethod?: string;
invoiceNumber?: string;
notes?: string;
createdAt: string;
attachments?: { id: string, fileName: string, fileType: string, data: string }[];
}