initial commit

This commit is contained in:
2026-03-16 19:54:53 -04:00
commit bfe0e01254
3341 changed files with 483939 additions and 0 deletions

View File

@@ -0,0 +1,218 @@
# Platform Requirements: {{project_name}}
> Technical Boundaries & Platform Decisions
**Created:** {{date}}
**Author:** {{user_name}}
**Related:** [Product Brief](./product-brief.md)
---
## Technology Stack
### Core Platform
**CMS/Framework:** {{cms_framework}}
**Approach:** {{tech_approach}}
{{tech_approach_details}}
### Key Technologies
| Layer | Technology | Rationale |
|-------|------------|-----------|
| **Frontend** | {{frontend_tech}} | {{frontend_rationale}} |
| **Styling** | {{styling_tech}} | {{styling_rationale}} |
| **CMS/Backend** | {{backend_tech}} | {{backend_rationale}} |
{{#if database_tech}}| **Database** | {{database_tech}} | {{database_rationale}} |{{/if}}
{{#if hosting_tech}}| **Hosting** | {{hosting_tech}} | {{hosting_rationale}} |{{/if}}
---
## Plugin/Package Stack
{{#if plugins}}
| Plugin | Purpose | Status |
|--------|---------|--------|
{{#each plugins}}
| {{this.name}} | {{this.purpose}} | {{this.status}} |
{{/each}}
{{else}}
*To be determined during development*
{{/if}}
---
## Integrations
### Required Integrations
{{#each integrations}}
- **{{this.name}}:** {{this.purpose}}
{{/each}}
### Future Integrations
{{#each future_integrations}}
- **{{this.name}}:** {{this.purpose}} *({{this.timeline}})*
{{/each}}
---
## Contact Strategy
### Primary Contact Method
{{contact_strategy}}
### Contact Channels
| Channel | Priority | Implementation |
|---------|----------|----------------|
{{#each contact_channels}}
| {{this.channel}} | {{this.priority}} | {{this.implementation}} |
{{/each}}
### Future: AI Integration
{{ai_integration_notes}}
---
## UX Constraints
*These constraints inform what's possible in Phase 4 (UX Design)*
### Platform Limitations
{{#each ux_constraints}}
- {{this}}
{{/each}}
### Performance Targets
| Metric | Target | Rationale |
|--------|--------|-----------|
| **Mobile First** | {{mobile_first}} | {{mobile_rationale}} |
| **Page Load** | {{page_load_target}} | {{load_rationale}} |
| **Offline Support** | {{offline_support}} | {{offline_rationale}} |
---
## Multilingual Requirements
{{#if multilingual}}
**Languages:** {{languages}}
**Implementation:** {{multilingual_implementation}}
**URL Structure:**
```
{{url_structure}}
```
**Translation Workflow:** {{translation_workflow}}
{{else}}
*Single language site*
{{/if}}
---
## SEO Requirements
### Technical SEO
{{#each seo_requirements}}
- {{this}}
{{/each}}
### Structured Data
| Page Type | Schema Type | Key Properties |
|-----------|-------------|----------------|
{{#each structured_data}}
| {{this.page_type}} | {{this.schema_type}} | {{this.properties}} |
{{/each}}
### Local SEO (if applicable)
{{#if is_local_business}}
- [ ] Google Business Profile claimed and verified
- [ ] NAP consistency (Name, Address, Phone) across all pages
- [ ] Business category set correctly
- [ ] Service area defined
- [ ] Photos uploaded
{{else}}
*Not a local business*
{{/if}}
### Performance & Infrastructure
| Metric | Target |
|--------|--------|
| **Largest Contentful Paint (LCP)** | < 2.5 seconds |
| **First Input Delay (FID)** | < 100ms |
| **Cumulative Layout Shift (CLS)** | < 0.1 |
| **Page Load (4G)** | < 3 seconds |
| **Total Page Weight** | < 3MB |
| **Individual Image Size** | < 200KB (hero < 400KB) |
| **Mobile-Friendly** | Yes |
| **Favicon** | All sizes (16, 32, 180, 192px) |
### Security Headers
| Header | Purpose |
|--------|---------|
| **Strict-Transport-Security (HSTS)** | Force HTTPS |
| **Content-Security-Policy (CSP)** | Prevent XSS |
| **X-Content-Type-Options** | Prevent MIME sniffing |
| **X-Frame-Options** | Prevent clickjacking |
| **Referrer-Policy** | Control referrer info |
| **Permissions-Policy** | Restrict browser features |
### SEO Plugin/Tools
{{seo_tools}}
---
## Maintenance & Ownership
| Aspect | Owner | Notes |
|--------|-------|-------|
| **Content Updates** | {{content_owner}} | {{content_notes}} |
| **Technical Maintenance** | {{tech_owner}} | {{tech_notes}} |
| **Plugin Updates** | {{plugin_owner}} | {{plugin_notes}} |
---
## Development Handoff Notes
*For Phase 6 (Deliveries)*
### Environment Setup
{{environment_setup}}
### Deployment Process
{{deployment_process}}
### Key Considerations
{{#each dev_considerations}}
- {{this}}
{{/each}}
---
## Next Steps
- [ ] **Content & Language** Define tone, languages, SEO keywords
- [ ] **Visual Direction** Establish visual style and brand
- [ ] **Phase 2: Trigger Mapping** Map user psychology
- [ ] **Phase 4: UX Design** Begin design within these constraints
---
_Generated by Whiteport Design Studio_