type
concept
created
Mon Apr 06 2026 02:00:00 GMT+0200 (Central European Summer Time)
updated
Mon Apr 06 2026 02:00:00 GMT+0200 (Central European Summer Time)
sources
raw/notes/techContext, raw/notes/systemPatterns, raw/notes/project_unitcycle_demo_tech
tags
architecture infrastructure tech

Tech Stack

abstract
Angular 19 + Django 5 + DRF + PostgreSQL 17 + Node.js server.js. Served by PM2 behind Nginx at demo.unitcycle.com.

Architecture

[Angular 19 SPA] → [server.js :4400] → [PostgreSQL 17]
                         ↓ proxy
                  [Django DRF :3001]

Stack Details

Layer Tech Version
Frontend Angular (standalone components) 19.2
CSS Tailwind CSS + 208 CSS vars 4
Backend Django + DRF 5.x
Database PostgreSQL 17
Maps MapLibre GL JS 5
AI Claude API claude-sonnet-4-20250514
PDF LlamaParse —
Tests Playwright —

Frontend Patterns

Database

Infrastructure

Known Pitfalls

  1. server.js is fragile — agents overwrite it during delegated tasks
  2. Angular cache clearing (rm -rf .angular/cache) can cause full site outage
  3. PortalUser is the auth model, NOT Django's User
  4. *ngTemplateOutlet silently fails without NgTemplateOutlet in imports
  5. NEVER create Django app named collections — shadows stdlib

Sources

Related