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