💼 ClientKeep

🔥 The Problem

• ❌Freelancers manage clients across Excel sheets, WhatsApp, and sticky notes
• ❌No way to track which invoices are paid, pending, or overdue
• ❌Follow-up reminders get lost — payments slip through the cracks
• ❌No revenue visibility — no monthly income tracking or history
• ❌No professional way to share an invoice with a client

✅ The Solution

ClientKeep provides a single clean workspace where freelancers manage their entire business:

One URL. No spreadsheets. No chaos.

✨ Key Features

• 👤Secure auth — register, login, logout with hashed passwords (Werkzeug)
• 🧑‍💼Client CRUD — add, edit, delete clients with contact details and notes
• 🧾Invoice system — create invoices with auto-generated numbers, due dates, and status tracking
• 💰Payment tracking — mark invoices as paid / pending / overdue with one click
• 📄PDF invoice download — beautiful branded PDF via WeasyPrint, one click
• 🔗Client portal — shareable public link where clients view and confirm payment
• 🔔Reminders — create follow-up reminders per client with due dates and overdue detection
• 📊Revenue dashboard — 6-month bar chart, stats cards, and monthly income tracking
• 📋Activity log — every action logged with timestamp (created, updated, paid, etc.)
• 📥CSV export — export all clients and invoices to CSV for backup or analysis
• 🔁Recurring invoices — flag an invoice as monthly or quarterly
• 💱Currency selector — USD, EUR, DZD, GBP, and 6 more currencies
• 🌙Dark / Light mode — persisted in localStorage, smooth transitions
• 🌐Language switcher — English, French, Arabic (with RTL layout)

🛠️ Tech Stack

• 🐍Python 3 + Flask — backend framework and routing
• 🗃️PostgreSQL (Neon) — production cloud database
• ⚙️SQLAlchemy + Flask-Migrate — ORM and schema migrations
• 🔐Flask-Login + Werkzeug — auth and password hashing
• 📄WeasyPrint — server-side PDF generation from HTML templates
• 📊Chart.js — 6-month revenue bar chart on dashboard
• 🎨Custom CSS with CSS variables — dark/light theme system, DM Serif Display + DM Sans fonts
• 🚀Render — free-tier hosting with auto-deploy from GitHub

🔁 User Flow

🗄️ Database Design

• 👤User — id, name, email, password_hash, currency, created_at
• 🧑‍💼Client — id, user_id, name, email, phone, company, notes, created_at
• 🧾Invoice — id, user_id, client_id, invoice_number, service, amount, status, due_date, notes, is_recurring, recur_interval, portal_token, created_at
• 💰Payment — id, invoice_id, amount, paid_at, notes
• 🔔Reminder — id, user_id, client_id, title, description, due_date, is_done, created_at
• 📋ActivityLog — id, user_id, action, entity, entity_id, icon, created_at