# skygreen2001/betterlife architecture

> Architecture diagram of the GitHub repository skygreen2001/betterlife, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skygreen2001/betterlife
- Repository: https://github.com/skygreen2001/betterlife

## Overview

Betterlife is a PHP full-stack web framework and application suite: it combines public and administrative web apps, JSON APIs, reusable framework services, and developer-facing generation and operations tools. The main documented workflow is a user request entering a web app, being handled through the framework, and producing a rendered page or API response; domain services and database access support application work. The README also identifies code generation, reporting, Redis monitoring, and database operations as distinct capabilities. Some subsystem links below are documented rather than verified against unsampled implementation.

Main entry points: [`home/admin/action`](https://github.com/skygreen2001/betterlife/tree/master/home/admin/action) (Admin App), [`core/db/ManagerDb.php`](https://github.com/skygreen2001/betterlife/blob/master/core/db/ManagerDb.php) (Database Manager), [`init.php`](https://github.com/skygreen2001/betterlife/blob/master/init.php) (PHP Entry), [`core/autocode/AutoCodeService.php`](https://github.com/skygreen2001/betterlife/blob/master/core/autocode/AutoCodeService.php) (Code Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Applications"]
  node_adminapp["Admin App"]
  node_siteapp["Betterlife Site"]
  node_reportapp["Report App"]
end

subgraph group_framework["Framework Runtime"]
  node_entry["PHP Entry<br/>[init.php]"]
  node_runtime["Request Runtime<br/>[Application.php]"]
  node_router["Router<br/>[Router.php]"]
  node_initializer["Initializer<br/>[Initializer.php]"]
  node_config["Configuration<br/>[ConfigDb.php]"]
  node_logger["Logging<br/>[LogMe.php]"]
  node_utilities["Framework Utilities"]
end

subgraph group_data["Domain And Data"]
  node_blog["Blog Domain<br/>[Blog.php]"]
  node_services["Application Services<br/>[Service.php]"]
  node_servicebasic["Domain Service Base<br/>[ServiceBasic.php]"]
  node_dataobject["Data Objects<br/>[DataObject.php]"]
  node_sqlbuilder["SQL Builder<br/>[CrudSQL.php]"]
  node_dbmanager["Database Manager<br/>[ManagerDb.php]"]
  node_database[("Configured Database")]
end

subgraph group_tools["Developer Tools"]
  node_autocode["Code Generator"]
  node_reporting["Report Services"]
  node_dbops["Database Tools"]
end

subgraph group_clients["Clients And APIs"]
  node_mobileclient["HTML5 Client"]
  node_redisclient["Redis Monitor<br/>[main.js]"]
  node_api["JSON APIs"]
end

node_visitor(("Web User"))

node_visitor -.->|"requests pages"| node_siteapp
node_visitor -.->|"uses management"| node_adminapp
node_siteapp -.->|"enters framework"| node_entry
node_adminapp -.->|"enters framework"| node_entry
node_reportapp -.->|"enters framework"| node_entry
node_mobileclient -.->|"requests JSON"| node_api
node_entry -->|"loads"| node_initializer
node_runtime -->|"routes requests"| node_router
node_runtime -->|"loads config"| node_config
node_router -->|"initializes"| node_initializer
node_adminapp -.->|"generates code"| node_autocode
node_reportapp -.->|"runs reports"| node_reporting
node_redisclient -.->|"monitors Redis"| node_api
node_adminapp -.->|"uses operations tools"| node_dbops
node_services -->|"accesses database"| node_dbmanager
node_servicebasic -->|"delegates queries"| node_dataobject
node_servicebasic -->|"uses query filters"| node_sqlbuilder
node_dbmanager -->|"selects driver"| node_config
node_dbmanager -.->|"connects"| node_database
node_dataobject -.->|"persists data"| node_dbmanager
node_services -.->|"serves domain"| node_blog
node_logger -->|"uses helpers"| node_utilities
node_autocode -->|"writes generated files"| node_utilities
node_autocode -->|"supports previews"| node_reporting

click node_adminapp "https://github.com/skygreen2001/betterlife/tree/master/home/admin/action"
click node_siteapp "https://github.com/skygreen2001/betterlife/tree/master/home/betterlife/action"
click node_reportapp "https://github.com/skygreen2001/betterlife/tree/master/home/report/action"
click node_mobileclient "https://github.com/skygreen2001/betterlife/tree/master/app/html5/src/js"
click node_redisclient "https://github.com/skygreen2001/betterlife/blob/master/app/redis/js/main.js"
click node_api "https://github.com/skygreen2001/betterlife/tree/master/api"
click node_entry "https://github.com/skygreen2001/betterlife/blob/master/init.php"
click node_runtime "https://github.com/skygreen2001/betterlife/blob/master/core/main/Application.php"
click node_router "https://github.com/skygreen2001/betterlife/blob/master/core/main/Router.php"
click node_initializer "https://github.com/skygreen2001/betterlife/blob/master/core/main/Initializer.php"
click node_config "https://github.com/skygreen2001/betterlife/blob/master/core/config/config/ConfigDb.php"
click node_autocode "https://github.com/skygreen2001/betterlife/blob/master/core/autocode/AutoCodeService.php"
click node_reporting "https://github.com/skygreen2001/betterlife/blob/master/home/report/src/services/ServiceReportone.php"
click node_dbops "https://github.com/skygreen2001/betterlife/tree/master/tools/tools/db"
click node_blog "https://github.com/skygreen2001/betterlife/blob/master/home/betterlife/src/domain/core/Blog.php"
click node_services "https://github.com/skygreen2001/betterlife/blob/master/core/model/service/Service.php"
click node_servicebasic "https://github.com/skygreen2001/betterlife/blob/master/core/model/service/ServiceBasic.php"
click node_dataobject "https://github.com/skygreen2001/betterlife/blob/master/core/model/DataObject.php"
click node_sqlbuilder "https://github.com/skygreen2001/betterlife/blob/master/core/db/sql/util/CrudSQL.php"
click node_dbmanager "https://github.com/skygreen2001/betterlife/blob/master/core/db/ManagerDb.php"
click node_logger "https://github.com/skygreen2001/betterlife/blob/master/core/system/log/LogMe.php"
click node_utilities "https://github.com/skygreen2001/betterlife/tree/master/core/util"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_adminapp,node_siteapp,node_reportapp,node_visitor toneBlue
class node_entry,node_runtime,node_router,node_initializer,node_config,node_logger,node_utilities toneAmber
class node_blog,node_services,node_servicebasic,node_dataobject,node_sqlbuilder,node_dbmanager,node_database toneMint
class node_autocode,node_reporting,node_dbops toneRose
class node_mobileclient,node_redisclient,node_api toneIndigo
```

## Components

### Web Applications

- [Admin App](https://github.com/skygreen2001/betterlife/tree/master/home/admin/action): `home/admin/action`
- [Betterlife Site](https://github.com/skygreen2001/betterlife/tree/master/home/betterlife/action): `home/betterlife/action`
- [Report App](https://github.com/skygreen2001/betterlife/tree/master/home/report/action): `home/report/action`

### Framework Runtime

- [PHP Entry](https://github.com/skygreen2001/betterlife/blob/master/init.php): `init.php`
- [Request Runtime](https://github.com/skygreen2001/betterlife/blob/master/core/main/Application.php): `core/main/Application.php`
- [Router](https://github.com/skygreen2001/betterlife/blob/master/core/main/Router.php): `core/main/Router.php`
- [Initializer](https://github.com/skygreen2001/betterlife/blob/master/core/main/Initializer.php): `core/main/Initializer.php`
- [Configuration](https://github.com/skygreen2001/betterlife/blob/master/core/config/config/ConfigDb.php): `core/config/config/ConfigDb.php`
- [Logging](https://github.com/skygreen2001/betterlife/blob/master/core/system/log/LogMe.php): `core/system/log/LogMe.php`
- [Framework Utilities](https://github.com/skygreen2001/betterlife/tree/master/core/util): `core/util`

### Domain And Data

- [Blog Domain](https://github.com/skygreen2001/betterlife/blob/master/home/betterlife/src/domain/core/Blog.php): `home/betterlife/src/domain/core/Blog.php`
- [Application Services](https://github.com/skygreen2001/betterlife/blob/master/core/model/service/Service.php): `core/model/service/Service.php`
- [Domain Service Base](https://github.com/skygreen2001/betterlife/blob/master/core/model/service/ServiceBasic.php): `core/model/service/ServiceBasic.php`
- [Data Objects](https://github.com/skygreen2001/betterlife/blob/master/core/model/DataObject.php): `core/model/DataObject.php`
- [SQL Builder](https://github.com/skygreen2001/betterlife/blob/master/core/db/sql/util/CrudSQL.php): `core/db/sql/util/CrudSQL.php`
- [Database Manager](https://github.com/skygreen2001/betterlife/blob/master/core/db/ManagerDb.php): `core/db/ManagerDb.php`
- **Configured Database**

### Developer Tools

- [Code Generator](https://github.com/skygreen2001/betterlife/blob/master/core/autocode/AutoCodeService.php): `core/autocode/AutoCodeService.php`
- [Report Services](https://github.com/skygreen2001/betterlife/blob/master/home/report/src/services/ServiceReportone.php): `home/report/src/services/ServiceReportone.php`
- [Database Tools](https://github.com/skygreen2001/betterlife/tree/master/tools/tools/db): `tools/tools/db`

### Clients And APIs

- [HTML5 Client](https://github.com/skygreen2001/betterlife/tree/master/app/html5/src/js): `app/html5/src/js`
- [Redis Monitor](https://github.com/skygreen2001/betterlife/blob/master/app/redis/js/main.js): `app/redis/js/main.js`
- [JSON APIs](https://github.com/skygreen2001/betterlife/tree/master/api): `api`

### Other components

- **Web User**

## Connections

- Web User → Betterlife Site: requests pages (evidence: `README.md`)
- Web User → Admin App: uses management (evidence: `README.md`)
- Betterlife Site → PHP Entry: enters framework (evidence: `README.md`)
- Admin App → PHP Entry: enters framework (evidence: `README.md`)
- Report App → PHP Entry: enters framework (evidence: `README.md`)
- HTML5 Client → JSON APIs: requests JSON (evidence: `README.md`)
- PHP Entry → Initializer: loads (evidence: `init.php`)
- Request Runtime → Router: routes requests (evidence: `core/main/Application.php`)
- Request Runtime → Configuration: loads config (evidence: `core/main/Application.php`)
- Router → Initializer: initializes (evidence: `core/main/Router.php`)
- Admin App → Code Generator: generates code (evidence: `README.md`)
- Report App → Report Services: runs reports (evidence: `README.md`)
- Redis Monitor → JSON APIs: monitors Redis (evidence: `README.md`)
- Admin App → Database Tools: uses operations tools (evidence: `README.md`)
- Application Services → Database Manager: accesses database (evidence: `core/model/service/Service.php`)
- Domain Service Base → Data Objects: delegates queries (evidence: `core/model/service/ServiceBasic.php`)
- Domain Service Base → SQL Builder: uses query filters (evidence: `core/model/service/ServiceBasic.php`)
- Database Manager → Configuration: selects driver (evidence: `core/db/ManagerDb.php`)
- Database Manager → Configured Database: connects (evidence: `core/db/ManagerDb.php`)
- Data Objects → Database Manager: persists data
- Application Services → Blog Domain: serves domain (evidence: `home/admin/src/services/ServiceBlog.php`)
- Logging → Framework Utilities: uses helpers (evidence: `core/system/log/LogMe.php`)
- Code Generator → Framework Utilities: writes generated files (evidence: `core/autocode/AutoCodeService.php`)
- Code Generator → Report Services: supports previews
