{"id":21168947,"url":"https://github.com/RainerNsa/Bright-Smiles","last_synced_at":"2025-10-02T04:30:18.744Z","repository":{"id":262245754,"uuid":"886647359","full_name":"RainerNsa/Bright-Smiles","owner":"RainerNsa","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-11T11:15:32.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T04:36:20.226Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://bright-smiles-one.vercel.app","language":"Python","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/RainerNsa.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}},"created_at":"2024-11-11T10:59:35.000Z","updated_at":"2024-11-28T19:00:29.000Z","dependencies_parsed_at":"2024-11-11T12:23:14.746Z","dependency_job_id":"3d89fae7-24bf-4ad6-b553-73e903adf350","html_url":"https://github.com/RainerNsa/Bright-Smiles","commit_stats":null,"previous_names":["woldreamz/bright-smiles","rainernsa/bright-smiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RainerNsa/Bright-Smiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RainerNsa%2FBright-Smiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RainerNsa%2FBright-Smiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RainerNsa%2FBright-Smiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RainerNsa%2FBright-Smiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RainerNsa","download_url":"https://codeload.github.com/RainerNsa/Bright-Smiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RainerNsa%2FBright-Smiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277958022,"owners_count":25905625,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-02T02:00:08.890Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2024-11-20T15:19:50.727Z","updated_at":"2025-10-02T04:30:18.438Z","avatar_url":"https://github.com/RainerNsa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dental Management Platform\n\nThis project is a Dental Management Platform built for **Bright Smile Dental Systems**. The platform allows administrative employees to manage clinics, doctors, and patients across multiple locations in the United States. Users can manage key aspects such as scheduling appointments, tracking visits, and editing details for clinics, doctors, and patients.\n\n## Table of Contents\n- [Project Overview](#project-overview)\n- [Features](#features)\n  - [Clinics Management](#clinics-management)\n  - [Doctors Management](#doctors-management)\n  - [Patients Management](#patients-management)\n- [Technology Stack](#technology-stack)\n- [REST API Endpoints](#rest-api-endpoints)\n- [Setup Instructions](#setup-instructions)\n- [Usage](#usage)\n- [Testing](#testing)\n- [Project Deliverables](#project-deliverables)\n- [Assumptions](#assumptions)\n\n## Project Overview\nThe Dental Management Platform provides an intuitive interface for managing:\n- Clinics\n- Doctors\n- Patients\n\nThe platform is built with Django for the backend and frontend, utilizing PostgreSQL for database management.\n\n## Features\n### Clinics Management\n- **Clinics List**: Displays clinic details including name, phone, location, and counts of affiliated doctors and patients.\n- **Clinic Detail Page**: \n  - Edit clinic information (name, address, phone, email).\n  - List and manage affiliated doctors, including office address and schedule.\n\n### Doctors Management\n- **Doctors List**: Displays doctor details such as NPI, name, specialties, and affiliations with clinics and patients.\n- **Doctor Detail Page**:\n  - Edit doctor information (NPI, name, email, phone, specialties).\n  - View affiliations with clinics and patients.\n\n### Patients Management\n- **Patients List**: Displays patient details including name, date of birth, visit history, and upcoming appointments.\n- **Patient Detail Page**:\n  - Edit patient information (name, address, phone, date of birth, SSN, gender).\n  - List visit history and schedule new visits.\n  - Manage upcoming appointments, including selection of procedure, clinic, doctor, and time slot.\n\n### Predefined Procedures\n- Supported procedures: Cleaning, Filling, Root Canal, Crown, Teeth Whitening.\n\n## Technology Stack\n- **Backend**: Django\n- **Frontend**: HTML, Bootstrap, JavaScript\n- **Database**: PostgreSQL\n\n## REST API Endpoints\nThe platform includes REST APIs for:\n- Adding a patient, doctor, or clinic.\n- Retrieving clinic information (excluding affiliations).\n\n## Setup Instructions\n1. **Clone the repository**:\n   ```bash\n   git clone \u003crepository-link\u003e\n   cd \u003crepository-directory\u003e\n   ```\n\n2. **Set up virtual environment**:\n   ```bash\n   python3 -m venv venv\n   source venv/bin/activate\n   ```\n\n3. **Install dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Database setup**:\n   - Configure PostgreSQL and set the credentials in `settings.py`.\n   - Run migrations:\n     ```bash\n     python manage.py makemigrations\n     python manage.py migrate\n     python manage.py collectstatic\n     ```\n\n5. **Run the server**:\n   ```bash\n   python manage.py runserver\n   ```\n## BaseUrl\n- localhost\n\n## Usage\n- **Login**: Users log in with an email and password (using Django’s admin features).\n- **Navigation**: Access tabs for Clinics, Doctors, and Patients to manage each category.\n- **Scheduling**: Follow a structured workflow to schedule appointments with procedure, clinic, and doctor selections.\n\n## Testing\nUnit tests are included for critical functionalities. Run tests with:\n```bash\npython manage.py test\n```\n### Endpoints Available\n#### - /patients/add/\u003cbr /\u003e\n      method: GET, POST\n      body: {name:'', d_o_b:'', address:'', gender:'', ssn_last_4:'', phone_number:''}\n      response: {}\n      description: add patient record \n#### - /doctors/add/\u003cbr /\u003e\n      method: GET, POST\n      body: {npi:'', name:'', email:'', phone_number:'', office_address:'', specialties:''}\n      response: {}\n      description: add doctor record \n#### - /clinics/add/\u003cbr /\u003e\n      method: GET, POST\n      body: {name:'', phone_number:'', city:'', state:''}\n      response: {}\n      description: register clinic\n#### - /clinics/view/\u003cbr /\u003e\n      method: GET\n      body: none \n      response: {}\n      description: view registered clinics \n  \n\n## Project Deliverables\n- Functional prototype with main features and REST API.\n- Unit tests for critical features.\n- Documentation (README) with setup and usage instructions.\n\n## Assumptions\nThe project assumes:\n- Clinics have doctors affiliated with them, who in turn have patients assigned.\n- Appointments are scheduled only within available doctor time slots.\n\n---\n\nThis README should provide clear instructions and insights for setting up, using, and understanding the project’s functionalities.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRainerNsa%2FBright-Smiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRainerNsa%2FBright-Smiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRainerNsa%2FBright-Smiles/lists"}