Skip to content

Gitechnolo/biotechproject

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5,622 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
BiotechProject Performance Audit - 100% Lighthouse Scores

BiotechProject ๐Ÿงฌ ๐Ÿ‡ฌ๐Ÿ‡ง

SRE Resilience Audit

๐ŸŒ Read in other languages:
Italiano ๐Ÿ‡ฎ๐Ÿ‡น | English ๐Ÿ‡ฌ๐Ÿ‡ง | Espaรฑol ๐Ÿ‡ช๐Ÿ‡ธ | Franรงais ๐Ÿ‡ซ๐Ÿ‡ท | Deutsch ๐Ÿ‡ฉ๐Ÿ‡ช | Dutch ๐Ÿ‡ณ๐Ÿ‡ฑ | Portuguรชs (BR) ๐Ÿ‡ง๐Ÿ‡ท

๐Ÿ’ก Executive Briefing (Jan 17, 2026):

This project has evolved from a performance-driven experiment into a Strategic Blueprint for Resilient Health Architecture.
We have formalized our "Stateless Edge" methodology in a new report that addresses global health inequities caused by latency and cognitive barriers.

๐Ÿ‘‰ Read the Strategic Report: Architectural Equity & Global Resilience Report (PDF)

๐ŸŒ "We don't all speak the same languages, but we speak the same language: collaboration."
English is not a barrier - it's a bridge.
๐Ÿ”น To contribute or review project guidelines, visit the main English files:

An open source project that unites science, health, and web technology.
Where biotechnology meets code to build digital tools for research and innovation.

License Workflow Status Last Commit Security Vulnerabilities


๐ŸŒฑ What is BiotechProject?

BiotechProject is an open digital lab that combines biotechnology, health, and web development into an integrated system designed to be:

  • ๐Ÿ” Scientifically reliable
  • ๐Ÿ’ป Technically robust
  • ๐ŸŒ Accessible to everyone, including users with disabilities
  • ๐Ÿค Open to global collaboration

It was created to show how technology can serve science and healthcare, while ensuring equitable access for all -- regardless of sensory, cognitive, or motor abilities.

It's a collaborative space for developers, researchers, and enthusiasts who want to explore how the web can become a tool for inclusion and scientific innovation.

๐Ÿ—บ๏ธ Our Strategic Vision for Scalability

BiotechProject Strategic Roadmap diagram showing three phases (I: Days 1-30, II: Days 31-60, III: Days 61-90) leading to Strategic Outcomes like Scalability Blueprint and Health Equity Certification. It highlights key technical milestones like Stateless Edge Deployment, Resource Optimization, and Privacy by Architecture.

๐Ÿš€ Key Features

โœ… Open by design
โ†’ Open to contributions, ideas, and international collaboration

โœ… Integrated CI/CD workflow
โ†’ Automated testing, analysis, and updates on every change

โœ… Automated performance dashboard
โ†’ Continuous analysis of all pages with updates to performance-data.json

โœ… Dynamic filter by category
โ†’ Interactive interface to explore technological maturity status

โœ… Responsive and accessible design
โ†’ Works across all devices, with strong focus on usability and WCAG compliance

โœ… Privacy-by-Architecture โ†’ 100% client-side data processing ensures bio-sensitive data never leaves the user's browser, aligning with GDPR/HIPAA standards by design.


๐ŸŽฏ Target Audience & Strategic Vision

The BiotechProject is engineered for stakeholders who prioritize resilience as a clinical requirement:

  • Health Systems & Health Initiatives: Designed to scale metabolic digital twins with zero server-side compute costs, leveraging high-performance Vanilla JS for complex client-side logic.
  • Global Health Equity: Engineered specifically for users in low-connectivity regions, ensuring sub-second (0.3s) load times even on legacy devices through SRE-grade optimization.
  • Neurodivergent Patients: Native WCAG AAA compliance and 'Comfort Mode' provide a cognitively safe environment for healthcare interaction, reducing sensory overload.
  • SRE & Systems Engineers: A blueprint for "SRE-for-Humans," where performance metrics (95% aggregate score) are treated as a commitment to user inclusion and reliability.

๐Ÿ— Architectural Decision Records (ADR)

This project follow a rigorous decision-making process to ensure enterprise-grade resilience. Each decision is cross-validated for architectural integrity.

ID Decision Core Outcome Validation
001 Zero-Framework Mandate < 20KB Bundle / 0.3s TTI Issue #12
002 Stateless Edge Intelligence 100% Service Availability Issue #13
003 AI-Assisted SRE Auditing 87% Tech Maturity Score Issue #14
004 Circadian State Machine 98% CPU Cycle Reduction Issue #15
005 SRE-Driven Data Portability Zero-Latency Data Export Issue #17
Click to expand: Full ADR Rationale

[ADR-001] Zero-Framework Mandate

  • Decision: Bypass modern frameworks (React/Angular/Vue) in favor of pure Vanilla JS (ES6+).
  • Rationale: Eliminates the "framework tax". In health-critical contexts, sub-second interactivity is a clinical requirement.
  • Outcome: Initial bundle size < 20KB and TTI of 0.3s.
  • Validation: View Engineering Log (#12)

[ADR-002] Stateless Edge & Client-Side Intelligence

  • Decision: Migrate complex metabolic and biological sync logic entirely to the client side.
  • Rationale: Guarantees 100% service availability during network surges or backend outages.
  • Outcome: 85% reduction in infrastructure costs.
  • Validation: View Resilience Report (#13)

[ADR-003] AI-Assisted SRE Auditing

  • Decision: Multi-model orchestration (Gemini + Copilot) for code review.
  • Rationale: Overcomes individual LLM hallucinations via "consensus" on type safety.
  • Outcome: 87% technical maturity score.
  • Validation: View Audit Protocol (#14)

[ADR-004] Circadian State Machine

  • Decision: Implementation of a resource-efficient Early Return pattern.
  • Rationale: Reduces cognitive load without triggering expensive re-renders or heavy polling.
  • Outcome: 98% reduction in background CPU cycles.
  • Validation: View Performance Pattern (#15)

[ADR-005] SRE-Driven Data Portability

  • Decision: Deployment of a zero-latency export layer using native Blob APIs.
  • Rationale: Ensures data sovereignty for health records with "Lean Logic" (no libraries).
  • Outcome: Instant CSV/JSON generation.
  • Validation: View Export Strategy (#17)

๐Ÿ“Š Technical Quality Monitoring & Architecture

The project implements an advanced technological maturity tracking system via GitHub Actions. As of March 14, 2026, the ecosystem maintains a 95% aggregate performance score.

Important

Performance Stress-Test: Metrics are validated under extreme synthetic throttling (150ms RTT / 4x CPU slowdown). This SRE-grade audit ensures that core clinical modules remain accessible and performant even during peak-hour network instability or on legacy hardware.

Update March 14, 2026: Successfully integrated the Data Portability Audit layer (ADR-005). The system now supports real-time performance telemetry exports without impacting Main Thread execution.

๐Ÿ“‚ Latest Audit Records:

Dashboard Features

  • โœ… Real-time Performance Monitoring: Metrics (0โ€“100) updated every 24h via GitHub Actions.
  • โœ… Resilience Intelligence: Automated tracking of optimized and compatible states under stress.
  • ๐Ÿ’พ Open Data & Transparency: Access the Raw Performance Dataset (JSON) for third-party verification or download analytics directly from the UI.

๐Ÿ‘‰ View the live dashboard: Tech_Maturity.html


๐Ÿ“‚ Navigation Hub (Optimized Assets)

Tip

This section provides a streamlined interface to access the minified production assets. For development files, please refer to the src/ directory.

๐Ÿ›ก๏ธ Verified Production Assets

SRE Audit Status

Important

Methodology Note: The dates listed in the "Last Audit" column represent the most recent Global System Validation. This includes automated security scans, performance stress-tests (Lighthouse), and link integrity checks. Even if a specific asset's content remains unchanged, its reliability is recertified during each audit cycle.

๐Ÿงฌ Anatomy & Biological Systems (Standard & Easy-Read)
System โšก Scientific standard ๐Ÿ“ Dyslexia-friendly ๐Ÿ“… Last Audit
Digestive System View Easy-Read 2026-03-22
Respiratory System View Easy-Read 2026-03-22
Integumentary System View Easy-Read 2026-03-22
Lymphatic System View Easy-Read 2026-03-22
Heart / Cardiac View Easy-Read 2026-03-22
Cell Biology View Easy-Read 2026-03-22
Dermatology View Easy-Read 2026-03-22
Hair / Capelli View Easy-Read 2026-03-22
๐Ÿ› ๏ธ Project Management & Utilities
Resource Access Link ๐Ÿ“… Last Audit
๐Ÿš€ Tech Maturity Score Interactive Dashboard 2026-03-22
๐Ÿ“ˆ Marketing Strategy Strategic Analysis 2026-03-22
๐Ÿ—๏ธ Project Portfolio Project Overview 2026-03-22
๐Ÿ‘ฅ Staff & Team Governance & Members 2026-03-22
๐Ÿ’ฌ Tablet Forum Community Discussion 2026-03-22
โ™ฟ Accessibility & Inclusion
  • ๐Ÿ‡ฎ๐Ÿ‡น Dichiarazione di Accessibilitร : Leggi (IT) โ€” Updated: 2026-03-22
  • ๐Ÿ‡ฌ๐Ÿ‡ง Accessibility Statement: Read (EN) โ€” Updated: 2026-03-22
  • โœจ Special Modules: Specials โ€” Updated: 2026-03-22

๐ŸŒ Accessibility

The site is conformant with WCAG 2.1 Level AA for all main pages.
Conformance has been verified through:

  • Automated audits (Lighthouse, axe, WAVE)
  • Manual testing with screen readers (NVDA, VoiceOver)
  • Full keyboard navigation (tab, shift+tab, enter, space, arrows)
  • W3C code validation
  • Direct code inspection for semantic structure and correct ARIA usage

The project is partially conformant with Level AAA, particularly in:

  • Color contrast (most text exceeds 7:1 ratio)
  • Hierarchical heading structure
  • Use of descriptive alternative text

However, some AAA criteria are not applicable or required in the current context (e.g. video captions, extended plain language).

๐Ÿ“„ Full accessibility statement:
๐Ÿ‘‰ Read Accessibility Statement (EN)
๐Ÿ‘‰ Leggi la Dichiarazione di Accessibilitร  (IT)

๐Ÿ” Advanced Accessibility Features

  • DNA Scanner & Audit: Interactive module with structured PDF Report generation, bilingual aria-label, and secure focus management
  • HUD & Dynamic Tooltips: Instant scientific explanations with text descriptions and percentage intensity values for all data points
  • Circadian Synchrony: Content adapts to time and season (axial tilt), reducing cognitive load via biological context-aware advice

Accessibility & Case Study

We're committed to building an inclusive platform. Explore how we implemented WCAG 2.1 AA compliance and multilingual support:

Case Study - Building an Accessible Biotech Platform

๐ŸŒ Multilingual Management (i18n)

BiotechProject supports multiple languages through a modular, lightweight, and accessible translation system, designed to work seamlessly on static pages hosted on GitHub Pages. "While text content is fully localized, scientific diagrams currently prioritize Italian/English versions to maintain technical accuracy during the project's rapid evolution."

The system enables:

  • โœ… Real-time content translation
  • โœ… Persistent language selection across pages (like Wikipedia or Google)
  • โœ… Support for simplified versions for dyslexic users
  • โœ… Easy extension by contributors

๐Ÿงฉ System Architecture

  • Modular JSON files: each page has its own translation file in the lang/ directory
  • Common.json: contains shared texts (menu, footer, language button)
  • No backend required: everything runs in pure JavaScript
  • LocalStorage: remembers the user's selected language
  • data-lang-key: HTML attribute to identify translatable elements

๐Ÿ“ Structure of the lang/ folder

common.json contains shared strings (menu, footer, etc.), page files contain per-page text.

lang/
โ”œโ”€โ”€ common.json                  # Shared strings (menu, footer, UI)
โ”‚
โ”œโ”€โ”€ home.json                    # index.html
โ”œโ”€โ”€ progetti.json                # Progetti.html
โ”œโ”€โ”€ staff.json                   # Staff.html
โ”œโ”€โ”€ marketing.json               # Marketing.html
โ”œโ”€โ”€ tech_maturity.json           # Tech_Maturity.html
โ”‚
โ”œโ”€โ”€ dermatologia.json            # Dermatologia.html + Dermatologia-semplice.html
โ”œโ”€โ”€ cuore.json                   # Cuore.html + Cuore-semplice.html
โ”œโ”€โ”€ cellula.json                 # Cellula.html + Cellula-semplice.html
โ”œโ”€โ”€ apparato_digerente.json      # Apparato_digerente.html + -semplice.html
โ”œโ”€โ”€ apparato_respiratorio.json   # Apparato_respiratorio.html + -semplice.html
โ”œโ”€โ”€ apparato_tegumentario.json   # Apparato_tegumentario.html + -semplice.html
โ”œโ”€โ”€ sistema_linfatico.json       # Sistema_linfatico.html + -semplice.html
โ””โ”€โ”€ capelli.json                 # Capelli.html + Capelli-semplice.html

๐Ÿ“… Last Verification Date

March 22, 2026

๐Ÿ”ฎ Recent updates (summary)

Key recent improvements (concise):

  • Performance dashboard: Lighthouse data integrated into data/performance-latest.json and visualized on Tech_Maturity.html (chart + page list + export).
  • Data export: JSON/CSV export from dashboard ("Export data").
  • Charts + accessibility: Chart.js charts accompanied by hidden tables/descriptions for assistive tech.
  • Performance optimizations: advanced lazy-loading, deferred heavy scripts, optimized particle canvas and cleanup.
  • UX & preferences: dynamic theme, persisted preferences (localStorage), improved keyboard navigation and ARIA/focus handling.
  • CI/CD & transparency: automated Lighthouse runs (generate-performance.js) and public JSON for audits.

๐Ÿ’ก Want to contribute?

You're welcome!
BiotechProject is an open project for everyone, inspired by the collaborative spirit of Wikipedia.

๐Ÿ”น To get started:

You can help with:

  • Scientific content
  • Technical or accessibility improvements
  • Translations
  • Bug reports and suggestions

Every contribution โ€” big or small โ€” helps make science more accessible.


๐Ÿ› ๏ธ Technologies Used

  • Semantic HTML5
  • CSS3 with Custom Properties
  • Vanilla JavaScript (no frameworks)
  • ARIA 1.2 for dynamic interactions
  • GitHub Actions for CI/CD
  • Lighthouse for performance monitoring

๐Ÿ“„ License

๐Ÿ“„ License: CC BY 4.0
You are free to share, adapt, and use the project commercially, as long as you give appropriate credit.

"Anyone can contribute. Just respect the origin, and keep building with care."


๐Ÿ™Œ Author

Author: Fabrizio (@Gitechnolo)
Project available at: https://github.com/Gitechnolo/biotechproject

โ€œAnyone can contribute. Just respect the origin, and keep building with care.โ€