siesa-agents 2.1.45 → 2.1.47

package/bmad/bmm/workflows/3-solutioning/create-architecture/data/company-standards/architecture-patterns.md

@@ -7,26 +7,34 @@
 
 ### Folder Structure
 
-Next.js 16 App Router Structure with Clean Architecture + DDD:
+Vite + TanStack Router Structure with Clean Architecture + DDD:
 
 ```
-├── app/                         # Next.js App Router directory
-│   ├── (dashboard)/            # Route groups for dashboard
-│   ├── sales/                  # Routes for sales module
-│   │   ├── quotes/             # Quote management pages
-│   │   └── invoices/           # Invoice pages
-│   ├── inventory/              # Inventory routes
-│   ├── globals.css             # Global styles
-│   ├── layout.tsx              # Root layout component
-│   ├── page.tsx               # Home page
-│   ├── loading.tsx            # Global loading UI
-│   └── not-found.tsx          # 404 page
-│
 ├── src/
-│   ├── modules/                # Business modules following DDD
-│   │   ├── sales/              # Sales module
-│   │   │   ├── quotes/         # Quote domain
-│   │   │   │   ├── cart/       # Shopping cart feature
+│   ├── main.tsx                     # React entry point
+│   ├── router.tsx                   # TanStack Router config
+│   ├── routeTree.gen.ts             # Auto-generated (DO NOT EDIT)
+│   ├── globals.css                  # Global styles + Tailwind
+│   │
+│   ├── routes/                      # TanStack Router file-based routing
+│   │   ├── __root.tsx               # Root layout (providers)
+│   │   ├── index.tsx                # Home redirect
+│   │   ├── _auth.tsx                # Public layout (pathless)
+│   │   ├── _auth/
+│   │   │   └── login.tsx            # /login
+│   │   ├── _app.tsx                 # Protected layout (pathless)
+│   │   └── _app/
+│   │       ├── dashboard.tsx        # /dashboard
+│   │       ├── sales/
+│   │       │   ├── quotes.tsx       # /sales/quotes
+│   │       │   └── invoices.tsx     # /sales/invoices
+│   │       └── inventory/
+│   │           └── products.tsx     # /inventory/products
+│   │
+│   ├── modules/                     # Business modules following DDD
+│   │   ├── sales/                   # Sales module
+│   │   │   ├── quotes/              # Quote domain
+│   │   │   │   ├── cart/            # Shopping cart feature
 │   │   │   │   │   ├── domain/
 │   │   │   │   │   │   ├── entities/
 │   │   │   │   │   │   ├── repositories/
@@ -41,29 +49,43 @@ Next.js 16 App Router Structure with Clean Architecture + DDD:
 │   │   │   │   │   │   ├── api/
 │   │   │   │   │   │   └── adapters/
 │   │   │   │   │   └── presentation/
-│   │   │   │   │       └── components/    # Only components, pages in app/
-│   │   │   │   └── products/              # Products feature
-│   │   │   └── billing/                   # Billing domain
-│   │   ├── inventory/                     # Inventory module
-│   │   └── users/                         # User module
+│   │   │   │   │       └── components/
+│   │   │   │   └── products/        # Products feature
+│   │   │   └── billing/             # Billing domain
+│   │   ├── inventory/               # Inventory module
+│   │   └── users/                   # User module
 │   │
 │   ├── shared/
-│   │   ├── components/         # Reusable UI components
-│   │   ├── hooks/              # Shared hooks
-│   │   ├── utils/              # Utility functions
-│   │   ├── types/              # Common TypeScript types
-│   │   └── constants/          # App constants
+│   │   ├── components/              # Reusable UI components
+│   │   │   └── ui/                  # shadcn/ui components
+│   │   ├── hooks/                   # Shared hooks
+│   │   ├── lib/                     # Utilities (utils.ts, api-client.ts)
+│   │   ├── types/                   # Common TypeScript types
+│   │   └── constants/               # App constants
 │   │
-│   ├── providers/              # React context providers
-│   ├── store/                  # Global Zustand stores
-│   └── middleware.ts           # Next.js middleware
+│   ├── app/                         # Global configuration
+│   │   ├── providers/               # React context providers
+│   │   └── store/                   # Global Zustand stores
+│   │
+│   └── infrastructure/              # Global external services
+│       ├── api/                     # API configuration
+│       ├── storage/                 # IndexedDB, localStorage
+│       └── pwa/                     # PWA configuration
 │
-├── lib/                        # Next.js utilities and configurations
-├── components/                 # Global UI components (alternative to src/shared)
-├── public/                     # Static assets and PWA manifest
-└── styles/                     # Additional stylesheets
+├── public/                          # Static assets and PWA manifest
+├── index.html                       # Vite entry point
+└── vite.config.ts                   # Vite + TanStack Router plugin config
 ```
 
+### TanStack Router Conventions
+
+| Prefix | Effect | Example |
+|--------|--------|---------|
+| `_` | Pathless layout (no URL segment) | `_app.tsx` → layout only |
+| `.` | Flat routing (nested without folders) | `orders.$id.tsx` → `/orders/:id` |
+| `-` | Ignored by router (colocated files) | `-components/` |
+| `$` | Dynamic parameter | `$orderId.tsx` → `:orderId` |
+
 ### Core Principles
 
 #### Clean Architecture First
@@ -71,7 +93,7 @@ Strict separation of:
 - **Domain layer** - Business entities, repositories interfaces, domain services, and types
 - **Application layer** - Use cases, hooks, and state management (Zustand stores)
 - **Infrastructure layer** - Repository implementations, API clients, and adapters
-- **Presentation layer** - UI components (pages go in `app/`, components in `presentation/`)
+- **Presentation layer** - UI components in `presentation/`, routes in `routes/`
 
 #### Domain-Driven Design
 Business logic drives architecture decisions. Organize by business modules and domains, not technical layers.
@@ -83,7 +105,7 @@ Build complex UIs from simple, reusable components.
 Leverage TypeScript for compile-time safety and developer experience.
 
 #### Performance by Design
-- Lazy loading
+- Lazy loading (automatic with TanStack Router)
 - Memoization
 - Bundle optimization
 
@@ -107,11 +129,11 @@ Use MCP to install Shadcn components instead of creating manually.
 
 ### Framework Selection Rules
 
-**Default**: Always use Next.js 16 with App Router unless explicitly told otherwise.
+**Default**: Always use Vite + TanStack Router with TypeScript.
 
-**Exceptions**: Only use pure React + Vite when user specifically mentions offline-first functionality or requests non-Next.js setup.
+**Microfrontends**: Use Vite + Module Federation for distributed architecture.
 
-**Reasoning**: Next.js provides better developer experience, built-in optimization, and easier deployment while maintaining PWA capabilities.
+**Reasoning**: Vite provides faster builds, TanStack Router offers type-safe routing, and the combination is prepared for microfrontends with Module Federation.
 
 ## Backend Architecture
 
@@ -388,9 +410,11 @@ app.MapScalarApiReference();  // NOT app.UseSwagger()
 ## Summary
 
 ### Frontend
-- **Framework**: Next.js 16 with TypeScript and App Router
+- **Bundler**: Vite 5+
+- **Router**: TanStack Router (file-based, type-safe)
+- **Framework**: React 18+ with TypeScript (strict mode)
 - **Architecture**: Clean Architecture + DDD
-- **State**: Zustand
+- **State**: Zustand (client) + TanStack Query (server)
 - **UI**: shadcn/ui + Radix UI + TailwindCSS v4
 - **Testing**: Vitest + React Testing Library
 - **Validation**: Zod + React Hook Form
@@ -412,4 +436,4 @@ app.MapScalarApiReference();  // NOT app.UseSwagger()
 3. **Test-Driven Development** - Tests before/alongside implementation
 4. **Database per Microservice** - Complete isolation between services
 5. **Type Safety** - TypeScript (frontend) and C# (backend) strong typing
-6. **Docker for Production** - Local development without containers
+6. **Docker for Production** - Local development without containers