Skip to content

japer-technology/full-stack-dentist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 

Repository files navigation

full-stack-dentist

A single-source, open-core super app for the full dental lifecycle: student, clinician, practice owner, researcher, educator, retiree, and estate executor.

The goal is not “practice-management software with extra features.” The goal is a sovereign operating system for a dentist’s personal, professional, clinical, business, compliance, and knowledge life — without forcing them to rent fragmented third-party tools forever.

It serves the person, not only the practitioner: the body that wears out, the mind under chronic load, the household finances that are not the practice’s money, the family, the personal legal and digital life, and the identity that exists outside the chair. See docs/personal-life-and-wellbeing.md.

Product thesis

Dentists currently stitch together dozens of systems:

  • notes, tasks, email, calendar, contacts
  • study tools, CPD/CE records, licensing evidence
  • patient records, treatment planning, consent, recalls
  • imaging, labs, prescriptions, referrals
  • accounting, payroll, insurance, inventory, suppliers
  • website, CRM, reputation, analytics, marketing
  • compliance, incident response, audits, policies
  • association, study-club, society, committee, event, CPD/CE, advocacy, and member-management tools
  • degree, skill, credential, authority, evidence, and truth-management tools
  • AI-agent competitions that propose, critique, rank, and route actions through human approval
  • estate, succession, retirement, data export, continuity
  • personal life: wellbeing, occupational/personal health, household finance, family, personal legal, and digital estate — kept separate from professional and patient data

That fragmentation creates cost, lock-in, duplicated data, weak security boundaries, and poor continuity across a dentist’s career.

full-stack-dentist exists to make one trustworthy repo that can generate deployable apps, services, policies, schemas, automations, and documentation for every stage of that lifecycle.

Non-negotiable principles

  1. Dentist data sovereignty

    • The dentist or practice owns the data.
    • Every record must be exportable in documented formats.
    • No silent lock-in, dark patterns, or forced SaaS dependency.
  2. Privacy and security by design

    • Zero-trust architecture.
    • Least privilege everywhere.
    • Encryption in transit and at rest.
    • Strong audit logs.
    • Explicit consent and purpose limitation.
  3. Multi-country from day zero

    • Jurisdiction is a first-class concept, not an afterthought.
    • Legal, tax, health-record, privacy, and retention rules are policy modules.
    • The core platform must not hard-code one country’s assumptions.
  4. Clinical safety before convenience

    • The app must distinguish administrative support, clinical recordkeeping, clinical decision support, and regulated medical-device behavior.
    • No feature may pretend to diagnose, prescribe, or automate clinical judgment without an explicit regulatory pathway.
  5. Interoperability first

    • Prefer open standards over proprietary formats.
    • Healthcare exchange should align with HL7 FHIR where applicable.
    • Dental concepts should map to recognised coding and imaging standards where licensing permits.
  6. Local-first capable, cloud-optional

    • A solo dentist should be able to run a useful version locally.
    • A group practice should be able to run a hardened private deployment.
    • Cloud services are accelerators, not mandatory dependencies.
  7. Auditability over magic

    • Every important state change should answer: who, what, when, where, why, and under what authority.
    • AI features must be explainable, reviewable, reversible, and clearly labelled.
  8. Protocol-native interchange

    • Data crossing a boundary must use documented schemas, versioning, authority, audit, and export evidence.
    • Support verifiable credentials, learning records, healthcare exchange, event APIs, and signed agent-action envelopes where appropriate.
  9. Truth is claim plus evidence

    • Degrees, skills, licences, CPD/CE, memberships, roles, authority, and insurance are claims with issuers, evidence, expiry, revocation, confidence, and audit.
    • AI may extract or challenge claims, but humans or trusted issuers approve truth changes.
  10. AI competes; humans approve

  • The software stack should run scout/worker/critic/judge/executor/auditor agent loops.
  • Consequential actions require human-in-the-loop approval with evidence, dissent, policy decisions, and audit receipts.

Reference standards and frameworks

Use these as baseline design inputs, not decorative badges:

  • NIST Cybersecurity Framework 2.0
  • NIST Privacy Framework
  • OWASP ASVS 5.0.0
  • ISO/IEC 27001 family for information-security management
  • ISO/IEC 27701 for privacy-information management
  • HL7 FHIR R5 for healthcare interoperability where appropriate
  • DICOM for imaging workflows where appropriate
  • GDPR, UK GDPR, HIPAA, PIPEDA, Australian Privacy Act, NZ Privacy Act, and other jurisdiction modules as applicable

See docs/standards-and-assumptions.md.

Primary users

  • Dental student
  • New graduate dentist
  • Associate dentist
  • Specialist dentist
  • Practice owner
  • Multi-site group operator
  • Dental educator
  • Researcher
  • Retired dentist
  • Executor or continuity officer handling records after death/incapacity
  • Dental association, society, chapter, study-club, buying-group, alumni, charity, or committee administrator

Core domains

  • Identity, access, roles, delegated authority
  • Personal knowledge management
  • Study and exam preparation
  • CPD/CE and licensing evidence
  • Degree, skill, licence, credential, membership, authority, and verifiable-claim management
  • Patient relationship management
  • Clinical records and charting
  • Treatment planning and consent
  • Imaging and documents
  • Lab and referral workflows
  • Prescriptions and medication safety hooks
  • Practice operations
  • Finance, tax, payroll, and accounting integrations
  • Inventory, suppliers, assets, maintenance
  • Marketing, website, reviews, CRM
  • Compliance, risk, policies, incident response
  • Association management, study-club management, membership, committees, events, CPD/CE, elections, advocacy
  • Analytics, reporting, benchmarking
  • AI assistants and automations
  • AI competitions, critics, judges, human approvals, execution receipts, and outcome learning
  • Data export, succession, retirement, and estate continuity
  • Personal life and wellbeing: the dentist as a whole human — occupational and personal health, mental health and burnout, household finance, family and caregiving, personal legal and life admin, and personal digital estate

Architecture stance

This repo should become a modular monorepo:

apps/              End-user applications
services/          Backend services and workers
packages/          Shared libraries, schemas, SDKs
modules/           Domain modules: clinical, finance, compliance, etc.
policies/          Jurisdiction and compliance policy packs
schemas/           Canonical data contracts
infra/             Deployment, observability, secrets, backup, recovery
docs/              Product, architecture, security, compliance, roadmap

The canonical architecture is documented in docs/architecture.md.

MVP definition

The first credible MVP is not a full dental empire. It is a secure personal/professional cockpit for one dentist:

  1. Identity and local encrypted vault
  2. Personal profile and credentials register
  3. CPD/CE evidence tracker
  4. Document vault with retention labels
  5. Task/calendar/contact foundation
  6. Jurisdiction profile
  7. Audit log
  8. Export bundle
  9. AI assistant limited to retrieval, summarisation, drafting, and checklists — no autonomous clinical advice

See docs/roadmap.md.

Organised dentistry

This project also covers software dentists need when they organise together:

  • dental associations and societies
  • study clubs and peer groups
  • specialist colleges and interest groups
  • alumni networks
  • CPD/CE providers
  • buying groups and supplier collectives
  • advocacy groups
  • charities and outreach programs
  • committees, boards, elections, ethics panels, and complaints processes

Association and study-club management is documented in docs/association-management.md.

Protocols, truth, and AI competitions

Three deeper system layers now guide the architecture:

  • docs/interchange-protocols.md — open interchange across healthcare, education, finance, association, event, and AI-agent boundaries.
  • docs/degree-skill-truth-management.md — claims, evidence, issuers, verification, expiry, revocation, and skill graphs.
  • docs/ai-competition-human-loop.md — scout/worker/critic/judge/executor/auditor loops where AI competes and humans approve.

The full human lifecycle

This is not software for the billing years alone. It follows the whole arc — a human becomes a dentist, serves, lives, retires, and hands their work to those who outlive them.

  • docs/lifecycle-journey.md — the aspiring → student → clinician → owner → retiree → legacy arc and the dangerous transitions between stages.
  • docs/estate-succession-continuity.md — death, incapacity, succession, record custodianship, and provider-failure continuity.
  • docs/patient-experience-and-rights.md — the patient as a first-class subject with enforceable rights.

The whole human, not only the practitioner

This is software for the person who happens to be a dentist, not only for the dentist at work. A career punishes the body, loads the mind, and entangles personal and professional finance and continuity. The platform serves that private life with its highest privacy posture and a hard boundary against the professional world.

  • docs/personal-life-and-wellbeing.md — occupational and personal health, mental health and burnout, household finance and wealth, family and caregiving, personal legal and life admin, personal digital estate, and the strictly-bounded personal/professional divide.

How this stack is built

This stack is assembled with the best AI available, in consultation with dental groups and associations, and improved by an evolutionary "survival of the fittest" model. Those phrases are treated as disciplined commitments, not slogans: AI works inside the human-in-the-loop model, consultation is recorded as evidence and never overrides safety or law, and a candidate only survives if it is measurably fitter against an explicit, charter-aligned fitness function.

  • docs/build-philosophy-and-evolution.md — how the platform is built with AI and stakeholders, and the variation/selection/inheritance rules that bound the evolutionary model.

Sovereignty

"If you have the full source to a thing, you won that thing." Ownership is a testable property, not a slogan.

  • docs/data-sovereignty-and-licensing.md — data- and source-sovereignty guarantees, the exit test, and licensing constraints.

Cross-cutting operating layers

World-class grounding across every layer, not only the domains:

  • docs/clinical-safety.md — risk classes, hazard log, and clinical launch gates.
  • docs/quality-and-testing-strategy.md — how "tests must prove" becomes mandatory invariant tests.
  • docs/observability-and-operations.md — running, monitoring, recovering, and auditing the platform.
  • docs/accessibility-inclusion-and-ux.md — accessibility, internationalisation, and safety-critical UX.
  • docs/governance-and-contribution.md — how the initiative is steered and contributed to.
  • docs/glossary.md — the shared vocabulary for the whole charter.

Documentation index

Every document in this repository, linked for ease of use.

Product and architecture

Security, privacy, and compliance

Engineering and operations

Protocols, truth, and AI

People, lifecycle, and organised dentistry

  • Lifecycle Journey — the aspiring → student → clinician → owner → retiree → legacy arc and the dangerous transitions between stages.
  • Estate, Succession, and Continuity — death, incapacity, succession, record custodianship, and provider-failure continuity.
  • Patient Experience and Rights — the patient as a first-class subject with enforceable rights.
  • Personal Life and Wellbeing — occupational and personal health, mental health and burnout, household finance and wealth, family and caregiving, personal legal and life admin, personal digital estate, and the strictly-bounded personal/professional divide.
  • Association Management — associations, societies, study clubs, committees, events, and member management.

Architecture Decision Records (ADRs)

Repository status

Early product-charter phase. No clinical, privacy, or security guarantees exist until implemented and verified.

Legal and safety notice

This project is not yet a medical device, electronic health record, prescribing system, accounting system, legal-compliance product, or regulated clinical decision-support system. Any feature entering those categories must be designed, reviewed, validated, and deployed under the relevant regulatory obligations for each jurisdiction.

About

⚠️UNDER DEVELOPMENT A full software stack for dentists

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors