About this software
About Iyada: Clinic Booking and Patient Management
Iyada is a Django 6.1 / DRF API with Celery, PostgreSQL 16 and Redis 7, paired with a React 19 + TypeScript web app that installs as a PWA. It covers the clinic day from public online booking through calendar, patient files, signed visit notes, prescriptions, dental charting, invoicing, insurance claims and a live waiting-room queue. The UI is bilingual (English and Arabic, with direction-neutral layout), supports several branches in one install, and ships with Docker Compose files, SQL schema and seed, a user manual and acceptance criteria that each map to a test. Stripe deposits and email/SMS/WhatsApp reminders are optional. It has no DHA, DOH, Riayati or NABIDH connections, no drug-interaction database and no lab integration, and it makes no compliance claim.
Why Iyada: Clinic Booking and Patient Management
What makes it better
than the alternatives
- 01
Clash-proof booking
PostgreSQL constraints stop a second booking for the same doctor, room or patient, even when two people book at once.
- 02
Dental chart to invoice
An FDI tooth chart with treatment plans that turn into bookings and an invoice.
- 03
Insurance co-pay and approvals
One invoice splits patient and insurer shares, with claims and pre-approval boards that warn before approvals expire.
- 04
Live queue and TV display
Queue tokens at check-in, a call-next action for the doctor and a waiting-room display page.
- 05
Guarded and audited
Every endpoint maps to a permission code enforced by an access-matrix test, with an append-only audit log, two-factor sign-in and encrypted ID numbers.
Online booking and portal
- Public booking page with slot holds and confirmation
- Manage
- cancel
- reschedule links and .ics download
- Patient portal login and verification
- Waitlist with offers patients can accept or decline
- Embeddable booking button (embed.js)
Calendar and scheduling
- Day calendar and appointments list
- Doctor weekly shifts
- time off and exceptions
- Services with per-doctor length and price
- Branches
- holidays
- resources and departments
Patient files
- Patient records with tags
- custom fields and attachments in private storage
- Duplicate detection and merge
- Family tab
- history and view log
- CSV patient import and full data export
Clinical
- Visit notes from templates
- draft to signed
- addenda only
- Vitals
- ICD-10 diagnoses and prescriptions with favourites
- Bilingual printing
- Recall reminders
Dental
- FDI odontogram
- Treatment plans and plan editor
- Book plan items and invoice them
Billing
- Invoices with VAT
- payments
- deposits
- refunds and void
- Daily cash-up and thermal receipts
- Optional Stripe Checkout and webhook
Insurance
- Payers
- policies and price lists
- Pre-approval board and claims board
- Booking warnings for an expired policy or a missing approval
Queue, forms and messaging
- Today board
- walk-ins and My Day view
- Consent forms signed on a tablet with signature pad
- SMS and WhatsApp templates with notification rules and message log
Admin, reports and integrations
- Catalogue of reports with CSV export and dashboard charts
- Custom roles with permission codes and audit log
- API keys with scopes
- webhooks and an OpenAPI endpoint
- Two-factor sign-in with recovery codes
| Language | Version | Framework | Used for | Share of code |
|---|---|---|---|---|
| Python | — | — | Web, API | 41.7% |
| TypeScript (React) | — | — | Front-end | 33.5% |
| SQL | — | — | Database | 16.1% |
| TypeScript | — | — | Front-end | 5.9% |
| CSS | — | — | Styling | 2% |
| HTML | — | — | Front-end | 0.5% |
| JavaScript | — | — | Front-end | 0.1% |
| Shell | — | — | Scripts | 0.1% |
- Primary language
- Python 3.12 + TypeScript 6 (React 19 web app)
- Framework
- Django 6.1 + Django REST Framework 3.18, React 19 + Vite 8 + Tailwind 4
- Database
- PostgreSQL 16 (with Redis 7 for cache and background jobs)
- Authentication
- JWT access token with httpOnly refresh cookie, two-factor sign-in with authenticator app and recovery codes, API keys for other systems
- Licence
- Single-site
- Screens
- 60
- Database tables
- 117
- Supported languages
- English and Arabic, full right-to-left layout
- Browser support
- Modern evergreen browsers (Chrome, Edge, Firefox, Safari); installable as a PWA
| Minimum | Recommended | |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU |
| RAM | 4 GB RAM | 8 GB RAM |
| OS | Linux server or any Docker host; Python 3.12, Node 24 (build only), PostgreSQL 16, Redis 7 | Linux server or any Docker host; Python 3.12, Node 24 (build only), PostgreSQL 16, Redis 7 |
| Est. monthly hosting | $25 | $25 |
```bash cd iyada-backend && python3 manage.py init_env && cd .. docker compose --env-file iyada-backend/.env up -d --build docker compose --env-file iyada-backend/.env exec web python manage.py initial_setup ```
Follow [docs/deploy-vps.md](docs/deploy-vps.md). Create the settings file first with `python3 manage.py init_env` in `iyada-backend/`, then set up PostgreSQL 16 and Redis 7 as described there.
Quality report
Manually reviewedHow to read the quality report
What this is. Every project on Vibe96 goes through an automated audit of its source code before a reviewer in Dubai checks it by hand. The score is out of 100; 75 is the minimum to be listed, and any single failing check blocks a listing regardless of the score.
- Security
- No real credentials in the code, every data-changing route protected, admin areas role-gated, no SQL built from user input.
- Code structure
- A developer can navigate and extend it: clear module boundaries, no giant files, little copy-paste.
- Docs & completeness
- The setup guide, example config, schema and required files the builder committed to are actually in the archive.
- Dependency health
- Packages pinned, no known critical vulnerabilities, no abandoned libraries in production paths.
- Build & deploy
- A clean machine can restore, build and start it by following the shipped instructions.
Warnings are problems that didn't block the listing; they stay visible here until a later version clears them. The audit reads the code — it does not run it — so always try the live demo before you buy. Lines of code are counted from the same audited archive.
Reviewer notes (4 minor)
Backend db code was largely not visible; the conventions are strong, but the schema and queries could not be verified; largely reproducible build; setup doc and a few inconsistencies could not be fully verified; authz design looks solid but most views were not visible; a few unverifiable public and token endpoints. None of these stop the software from working; the developer has been told and improvements come in a future update.
Versions & updates
No updates yet. New versions appear here with a changelog.
Buyers receive updates free for 1 year.
What you get
- </>Full source codeThe complete audited source, delivered as a download from your account. No obfuscation.
- ▤DocumentationSetup guide, architecture notes, CLAUDE.md and AGENTS.md.
- ↻One year of updatesEvery new version the builder publishes, free for 12 months.
- ♧30 days of supportInstallation and defect support through Vibe96 tickets.