crm-summit/README.md

# CRM Summit

CRM Summit is a CodeIgniter 4 app for CRM, service, product, certificate, and support workflows.

## Main modules

- Auth and user management
- Dashboard
- Accounts, sites, offices, zones, and areas
- Products, product types, services, aliases, catalogs, and temp import flow
- Activities, emails, contacts, and mail groups
- Bugs and bug comments
- Certificates: maintenance, installation, training
- Guidebook and inventory counters/transactions
- Integrations and sync jobs for Figma and Gitea

## Tech stack

- PHP 8.1+
- CodeIgniter 4
- MySQL/MariaDB
- dompdf for PDF output
- endroid/qr-code for QR generation
- ramsey/uuid for UUID support

## Setup

1. Install dependencies:

```bash
composer install
```

2. Copy `env` to `.env` and set app and database values:

```bash
copy env .env
```

3. Set `app.baseURL` for local or production host.

4. Point web server to `public/` folder.

5. Run migrations if project uses them:

```bash
php spark migrate
```

## Development commands

```bash
php spark list
php spark cache:clear
php spark migrate
php spark migrate:rollback
vendor\bin\phpunit
```

## Notes

- `index.php` lives in `public/` for security.
- Check `app/Config/Routes.php` for module URLs and entry points.
- Use `app/Config/` and `.env` for environment-specific settings.