# MokoSuiteConstruction

Construction project management for Joomla 6 — job costing, bids, change orders, RFIs, submittals, daily logs, AIA billing, subcontractors.

## Quick Reference

| Field | Value |
|---|---|
| **Package** | `pkg_mokosuiteconstruction` |
| **Layer** | 3 (requires: Client → CRM → ERP) |
| **Language** | PHP 8.3+ |
| **Branch** | develop on `dev`, merge to `main` (protected) |
| **Wiki** | [MokoSuiteConstruction Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteConstruction/wiki) |

## Architecture

Joomla **package** — Layer 3 add-on. ERP for job cost accounting, material management, and pricing. CRM contacts as owners, architects, subcontractors.

### Key Patterns
- CSI MasterFormat cost codes for budget structure
- AIA G702/G703 for progress billing
- Retention tracking with release milestones
- Lien waiver management (conditional/unconditional)

## Rules

- **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js`
- **Attribution**: `Authored-by: Moko Consulting`
- **Workflow directory**: `.mokogitea/`
- **Standards**: [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoCLI/wiki)
- **Changelog**: `[Unreleased]` only — release system assigns versions

## Coding Standards

- PHP 8.3+ / Joomla 6 patterns
- `$this->getDatabase()` in models, `Factory::getContainer()->get(DatabaseInterface::class)` in helpers
- `Factory::getApplication()->getIdentity()` for user
- `FOR UPDATE` inside transactions for concurrent cost code updates