docs: update README with project overview and channels

2026-06-21 23:23:06 +00:00
parent 2c0162e742
commit 582256dafc
1 changed files with 16 additions and 59 deletions
@@ -1,70 +1,27 @@
-# Template-Joomla
+# MokoSuite Support

-Unified scaffolding templates for all Joomla extension types.
+Live chat and multi-channel customer support for Joomla 6 — website chat, Facebook Messenger, WhatsApp, Instagram, email. Unified agent inbox.

-## Structure
+**Standalone** — works without MokoSuite. Optional CRM integration for contact linking and ticket escalation.

-```
-.gitea/workflows/     ← Standard 10-workflow CI/CD suite
-types/
-  plugin/             ← Joomla plugin scaffold
-  template/           ← Joomla site template scaffold (full src/)
-  module/             ← Joomla module scaffold
-  component/          ← Joomla component scaffold
-  package/            ← Joomla package scaffold
-  library/            ← Joomla library scaffold
-```
+## Channels

-## Usage
+Website Chat · Facebook Messenger · WhatsApp Business · Instagram Direct (planned) · Email IMAP (planned)

-1. Create a new repo from this template (or clone manually)
-2. Copy the relevant `types/<type>/` content to your project root
-3. Customize the manifest XML, namespace, and source files
-4. Workflows are already configured — push to trigger CI
+## Features

-## Shared Files
+- **Conversations** — unified inbox, assign, close with CSAT
+- **Agents** — auto-assign (least-busy), performance metrics
+- **Canned Responses** — quick replies, search, categories
+- **Webhooks** — Facebook + WhatsApp inbound with conversation continuity
+- **CSAT** — satisfaction scoring, by-channel, weekly trends

-The root contains files shared by all extension types:
- `.gitea/workflows/` — CI/CD (auto-release, ci-joomla, pr-check, etc.)
- `.editorconfig`, `.gitignore`, `.gitattributes` — editor/git config
- `composer.json`, `phpstan.neon`, `Makefile` — build tooling
- `updates.xml` — Joomla update server manifest template
- `LICENSE`, `SECURITY.md`, `CONTRIBUTING.md` — standard docs
+## Helpers (5)

-## Workflow Suite (10 workflows)
+`ConversationHelper` · `AgentHelper` · `CannedResponseHelper` · `WebhookChannelHelper` · `CsatHelper`

-| Workflow | Purpose |
-|----------|---------|
-| `auto-release.yml` | Stable release on PR merge to main |
-| `pre-release.yml` | Manual dev/alpha/beta/rc builds |
-| `ci-joomla.yml` | PHP lint, PHPStan, coding standards |
-| `pr-check.yml` | PR gate: manifest + build validation |
-| `deploy-manual.yml` | Manual SFTP deploy |
-| `repo-health.yml` | Structure compliance checks |
-| `update-server.yml` | updates.xml validation |
-| `security-audit.yml` | Dependency vulnerability scanning |
-| `notify.yml` | ntfy notifications |
-| `cleanup.yml` | Merged branch + old run cleanup |
+## Links

-## Version Policy
+- [Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteSupport/wiki) · [Issues](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteSupport/issues) · [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteSupport/releases)

- **Stable** (PR merge to main): Minor bump (`03.00.07` -> `03.01.00`)
- **Pre-release** (manual): Patch bump (`03.00.07` -> `03.00.08`)
-
-## Release Cascade
-
-Higher releases auto-delete lower pre-release channels:
- stable -> all | rc -> beta,alpha,dev | beta -> alpha,dev | alpha -> dev
-
-## Platform Type
-
-`.mokostandards` platform: `joomla-template` or `waas-component`
-
-## Canonical Source
-
-This repo is the **single source of truth** for Joomla workflows and scaffolding.
-Sync to production repos by copying `.gitea/workflows/` from here.
-
-## License
-
-GPL-3.0-or-later - Moko Consulting
+GPL-3.0-or-later · Copyright © 2026 [Moko Consulting](https://mokoconsulting.tech)