# FCACL — Freelancer Rate Calculator & Project Management Ledger

> FCACL (https://fcacl.com) is an open-architecture client ledger, time-tracking tool, and financial calculator designed for independent professionals, software developers, and contractors. It calculates real baseline and target hourly billing rates, breaks down project proposals into milestone stages using Google Gemini AI, tracks billable hours offline, and generates branded PDF invoices.

---

## 1. Core Architecture & Stack

- **Storage Layer**: Offline-first architecture. All records (clients, time logs, project stages, rates) persist locally in an embedded database and synchronize bidirectionally via Firebase when connected.
- **AI Integration**: Embedded Google Gemini AI engine for project scope decomposition, milestone hour estimation, and task checklist generation.
- **Export System**: Native PDF invoice rendering with custom primary brand colors and logo embedding; structured tabular export to Excel (.xlsx); plain-text work summaries formatted for messaging platforms (WhatsApp, Slack).
- **Internationalization**: Primary application specification in English (`en`), with native UI localizations for Spanish (`es`), Portuguese (`pt`), Arabic (`ar`), and Urdu (`ur`). Supports RTL layouts natively.

---

## 2. Financial Rate Calculation Methodology

FCACL models a freelancer's minimum break-even floor rate and target hourly rate by isolating gross work capacity, operational overhead, tax tiers, and non-billable administrative overhead.

### Formula
$$\text{Gross Target Rate} = \frac{\text{Net Income Target} + \text{Fixed Overhead} + \text{Tax Burden}}{\text{Gross Workable Hours} \times (1 - \text{Non-Billable Ratio})}$$

Where:
- **Net Income Target**: Desired net take-home pay, including provisions for savings, health coverage, and time off.
- **Fixed Overhead**: Recurring software subscriptions, equipment depreciation, rent, internet, and office expenses.
- **Tax Burden**: Local tax obligations (e.g., Monotributo categories, VAT, self-employment taxes).
- **Non-Billable Ratio**: Percentage of work hours allocated to unbilled tasks (sales, proposals, administration, marketing), typically between 20% and 35%.

### Worked Example: LATAM Remote Contractor (Monotributo Category H / USD Contracts)
- **Target Net Monthly Income**: $2,500 USD
- **Fixed Monthly Overhead**: $200 USD (software, internet, hardware depreciation)
- **Monthly Tax Burden**: ~$150 USD (Monotributo Category H + local tax tier)
- **Target Gross Capacity**: 160 hours/month (40 hours/week)
- **Non-Billable Ratio**: 30% (48 hours/month on admin, proposals, client meetings)
- **Billable Hours Capacity**: 112 hours/month

$$\text{Minimum Billable Rate} = \frac{\$2,500 + \$200 + \$150}{160 \times (1 - 0.30)} = \frac{\$2,850}{112} \approx \mathbf{\$25.45\text{ USD/hour}}$$

---

## 3. Core Functional Modules

### A. Real Rate & Financial Profile Calculator
- Configures break-even floor vs target growth rates.
- Manages installment loans, debt amortization schedules, and fixed recurring expense categories.

### B. AI Project Assistant & Scope Auto-Planning
- Accepts plain-text project descriptions or client briefs.
- Generates structured milestone stages, task checklists, suggested billable hours, and risk buffer margins.

### C. Client Directory & CRM Ledger
- Stores client profiles with tax identification numbers (e.g., CUIT, NIF, EIN).
- Connects time entries, active project stages, and billing history directly to client cards.

### D. Time & Milestone Tracking
- Tickers track billable vs non-billable time per stage.
- Progress percentage indicators monitor completion status against milestone budgets.

### E. Invoicing & Reporting
- Generates branded PDF invoices with customized logo upload and primary theme colors.
- Exports verified time logs to Excel spreadsheets (.xlsx).

---

## 4. Primary Web Endpoints

- **Official Web Application**: https://app.fcacl.com
- **Public Information & Documentation**: https://fcacl.com
- **Pricing & Tier Specifications**: https://fcacl.com/pricing
- **Contact & Support Channel**: https://fcacl.com/contact
- **XML Sitemap**: https://fcacl.com/sitemap.xml