{"id":42201427,"url":"https://github.com/batdimoiprint/medicare-supersystem-frontend","last_synced_at":"2026-01-27T00:26:07.489Z","repository":{"id":323388599,"uuid":"1093050598","full_name":"batdimoiprint/medicare-supersystem-frontend","owner":"batdimoiprint","description":"Dental Clinic Management Supersystem","archived":false,"fork":false,"pushed_at":"2025-12-04T03:12:57.000Z","size":4679,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-17T14:49:37.710Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://medicare-supersystem.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/batdimoiprint.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-09T20:07:31.000Z","updated_at":"2025-12-08T13:46:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/batdimoiprint/medicare-supersystem-frontend","commit_stats":null,"previous_names":["batdimoiprint/medicare-supersystem-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/batdimoiprint/medicare-supersystem-frontend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batdimoiprint%2Fmedicare-supersystem-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batdimoiprint%2Fmedicare-supersystem-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batdimoiprint%2Fmedicare-supersystem-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batdimoiprint%2Fmedicare-supersystem-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/batdimoiprint","download_url":"https://codeload.github.com/batdimoiprint/medicare-supersystem-frontend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/batdimoiprint%2Fmedicare-supersystem-frontend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28792979,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-27T00:26:07.344Z","updated_at":"2026-01-27T00:26:07.474Z","avatar_url":"https://github.com/batdimoiprint.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Medicare: Dental Clinic Management SuperSystem - Frontend\n\nA modern, role-based React application for managing dental clinic operations including patient appointments, billing, inventory, and treatment records.\n\n![My dog](public/readme.webp \"Medicare\")\n\n## Tech Stack\n\n- **React 19** with TypeScript\n- **Vite** for build tooling\n- **React Router v7** for routing and navigation\n- **TanStack React Query** for server state management\n- **React Hook Forms** for forms handling\n- **Tailwind CSS 4** for styling\n- **shadcn/ui** for component library\n- **Supabase** for authentication and real-time data\n- **PayMongo** for payment processing\n\n## Backend Integration\n\nThis frontend connects to multiple backend services with clear domain separation:\n\n| Technology | Responsibility |\n|------------|---------------|\n| **Django** | Patient appointments, scheduling, reservation fee payments |\n| **Flask** | Patient records, EMR, treatment histories |\n| **Supabase** | Inventory management, dentist system, |\n\n## Prerequisites\n\n- **Node.js**: v24.11 or higher\n- **pnpm**: Package manager\n- Access to Supabase project credentials\n- PayMongo public API key (for payment integration)\n\n## Getting Started\n\n### 1. Clone the repository\n\n```bash\ngit clone \u003crepository-url\u003e\n```\n\n### 2. Install dependencies\n\n```bash\npnpm install\n```\n\n### 3. Environment Setup\n\nCreate a `.env` file in the root directory:\n\n```env\n# Supabase Configuration\nVITE_ENV_SUPABASE_URL=your_supabase_project_url\nVITE_ENV_SUPABASE_ANON_KEY=your_supabase_anon_key\n\n# PayMongo Configuration\nVITE_ENV_PAYMONGO_PUBLIC_KEY=your_paymongo_public_key\n\n# Backend Services\nVITE_ENV_BACKEND_DJANGO_URL=http://localhost:8000\nVITE_ENV_BACKEND_FLASK_URL=http://localhost:5000\n\n### 4. Run development server\n\n```bash\npnpm run dev\n```\n\n## Project Structure\n\n```\nsrc/\n├── components/         # Reusable UI components\n│   ├── ui/             # shadcn/ui components (Radix UI primitives)\n│   └── shared/         # Shared business components\n├── pages/              # Route-based page components\n|   |── public/         # Public Views pages\n│   ├── patient/        # Patient dashboard pages\n│   ├── admin/          # Admin dashboard pages\n│   ├── front-desk/     # Front desk subsystem pages\n│   ├── inventory/      # Inventory subsystem pages (Supabase)\n│   ├── dentist/        # Dentist subsystem pages (Supabase)\n│   └── auth/           # Authentication pages\n├── hooks/              # Custom React hooks\n├── lib/                # Utility functions and configurations\n│   ├── api/           # API client setup (Django, Flask)\n│   ├── supabase.ts    # Supabase client\n│   └── utils.ts       # Helper functions (cn, etc.)\n├── types/              # TypeScript type definitions\n└── routes/             # Route configuration\n```\n\n## Routing Structure\n\nThe application uses **React Router v7** with protected routes and nested layouts using `\u003cOutlet /\u003e`:\n\n```\n/                          # Public landing page\n├── /login                 # Authentication\n├── /register              # Patient registration\n│\n├── /patient/*             # Patient Dashboard (Protected)\n│   ├── /\n│\n├── /admin/*               # Admin Dashboard (Protected)\n│   ├── /\n│\n├── /front-desk/*          # Front Desk Subsystem (Protected)\n│   ├── /\n│\n├── /inventory/*           # Inventory Subsystem (Protected)\n│   ├── /\n│\n└── /dentist/*             # Dentist Subsystem (Protected)\n    ├── /\n```\n\nEach protected route validates user roles and redirects unauthorized access.\n\n### Real-time Updates\n\nSupabase subscriptions are integrated with React Query for automatic cache invalidation on data changes.\n\n## Key Features\n\n- **Role-Based Access Control**: Separate dashboards for patients, dentists, admin, and staff\n- **Real-time Updates**: Live updates via Supabase subscriptions (inventory \u0026 dentist system)\n- **Payment Integration**: PayMongo for reservation fees and billing\n- **Responsive Design**: Mobile-first approach with Tailwind CSS\n- **Accessibility**: WCAG-compliant components via shadcn/ui (Radix UI)\n- **Type Safety**: Full TypeScript coverage\n\n## Available Scripts\n\n```bash\npnpm run dev       # Start development server\npnpm run build     # Build for production\npnpm run preview   # Preview production build\npnpm run lint      # Run ESLint\n```\n## Environment Modes\n\n### Development\n- Connects to local backend services\n- Hot module replacement enabled\n- Debug logging active\n\n### Production\n- Optimized build with code splitting\n- Connects to production backend URLs\n- Error tracking enabled\n\n## Contributing\n\nThis project is part of a collaborative system development effort. Each subsystem (Front Desk, Inventory, Patient Records, Dentist) is maintained by different teams while sharing this unified frontend.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbatdimoiprint%2Fmedicare-supersystem-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbatdimoiprint%2Fmedicare-supersystem-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbatdimoiprint%2Fmedicare-supersystem-frontend/lists"}