|
1 | | -<<<<<<< HEAD |
2 | | -<div align="center"> |
3 | | - <img src="https://capsule-render.vercel.app/api?type=waving&color=0:0d1117,100:00ffcc&height=200§ion=header&text=noshowiq&fontSize=50&fontColor=ffffff&fontAlignY=40&desc=Upgraded%20Startup%20Project&descAlignY=65" width="100%"/> |
4 | | - |
5 | | - [](#) |
6 | | - [](#) |
7 | | -</div> |
8 | | - |
9 | | -## ?? Overview |
10 | | -Welcome to the upgraded repository for **noshowiq**. |
11 | | - |
12 | | -> **Note on Deployment:** The previous live deployment for this project was temporarily suspended during infrastructure migration. We have disabled the external live links to prevent 404 errors. This repository remains fully functional locally. |
13 | | -
|
14 | | -## ?? Key Architectural Features |
15 | | -- **High-Performance Core:** Built for scalability and autonomous operations. |
16 | | -- **Modern UI/UX:** Features advanced dashboard logic and secure routing. |
17 | | -- **Sovereign Infrastructure Ready:** Currently being refactored for the Kirov Dynamics cloud ecosystem. |
18 | | - |
19 | | -## ??? Local Development Setup |
20 | | -To run this project locally without relying on external cloud providers: |
21 | | - |
22 | | -`ash |
23 | | -git clone https://github.com/Raphasha27/noshowiq.git |
24 | | -cd noshowiq |
25 | | -# Install dependencies according to package manager (npm/pip/cargo) |
26 | | -# Start the local development server |
27 | | -` |
28 | | - |
29 | | -## ?? Roadmap |
30 | | -- [x] Clear dead Vercel/Heroku links to prevent 404 routing errors. |
31 | | -- [ ] Migrate CI/CD to local GitHub Actions. |
32 | | -- [ ] Deploy isolated -lab environment. |
33 | | -======= |
34 | | -# NoShowIQ |
35 | | - |
36 | | -Predictive healthcare analytics platform focused on reducing patient no-shows, improving clinic efficiency, and modernizing appointment operations for healthcare teams. |
37 | | - |
38 | | -## Live Demo |
39 | | - |
40 | | -[noshowiqbookings.vercel.app](https://noshowiqbookings.vercel.app) |
41 | | - |
42 | | -## Highlights |
43 | | - |
44 | | -- Real-time patient queue tracking |
45 | | -- Mobile-first responsive experience |
46 | | -- South Africa-focused localization |
47 | | -- FastAPI backend with persistent storage |
48 | | -- PostgreSQL-ready production setup |
49 | | - |
50 | | -## Stack |
51 | | - |
52 | | -- Frontend: Next.js, TypeScript, Tailwind CSS |
53 | | -- Backend: FastAPI, SQLAlchemy |
54 | | -- Database: PostgreSQL in production, SQLite for local development |
55 | | -- Deployment: Vercel |
56 | | - |
57 | | -## Getting Started |
58 | | - |
59 | | -### Prerequisites |
60 | | - |
61 | | -- Node.js 18+ |
62 | | -- Python 3.9+ |
63 | | - |
64 | | -### Frontend |
65 | | - |
| 1 | +# NoShowIQ - Intelligent Appointment Management |
| 2 | + |
| 3 | +[](https://github.com/Raphasha27/noshowiq/actions) |
| 4 | +[](https://github.com/Raphasha27/noshowiq/actions) |
| 5 | +[](https://docker.com) |
| 6 | +[](https://typescript.com) |
| 7 | +[](LICENSE) |
| 8 | + |
| 9 | +Intelligent appointment management and no-show prediction engine with integrated trust-scoring for service providers. Part of the Kirov Dynamics ecosystem. |
| 10 | + |
| 11 | +## Features |
| 12 | +- **No-Show Prediction** - ML-based patient no-show forecasting |
| 13 | +- **Trust Scoring** - Dynamic patient reliability scoring |
| 14 | +- **Smart Scheduling** - Optimized appointment allocation |
| 15 | +- **Real-time Notifications** - SMS/Email reminders |
| 16 | +- **Analytics Dashboard** - Comprehensive booking insights |
| 17 | + |
| 18 | +## Tech Stack |
| 19 | +| Component | Technology | |
| 20 | +|-----------|------------| |
| 21 | +| Frontend | TypeScript, HTML5, CSS3 | |
| 22 | +| Backend | Node.js (TypeScript) | |
| 23 | +| Database | PostgreSQL | |
| 24 | +| ML Engine | Python (scikit-learn) | |
| 25 | +| Container | Docker Compose | |
| 26 | + |
| 27 | +## Quick Start |
66 | 28 | ```bash |
67 | | -cd frontend |
68 | | -npm install |
69 | | -npm run dev |
70 | | -``` |
71 | | - |
72 | | -### Backend |
| 29 | +# Development |
| 30 | +docker compose up -d |
73 | 31 |
|
74 | | -```bash |
75 | | -cd backend |
76 | | -pip install -r requirements.txt |
77 | | -python main.py |
| 32 | +# Or run manually |
| 33 | +cd frontend && npm install && npm run dev |
| 34 | +cd backend && npm install && npm start |
78 | 35 | ``` |
79 | 36 |
|
80 | | -## Project Status |
81 | | - |
82 | | -NoShowIQ is an active product prototype under ongoing refinement. |
83 | | - |
84 | | -## License |
85 | | - |
86 | | -This repository is currently shared for portfolio and review purposes. See [LICENSE](LICENSE). |
87 | | ->>>>>>> dde5480add1bbc7c4fd4a9060b08b5b7bbdfdf20 |
| 37 | +## Infrastructure |
| 38 | +- **CI/CD**: GitHub Actions automated builds |
| 39 | +- **Security**: CodeQL + Dependabot |
| 40 | +- **Container**: Multi-service Docker Compose |
| 41 | +- **Monitoring**: Health check endpoints |
0 commit comments