Testing¶

Comprehensive testing strategy, guides, and best practices for the Dashtam project.

Contents¶

This directory contains testing documentation covering strategy, implementation guides, best practices, and quality standards for unit, integration, and end-to-end tests.

Directory Structure¶

testing/
├── strategy.md                      # Comprehensive testing strategy and approach
└── index.md                         # This file

Documents¶

Core Testing Documentation¶

• Testing Strategy - Comprehensive testing strategy covering all test types
• Current Coverage: 76% (295 tests passing)
• Unit tests (70% of total)
• Integration tests (20% of total)
• End-to-end smoke tests (10% of total)
• Test pyramid approach and patterns
• FastAPI TestClient synchronous testing
• Fixtures, mocks, and test utilities
• Troubleshooting and common issues
• Target coverage goal: 85%

Related Development Guides¶

For detailed implementation guidance, see:

• Testing Guide - Comprehensive how-to guide with examples
• Testing Best Practices - Testing patterns and conventions
• Test Docstring Standards - Test documentation standards

Test Infrastructure¶

• Smoke Tests - End-to-end authentication flow tests
• Test Infrastructure Guide - Setting up test environment
• Async Testing Decision - Synchronous testing ADR

Quick Links¶

Implementation Guides:

• Testing Guide - Step-by-step testing tutorial
• Testing Best Practices - Patterns and conventions
• Docstring Standards for Tests - Test documentation

Architecture & Strategy:

• Async Testing Decision - Synchronous testing design decision
• Testing Strategy - Complete testing approach

External Resources:

• Pytest Documentation
• FastAPI Testing
• SQLModel Testing
• Coverage.py

Navigation¶

Parent Directory: ../index.md

Related Directories:

• Development Guides - How-to guides and tutorials
• Architecture - System design decisions
• Troubleshooting - Problem diagnosis and solutions

Development Documentation:

• Development Index - All development documentation
• README.md (project root) - Project overview

Contributing¶

When adding new testing documentation to this directory:

1. Use for testing documentation
2. Cover both strategy and implementation details
3. Include code examples and test patterns
4. Document test setup, execution, and verification
5. Link to related architecture decisions
6. Update this index with link and brief description
7. Run markdown linting: make lint-md FILE="path/to/file.md"

Testing Documentation Guidelines¶

• Document new testing patterns as they're discovered
• Keep patterns consistent with testing-best-practices.md
• Include both passing and failing test examples
• Document fixtures and utilities clearly
• Link to architecture decisions that impact testing
• Include troubleshooting sections for common issues

Document Information¶

Template: index-section-template.md Created: 2025-10-03 Last Updated: 2025-10-21