# Fapilog v3 Architecture Document

## Table of Contents

- [Fapilog v3 Architecture Document](#table-of-contents)
  - [Introduction](./introduction.md)
    - [Starter Template or Existing Project](./introduction.md#starter-template-or-existing-project)
    - [Change Log](./introduction.md#change-log)
  - [High Level Architecture](./high-level-architecture.md)
    - [Technical Summary](./high-level-architecture.md#technical-summary)
    - [High Level Overview](./high-level-architecture.md#high-level-overview)
    - [High Level Project Diagram](./high-level-architecture.md#high-level-project-diagram)
    - [Architectural and Design Patterns](./high-level-architecture.md#architectural-and-design-patterns)
  - [Tech Stack](./tech-stack.md)
    - [Technology Stack Table](./tech-stack.md#technology-stack-table)
    - [Key Architectural Technology Decisions:](./tech-stack.md#key-architectural-technology-decisions)
  - [Data Models](./data-models.md)
    - [LogEvent](./data-models.md#logevent)
    - [Settings](./data-models.md#settings)
    - [PluginMetadata](./data-models.md#pluginmetadata)
    - [AsyncLoggingContainer](./data-models.md#asyncloggingcontainer)
  - [Components](./components.md)
    - [AsyncLogger](./components.md#asynclogger)
    - [AsyncLoggingContainer](./components.md#asyncloggingcontainer)
    - [AsyncPipeline](./components.md#asyncpipeline)
    - [PluginRegistry](./components.md#pluginregistry)
    - [MetricsCollector](./components.md#metricscollector)
    - [AsyncQueue](./components.md#asyncqueue)
    - [FastAPIIntegrationLayer](./components.md#fastapiintegrationlayer)
    - [Component Diagrams](./components.md#component-diagrams)
  - [External APIs](./external-apis.md)
    - [Core Library: Zero External Dependencies](./external-apis.md#core-library-zero-external-dependencies)
    - [Plugin Ecosystem: Community-Driven via PyPI](./external-apis.md#plugin-ecosystem-community-driven-via-pypi)
    - [Enterprise Plugins: Optional External APIs](./external-apis.md#enterprise-plugins-optional-external-apis)
  - [Built-in Core Features](./built-in-core-features.md)
    - [Core Sinks (Built-in)](./built-in-core-features.md#core-sinks-built-in)
    - [Core Processors (Built-in)](./built-in-core-features.md#core-processors-built-in)
    - [Core Enrichers (Built-in)](./built-in-core-features.md#core-enrichers-built-in)
    - [Core Formatters (Built-in)](./built-in-core-features.md#core-formatters-built-in)
    - [Default Configuration](./built-in-core-features.md#default-configuration)
    - [Built-in vs Plugin Feature Matrix](./built-in-core-features.md#built-in-vs-plugin-feature-matrix)
    - [Progressive Enhancement Philosophy](./built-in-core-features.md#progressive-enhancement-philosophy)
    - [Core Library Guarantees](./built-in-core-features.md#core-library-guarantees)
  - [Core Workflows](./core-workflows.md)
    - [High-Performance Async Logging Workflow](./core-workflows.md#high-performance-async-logging-workflow)
    - [Plugin Discovery and Loading Workflow](./core-workflows.md#plugin-discovery-and-loading-workflow)
    - [Enterprise Compliance and Audit Workflow](./core-workflows.md#enterprise-compliance-and-audit-workflow)
    - [High-Throughput Batch Processing Workflow](./core-workflows.md#high-throughput-batch-processing-workflow)
    - [Container Isolation Workflow](./core-workflows.md#container-isolation-workflow)
  - [REST API Spec](./rest-api-spec.md)
    - [Core Library: No REST API](./rest-api-spec.md#core-library-no-rest-api)
    - [Plugin Discovery](./rest-api-spec.md#plugin-discovery)
  - [Database Schema](./database-schema.md)
    - [Core Library: No Database](./database-schema.md#core-library-no-database)
    - [Enterprise Plugin Databases](./database-schema.md#enterprise-plugin-databases)
  - [Source Tree](./source-tree.md)
  - [Infrastructure and Deployment](./infrastructure-and-deployment.md)
    - [Infrastructure as Code](./infrastructure-and-deployment.md#infrastructure-as-code)
    - [Deployment Strategy](./infrastructure-and-deployment.md#deployment-strategy)
    - [Environments](./infrastructure-and-deployment.md#environments)
    - [Environment Promotion Flow](./infrastructure-and-deployment.md#environment-promotion-flow)
    - [Rollback Strategy](./infrastructure-and-deployment.md#rollback-strategy)
    - [Framework Lifecycle Integration](./infrastructure-and-deployment.md#framework-lifecycle-integration)
  - [Error Handling Strategy](./error-handling-strategy.md)
    - [General Approach](./error-handling-strategy.md#general-approach)
    - [Logging Standards](./error-handling-strategy.md#logging-standards)
    - [Error Handling Patterns](./error-handling-strategy.md#error-handling-patterns)
      - [External API Errors](./error-handling-strategy.md#external-api-errors)
      - [Business Logic Errors](./error-handling-strategy.md#business-logic-errors)
      - [Data Consistency](./error-handling-strategy.md#data-consistency)
  - [Developer-Friendly Error Experience](./developer-friendly-error-experience.md)
    - [Default Behavior: Silent Resilience](./developer-friendly-error-experience.md#default-behavior-silent-resilience)
    - [Optional Error Observability](./developer-friendly-error-experience.md#optional-error-observability)
    - [Enterprise Error Integration](./developer-friendly-error-experience.md#enterprise-error-integration)
  - [Plugin Error Isolation](./plugin-error-isolation.md)
    - [Plugin Failure Containment](./plugin-error-isolation.md#plugin-failure-containment)
    - [Graceful Degradation](./plugin-error-isolation.md#graceful-degradation)
    - [Framework Hook Error Handling](./plugin-error-isolation.md#framework-hook-error-handling)
  - [Coding Standards](./coding-standards.md)
    - [Core Standards](./coding-standards.md#core-standards)
    - [Naming Conventions](./coding-standards.md#naming-conventions)
    - [Critical Rules](./coding-standards.md#critical-rules)
    - [Dependency Injection Patterns](./coding-standards.md#dependency-injection-patterns)
  - [Test Strategy and Standards](./test-strategy-and-standards.md)
    - [Testing Philosophy](./test-strategy-and-standards.md#testing-philosophy)
    - [Test Types and Organization](./test-strategy-and-standards.md#test-types-and-organization)
      - [Unit Tests](./test-strategy-and-standards.md#unit-tests)
      - [Integration Tests](./test-strategy-and-standards.md#integration-tests)
      - [Performance Tests](./test-strategy-and-standards.md#performance-tests)
    - [Test Data Management](./test-strategy-and-standards.md#test-data-management)
    - [Continuous Testing](./test-strategy-and-standards.md#continuous-testing)
    - [FastAPI Test Utilities](./test-strategy-and-standards.md#fastapi-test-utilities)
  - [Security](./security.md)
    - [Input Validation](./security.md#input-validation)
    - [Authentication & Authorization](./security.md#authentication-authorization)
    - [Secrets Management](./security.md#secrets-management)
    - [Plugin Security](./security.md#plugin-security)
    - [Data Protection](./security.md#data-protection)
    - [Dependency Security](./security.md#dependency-security)
    - [Security Testing](./security.md#security-testing)
  - [Checklist Results Report](./checklist-results-report.md)
  - [Next Steps](./next-steps.md)
    - [Immediate Development Priorities](./next-steps.md#immediate-development-priorities)
    - [Development Team Handoff](./next-steps.md#development-team-handoff)
    - [Community Ecosystem Development](./next-steps.md#community-ecosystem-development)
    - [Enterprise Adoption Strategy](./next-steps.md#enterprise-adoption-strategy)
