canina/.ai_agency/specs/architecture_spec.md

Architecture Specification

1. Single Non-Negotiable Tech Stack

• Language: TypeScript (strict mode)
• Backend Framework: Node.js / Express
• Frontend Framework: React / Next.js
• Database: PostgreSQL
• ORM: Prisma

2. Directory Structure Tree

.
├── src/
│   ├── controllers/
│   ├── routes/
│   ├── services/
│   └── models/
├── tests/
├── .ai_agency/
├── Dockerfile
├── docker-compose.yml
└── .env.example

3. State Management Strategy

• Centralized JSON-based persistence via .ai_agency/memory/state.json with atomic checkpointing and resume mode.

4. Deployment / Docker Architecture

• Multi-stage Docker builds with non-root user execution and isolated container networking.