mahdahar/tinyqc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
tinyqc/docs/project-overview.md
mikael-zakaria cf9ac38849 first gdc prod commit
2026-02-12 09:01:59 +07:00

3.2 KiB
Executable File
Raw Blame History

TinyQC - Quality Control Management System

Executive Summary

TinyQC is a CodeIgniter 4 PHP application designed for quality control data management in laboratory settings. The system provides comprehensive tools for managing departments, tests, control parameters, daily/monthly entries, and generating QC reports. Built with a modern frontend stack (TailwindCSS, Alpine.js, DaisyUI) and SQL Server database.

Repository Type: Monolith (single cohesive codebase)

Technology Stack

Layer Technology Version
Backend PHP 8.1+
Backend Framework CodeIgniter 4 ^4.0
Database SQL Server 2016+
Frontend TailwindCSS Latest
Frontend Alpine.js Latest
UI Components DaisyUI Latest
Icons FontAwesome 7
Testing PHPUnit 10.5.16
Development Composer Latest

Architecture Classification

  • Architecture Pattern: MVC (Model-View-Controller)
  • Application Type: Backend Web Application
  • Project Type: Backend (PHP/CodeIgniter 4)
  • Entry Point: public/index.php

Core Modules

1. Dictionary Management

  • Departments (Dept): Manage department/category entries
  • Tests: Maintain test parameters and specifications
  • Controls: Configure control standards and limits

2. Data Entry

  • Daily Entry: Record daily QC test results
  • Monthly Entry: Aggregate monthly data and comments

3. Reporting

  • Generate quality control reports based on date ranges, test types, and control parameters

4. Comments System

  • Add notes and comments to results

Key Features

  • CRUD operations for departments, tests, and controls
  • Daily and monthly quality control data recording
  • Comment system for results annotation
  • Report generation and analysis
  • RESTful API endpoints for all modules
  • Responsive UI with modal-based interactions

Project Structure Overview

tinyqc/
├── app/
│   ├── Config/          # Configuration files
│   ├── Controllers/     # Application controllers
│   │   └── Api/         # API controllers
│   ├── Models/          # Database models
│   └── Views/           # View templates
├── public/              # Web root
├── tests/               # Unit tests
├── writable/            # Writable directory
├── _bmad/               # BMAD development artifacts
├── composer.json
└── phpunit.xml.dist

Quick Reference

Related Documentation