Architecture

How UnitCycle is built: stack, database, patterns, workflows, and design system.

System Design

• wiki/concepts/tech-stack — Angular 19 + Django 5 + PostgreSQL 17 + server.js
• wiki/summaries/platform-blueprint — Full architecture: 147 tables, 4 portals, 35 Django apps
• wiki/summaries/system-patterns — Frontend/backend patterns, auth, AI integration

Detailed Architecture Specs (from unitcycle-blueprint.html)

• wiki/specs/architecture/system-overview — System overview & architecture
• wiki/specs/architecture/multi-portal-architecture — Multi-portal architecture
• wiki/specs/architecture/property-onboarding — Property onboarding
• wiki/specs/architecture/tenant-lifecycle — Tenant lifecycle
• wiki/specs/architecture/unit-lifecycle — Unit lifecycle & status management
• wiki/specs/architecture/leasing-pipeline — Leasing pipeline: vacant to leased
• wiki/specs/architecture/maintenance-work-orders — Maintenance & work orders
• wiki/specs/architecture/financial-management — Financial management
• wiki/specs/architecture/data-model-relationships — Data model & relationships

Routing

• wiki/concepts/slug-based-urls — Human-readable URLs: property slugs + unit numbers, no UUIDs
• wiki/concepts/units-page — Standalone units list at /units with server-side filtering

Wiki Infrastructure

• wiki/concepts/wiki-system — 3-layer wiki, MOC navigation, hooks, web server
• wiki/concepts/wiki-ai-search — LLM-powered search: query expansion, streaming answers, smart ranking

Database

• wiki/summaries/database-map — 254 tables, all relations, interactive schema (1.9MB)
• wiki/concepts/companion-table-pattern — How to extend managed=False Yardi tables

Detailed Database Specs (from unitcycle-database-map.html)

• wiki/specs/database/schema-overview — Database schema overview
• wiki/specs/database/core-tables — Core tables: full schema
• wiki/specs/database/financial-tables — Financial tables: full schema
• wiki/specs/database/ai-feature-tables — AI feature tables: full schema

Workflows & Processes

• wiki/summaries/workflow-tree — 46 steps mapped, 39 live, 7 gaps identified
• wiki/specs/workflows/full-workflow-tree — Detailed spec: 9 phases, 46 steps, 7 gaps

Design System

• wiki/concepts/navy-gold-branding — 208 CSS vars, 7 themes, gold=positive
• wiki/concepts/research-before-ui — Rafael's required workflow: research → comparison → pick

Maps

• wiki/summaries/map-comparison — MapLibre vs Leaflet vs deck.gl (chose Dots + Supercluster)
• wiki/summaries/map-showcase — 6 visualization models for the portfolio map

Knowledge Management

• wiki/concepts/wiki-system — LLM Wiki: Karpathy pattern, MOC navigation, 3 hooks, auto-evolution

Feature Spec

• wiki/summaries/feature-spec-v1 — 8 live modules, 7 screens, P0–P3 roadmap