Architecture Overview
obeliOmed is built as a plugin suite layered on top of FacturaScripts, an open-source PHP ERP. All 17 plugins share a common multi-tenant foundation and communicate through well-defined contracts rather than direct imports.
Ecosystem diagram
Key architectural decisions
| Topic | Decision | ADR |
|---|---|---|
| Naming convention | Hybrid: obelio_<plugin>_<entity> tables, PascalCase PHP, English | ADR-018 |
| Plugin rename | OftalmolAgenda->ObelioScheduling, Oftalmol->ObelioOphthalmology, OftalmolBase->ObelioCore | ADR-025 |
| Constraint naming | pk_/fk_/uq_/idx_ suffixes on all DB constraints | ADR-027 |
| Versioning | CalVer AAMMDD.NN | ADR-028 |
| Branch strategy | NNN-description off develop | ADR-029 |
| Merge authority | Only Javi merges to develop/main | ADR-032 |
| Multi-tenant | idEmpresa + codalmacen as clinic center | ADR-033 |
| Admin config | All settings in obelio_<plugin>_settings, no hardcoding | ADR-034 |