BMAD-METHOD/bmad/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md

# Solution Architecture Document

**Project:** {{project_name}}
**Date:** {{date}}
**Author:** {{user_name}}

## Executive Summary

{{executive_summary}}

## 1. Technology Stack and Decisions

### 1.1 Technology and Library Decision Table

| Category         | Technology     | Version                | Justification                |
| ---------------- | -------------- | ---------------------- | ---------------------------- |
| Framework        | {{framework}}  | {{framework_version}}  | {{framework_justification}}  |
| Language         | {{language}}   | {{language_version}}   | {{language_justification}}   |
| Database         | {{database}}   | {{database_version}}   | {{database_justification}}   |
| Authentication   | {{auth}}       | {{auth_version}}       | {{auth_justification}}       |
| Hosting          | {{hosting}}    | {{hosting_version}}    | {{hosting_justification}}    |
| State Management | {{state_mgmt}} | {{state_mgmt_version}} | {{state_mgmt_justification}} |
| Styling          | {{styling}}    | {{styling_version}}    | {{styling_justification}}    |
| Testing          | {{testing}}    | {{testing_version}}    | {{testing_justification}}    |

{{additional_tech_stack_rows}}

## 2. Application Architecture

### 2.1 Architecture Pattern

{{architecture_pattern_description}}

### 2.2 Server-Side Rendering Strategy

{{ssr_strategy}}

### 2.3 Page Routing and Navigation

{{routing_navigation}}

### 2.4 Data Fetching Approach

{{data_fetching}}

## 3. Data Architecture

### 3.1 Database Schema

{{database_schema}}

### 3.2 Data Models and Relationships

{{data_models}}

### 3.3 Data Migrations Strategy

{{migrations_strategy}}

## 4. API Design

### 4.1 API Structure

{{api_structure}}

### 4.2 API Routes

{{api_routes}}

### 4.3 Form Actions and Mutations

{{form_actions}}

## 5. Authentication and Authorization

### 5.1 Auth Strategy

{{auth_strategy}}

### 5.2 Session Management

{{session_management}}

### 5.3 Protected Routes

{{protected_routes}}

### 5.4 Role-Based Access Control

{{rbac}}

## 6. State Management

### 6.1 Server State

{{server_state}}

### 6.2 Client State

{{client_state}}

### 6.3 Form State

{{form_state}}

### 6.4 Caching Strategy

{{caching_strategy}}

## 7. UI/UX Architecture

### 7.1 Component Structure

{{component_structure}}

### 7.2 Styling Approach

{{styling_approach}}

### 7.3 Responsive Design

{{responsive_design}}

### 7.4 Accessibility

{{accessibility}}

## 8. Performance Optimization

### 8.1 SSR Caching

{{ssr_caching}}

### 8.2 Static Generation

{{static_generation}}

### 8.3 Image Optimization

{{image_optimization}}

### 8.4 Code Splitting

{{code_splitting}}

## 9. SEO and Meta Tags

### 9.1 Meta Tag Strategy

{{meta_tag_strategy}}

### 9.2 Sitemap

{{sitemap}}

### 9.3 Structured Data

{{structured_data}}

## 10. Deployment Architecture

### 10.1 Hosting Platform

{{hosting_platform}}

### 10.2 CDN Strategy

{{cdn_strategy}}

### 10.3 Edge Functions

{{edge_functions}}

### 10.4 Environment Configuration

{{environment_config}}

## 11. Component and Integration Overview

### 11.1 Major Modules

{{major_modules}}

### 11.2 Page Structure

{{page_structure}}

### 11.3 Shared Components

{{shared_components}}

### 11.4 Third-Party Integrations

{{third_party_integrations}}

## 12. Architecture Decision Records

{{architecture_decisions}}

**Key decisions:**

- Why this framework? {{framework_decision}}
- SSR vs SSG? {{ssr_vs_ssg_decision}}
- Database choice? {{database_decision}}
- Hosting platform? {{hosting_decision}}

## 13. Implementation Guidance

### 13.1 Development Workflow

{{development_workflow}}

### 13.2 File Organization

{{file_organization}}

### 13.3 Naming Conventions

{{naming_conventions}}

### 13.4 Best Practices

{{best_practices}}

## 14. Proposed Source Tree

```
{{source_tree}}
```

**Critical folders:**

- {{critical_folder_1}}: {{critical_folder_1_description}}
- {{critical_folder_2}}: {{critical_folder_2_description}}
- {{critical_folder_3}}: {{critical_folder_3_description}}

## 15. Testing Strategy

### 15.1 Unit Tests

{{unit_tests}}

### 15.2 Integration Tests

{{integration_tests}}

### 15.3 E2E Tests

{{e2e_tests}}

### 15.4 Coverage Goals

{{coverage_goals}}

{{testing_specialist_section}}

## 16. DevOps and CI/CD

{{devops_section}}

{{devops_specialist_section}}

## 17. Security

{{security_section}}

{{security_specialist_section}}

---

## Specialist Sections

{{specialist_sections_summary}}

---

_Generated using BMad Method Solution Architecture workflow_