# System Architecture: {{project_name}}

**Date:** {{date}}
**Architect:** {{user_name}}
**Version:** 1.0
**Project Type:** {{project_type}}
**Project Level:** {{project_level}}
**Status:** Draft

---

## Document Overview

This document defines the system architecture for {{project_name}}. It provides the technical blueprint for implementation, addressing all functional and non-functional requirements from the PRD.

**Related Documents:**

- Product Requirements Document: {{prd_path}}
- Product Brief: {{product_brief_path}}

---

## Executive Summary

{{executive_summary}}

---

## Architectural Drivers

These requirements heavily influence architectural decisions:

{{architectural_drivers}}

---

## System Overview

### High-Level Architecture

{{high_level_architecture}}

### Architecture Diagram

{{architecture_diagram}}

### Architectural Pattern

**Pattern:** {{architectural_pattern}}

**Rationale:** {{pattern_rationale}}

---

## Technology Stack

### Frontend

{{frontend_stack}}

### Backend

{{backend_stack}}

### Database

{{database_stack}}

### Infrastructure

{{infrastructure_stack}}

### Third-Party Services

{{third_party_services}}

### Development & Deployment

{{dev_deployment_stack}}

---

## System Components

{{system_components}}

---

## Data Architecture

### Data Model

{{data_model}}

### Database Design

{{database_design}}

### Data Flow

{{data_flow}}

---

## API Design

### API Architecture

{{api_architecture}}

### Endpoints

{{api_endpoints}}

### Authentication & Authorization

{{api_auth}}

---

## Non-Functional Requirements Coverage

### NFR-001: {{nfr_001_name}}

**Requirement:** {{nfr_001_requirement}}

**Architecture Solution:** {{nfr_001_solution}}

---

{{additional_nfrs}}

---

## Security Architecture

### Authentication

{{auth_design}}

### Authorization

{{authz_design}}

### Data Encryption

{{encryption_design}}

### Security Best Practices

{{security_practices}}

---

## Scalability & Performance

### Scaling Strategy

{{scaling_strategy}}

### Performance Optimization

{{performance_optimization}}

### Caching Strategy

{{caching_strategy}}

### Load Balancing

{{load_balancing}}

---

## Reliability & Availability

### High Availability Design

{{ha_design}}

### Disaster Recovery

{{dr_design}}

### Backup Strategy

{{backup_strategy}}

### Monitoring & Alerting

{{monitoring_alerting}}

---

## Integration Architecture

### External Integrations

{{external_integrations}}

### Internal Integrations

{{internal_integrations}}

### Message/Event Architecture (if applicable)

{{messaging_architecture}}

---

## Development Architecture

### Code Organization

{{code_organization}}

### Module Structure

{{module_structure}}

### Testing Strategy

{{testing_strategy}}

### CI/CD Pipeline

{{cicd_pipeline}}

---

## Deployment Architecture

### Environments

{{environments}}

### Deployment Strategy

{{deployment_strategy}}

### Infrastructure as Code

{{iac}}

---

## Requirements Traceability

### Functional Requirements Coverage

{{fr_traceability}}

### Non-Functional Requirements Coverage

{{nfr_traceability}}

---

## Trade-offs & Decision Log

{{tradeoffs}}

---

## Open Issues & Risks

{{open_issues}}

---

## Assumptions & Constraints

{{assumptions}}

---

## Future Considerations

{{future_considerations}}

---

## Approval & Sign-off

**Review Status:**

- [ ] Technical Lead
- [ ] Product Owner
- [ ] Security Architect (if applicable)
- [ ] DevOps Lead

---

## Revision History

| Version | Date     | Author        | Changes              |
| ------- | -------- | ------------- | -------------------- |
| 1.0     | {{date}} | {{user_name}} | Initial architecture |

---

## Next Steps

### Phase 4: Sprint Planning & Implementation

Run `/sprint-planning` to:

- Break epics into detailed user stories
- Estimate story complexity
- Plan sprint iterations
- Begin implementation following this architectural blueprint

**Key Implementation Principles:**

1. Follow component boundaries defined in this document
2. Implement NFR solutions as specified
3. Use technology stack as defined
4. Follow API contracts exactly
5. Adhere to security and performance guidelines

---

**This document was created using BMAD Method v6 - Phase 3 (Solutioning)**

_To continue: Run `/workflow-status` to see your progress and next recommended workflow._

---

## Appendix A: Technology Evaluation Matrix

{{tech_evaluation_matrix}}

---

## Appendix B: Capacity Planning

{{capacity_planning}}

---

## Appendix C: Cost Estimation

{{cost_estimation}}
