Developer Guide - Enterprise Movement CRM Documentation                 [ Skip to main content ](#main-content)= 768) mobileMenu = false">  [  CP

  Combined
Perception

 ](https://crm.combinedperception.ai)

  [ Capabilities ](https://crm.combinedperception.ai/#features) [ Architecture ](https://crm.combinedperception.ai/#architecture) [ Guide ](https://crm.combinedperception.ai/guide) [ Contact ](https://crm.combinedperception.ai/contact)  [ Sign In ](https://crm.combinedperception.ai/login) [ Request Access ](https://crm.combinedperception.ai/contact)

  [  CP

  Combined
Perception

 ](https://crm.combinedperception.ai)

  [ Capabilities ](https://crm.combinedperception.ai/#features) [ Architecture ](https://crm.combinedperception.ai/#architecture) [ Guide ](https://crm.combinedperception.ai/guide) [ Contact ](https://crm.combinedperception.ai/contact)

  [ Sign In ](https://crm.combinedperception.ai/login) [ Request Access ](https://crm.combinedperception.ai/contact)

    Documentation
-----------------

 [ Getting Started ](https://crm.combinedperception.ai/docs/getting-started) [ Import Guide ](https://crm.combinedperception.ai/docs/import) [ Developer Guide ](https://crm.combinedperception.ai/docs/developer) [ Self-Hosting Guide ](https://crm.combinedperception.ai/docs/self-hosting) [ MCP Server ](https://crm.combinedperception.ai/docs/mcp) [ API Reference ](https://crm.combinedperception.ai/docs/api)

  [\#](#developer-guide "Permalink")Developer Guide
=================================================

Technical documentation for developers and contributors.

---

[\#](#quick-start "Permalink")Quick Start
-----------------------------------------

`git clone https://github.com/Relaticle/relaticle.gitcd relaticle && composer app-installcomposer run dev`Visit `http://localhost:8000` to access the application.

---

[\#](#tech-stack "Permalink")Tech Stack
---------------------------------------

ComponentTechnologyBackendPHP 8.4, Laravel 12Admin UIFilament 5FrontendLivewire 4, Alpine.js, Tailwind CSS 4DatabasePostgreSQLQueueLaravel HorizonTestingPest v4Static AnalysisPHPStan (Level 7)Code StyleLaravel Pint, RectorAuthLaravel Jetstream---

[\#](#architecture "Permalink")Architecture
-------------------------------------------

### [\#](#core-models "Permalink")Core Models

`Team ─┬─ User (via Membership)      ├─ Company ─┬─ People      │           └─ Opportunity ─── People      ├─ Task (many-to-many with Company, People, Opportunity)      └─ Note (many-to-many with Company, People, Opportunity)`### [\#](#multi-tenancy "Permalink")Multi-Tenancy

All workspace data is isolated via the `HasTeam` trait. Every query automatically scopes to the current team.

### [\#](#key-traits "Permalink")Key Traits

TraitPurpose`HasTeam`Workspace isolation`HasCreator`Tracks record creator`HasNotes`Polymorphic notes relationship`HasAiSummary`AI-generated summaries---

[\#](#development-setup "Permalink")Development Setup
-----------------------------------------------------

### [\#](#requirements "Permalink")Requirements

- **PHP 8.4+** with extensions: pdo\_pgsql, gd, bcmath, mbstring, xml
- **PostgreSQL 17+**
- **Node.js 20+**
- **Composer 2+**

### [\#](#manual-installation "Permalink")Manual Installation

`git clone https://github.com/Relaticle/relaticle.gitcd relaticlecomposer installnpm installcp .env.example .envphp artisan key:generatephp artisan migratephp artisan storage:linknpm run buildcomposer run dev`### [\#](#environment-config "Permalink")Environment Config

For PostgreSQL:

`DB_CONNECTION=pgsqlDB_HOST=127.0.0.1DB_PORT=5432DB_DATABASE=relaticleDB_USERNAME=postgresDB_PASSWORD=your_password`---

[\#](#quality-tools "Permalink")Quality Tools
---------------------------------------------

`composer lint          # Format with Pint + Rectorcomposer test:lint     # Check formattingcomposer test:types    # PHPStan analysiscomposer test:pest     # Run testscomposer test          # All checks (required before PR)`### [\#](#git-hooks "Permalink")Git Hooks

Enable pre-commit checks:

`git config core.hooksPath .githooks`---

[\#](#testing "Permalink")Testing
---------------------------------

All contributions require:

- Unit tests for new functionality
- Feature tests for user interactions
- Minimum 99.9% type coverage

Run specific tests:

`php artisan test tests/Feature/ExampleTest.phpphp artisan test --filter="test_method_name"`---

[\#](#custom-fields "Permalink")Custom Fields
---------------------------------------------

Relaticle includes a custom fields system for extending entities without migrations.

- **License**: AGPL-3.0 (free for open source) or Commercial
- **Docs**: [Custom Fields Documentation](https://relaticle.github.io/custom-fields/)

---

[\#](#deployment "Permalink")Deployment
---------------------------------------

For production deployment instructions, including Docker setup, environment configuration, reverse proxy, and platform-specific guides (Dokploy, Coolify), see the **Self-Hosting Guide**.

---

[\#](#troubleshooting "Permalink")Troubleshooting
-------------------------------------------------

IssueSolutionQueue not processing`php artisan queue:restart`File upload errors`chmod -R 775 storage bootstrap/cache`Slow queriesUse Laravel Telescope to identify, then add indexesView cache issues`php artisan view:clear && npm run build`---

[\#](#contributing "Permalink")Contributing
-------------------------------------------

1. Fork the repository
2. Create a feature branch: `git checkout -b feat/your-feature`
3. Make changes following coding standards
4. Run tests: `composer test`
5. Commit with conventional messages
6. Open a Pull Request

PRs must pass all checks before merge.

---

[\#](#resources "Permalink")Resources
-------------------------------------

- [Laravel Docs](https://laravel.com/docs/12.x)
- [Filament Docs](https://filamentphp.com/docs)
- [Livewire Docs](https://livewire.laravel.com/)
- [Pest Docs](https://pestphp.com/)

 [  Edit this page on GitHub ](https://github.com/Relaticle/relaticle/edit/main/packages/Documentation/resources/markdown/developer-guide.md)

  ###    On this page

 - [ Quick Start ](#quick-start)
- [ Tech Stack ](#tech-stack)
- [ Architecture ](#architecture)
- [ Development Setup ](#development-setup)
- [ Quality Tools ](#quality-tools)
- [ Testing ](#testing)
- [ Custom Fields ](#custom-fields)
- [ Deployment ](#deployment)
- [ Troubleshooting ](#troubleshooting)
- [ Contributing ](#contributing)
- [ Resources ](#resources)

  [  CP

  Combined
Perception

 ](https://crm.combinedperception.ai) AI-native CRM for enterprise teams. Manage relationships and let AI agents operate your data in real time.

 [  ](https://github.com/combinedperception) [  ](https://linkedin.com/company/combined-perception)

###  Quick Links

- [ Home ](https://crm.combinedperception.ai)
- [ Capabilities ](https://crm.combinedperception.ai/#features)
- [ Architecture ](https://crm.combinedperception.ai/#architecture)

###  Support & Legal

- [ Privacy Policy ](https://crm.combinedperception.ai/privacy-policy)
- [ Terms of Service ](https://crm.combinedperception.ai/terms-of-service)
- [ Contact Us ](https://crm.combinedperception.ai/contact)

© 2026 Combined Perception. All rights reserved.

 Built on the foundations of [ Relaticle ](https://github.com/relaticle/relaticle) open-source (AGPL-3.0).