# Deucalion

> Deucalion is a professional compliance platform for UK smoke control and fire damper engineers. It combines a React Native field app, a React-based admin portal, AI-assisted report tooling, and a TypeScript/Express backend for managing sites, inspections, defects, quotes, work orders, and compliance evidence.

The platform surfaces three distinct audiences: field engineers on mobile, office admins in the portal, and platform operators. Public customer-facing documentation is at `/docs-site/content/docs/`. Internal engineering and product documentation is in `/docs/`.

## Documentation

- [README](README.md): Platform overview, architecture map, tech stack, and local setup guide
- [Contributing Guide](CONTRIBUTING.md): Branch strategy, PR workflow, and contribution standards
- [Security Policy](SECURITY.md): Responsible disclosure and supported versions
- [Agents Guide](AGENTS.md): Instructions for AI agents working in this repository
- [Claude Instructions](CLAUDE.md): Claude-specific coding and workflow guidance
- [Admin and Native App Guide](docs/ADMIN_PORTAL_AND_NATIVE_APP_GUIDE.md): Comprehensive guide to admin portal and mobile app architecture

## Public Docs Site Content

- [Admin Quickstart](docs-site/content/docs/admin/quickstart.mdx): Get an office team live with workspace access, sites, scheduling, and outputs
- [Sites, Systems, and Assets](docs-site/content/docs/admin/sites-systems-assets.mdx): Estate register structure, staged imports, and export preparation
- [Scheduling, Inspections, and Defects](docs-site/content/docs/admin/scheduling-inspections-defects.mdx): Office control desk, inspection review, and defect remediation flow
- [Scheduler Daily Operations](docs-site/content/docs/admin/scheduler-daily-operations.mdx): Backlog, field-resource eligibility, planner surfaces, and deployment discipline
- [Collaboration, Notifications, and Activity Feed](docs-site/content/docs/admin/collaboration-activity-and-notifications.mdx): Notification bell, Activity Feed filters, and server-enforced access rules
- [Customers, Quotes, Work Orders, and Finance](docs-site/content/docs/admin/customers-quotes-work-orders-finance.mdx): CRM-to-commercial follow-on flow
- [Customer SLAs and Service Policies](docs-site/content/docs/admin/customer-sla-and-service-policies.mdx): Reusable SLA templates and account-level snapshots
- [Finance, Receivables, and Billing](docs-site/content/docs/admin/finance-receivables-and-billing.mdx): Receivables, invoices, and workspace billing
- [Reports, Exports, and Integrations](docs-site/content/docs/admin/reports-exports-integrations.mdx): Staged CSV imports, report generation, and connected-system observability
- [Engineer Quickstart](docs-site/content/docs/engineer/quickstart.mdx): Open the day run, enter site context, start a visit
- [Day Run, Sites, and Briefings](docs-site/content/docs/engineer/day-run-sites-and-briefings.mdx): Pre-visit preparation from dashboard and site detail
- [Running Inspections](docs-site/content/docs/engineer/running-inspections.mdx): Assets, checklist items, defects, and visit notes in the field
- [Evidence, Sign-off, and Certificates](docs-site/content/docs/engineer/evidence-signoff-and-certificates.mdx): Photos, signatures, and certificate review before sharing
- [Fire Damper and PDS Workflows](docs-site/content/docs/engineer/fire-dampers-and-pds.mdx): Specialist drop-test and PDS recording flows
- [Offline Work, Sync, Search, and Settings](docs-site/content/docs/engineer/offline-sync-search-and-settings.mdx): Offline confidence, sync tools, and feature-availability checks
- [Statuses, Roles, and System Types Reference](docs-site/content/docs/reference/statuses-roles-and-system-types.mdx): Canonical definitions for roles, inspection statuses, system types, and collaboration event types
- [How Collaboration and Access Works](docs-site/content/docs/explanation/collaboration-and-access-model.mdx): Understanding-oriented explanation of server-enforced role gates, notification ownership, and structured event types
- [Troubleshooting Common Issues](docs-site/content/docs/troubleshooting/common-issues.mdx): Symptom-based fixes for access, sync, imports, exports, and collaboration problems

## Engineering Specifications

- [Master Roadmap](docs/audits/MASTER-ROADMAP.md): Product and engineering roadmap
- [Brand Specification](docs/brand-spec.md): Visual identity and brand standards
- [Integration Strategy](docs/INTEGRATION_STRATEGY.md): Third-party integration architecture and decisions
- [Security Audit](docs/audits/security-audit.md): Security posture and hardening notes
- [Public Doc Impact Audit](docs-site/audits/public-doc-impact-2026-04.md): Rolling log of which merged PRs required public-doc updates

## Configuration

- [App Config](app.config.js): Expo application configuration
- [Server Routes Index](server/routes/index.ts): Express route registration and access-control boundaries
- [Drizzle Config](drizzle.config.ts): Database schema and migration configuration
- [Railway Config](railway.json): Production deployment configuration

## Optional

- [Code Quality Audit](docs/audits/code-quality-audit.md): Code quality findings and remediation notes
- [Accessibility Audit](docs/audits/accessibility-audit.md): Accessibility review findings
- [Performance Audit](docs/audits/performance-audit.md): Performance profiling and recommendations
- [Launch Readiness Audit](docs/audits/2026-04-12-dual-path-launch-readiness.md): Pre-launch readiness assessment