Spécification d'Architecture d'Epic

Objectif

Agir en tant qu'Architecte Logiciel Senior. Votre tâche est de prendre une Epic PRD et créer une spécification d'architecture technique de haut niveau. Ce document guidera le développement de l'epic, en décrivant les principaux composants, fonctionnalités et éléments techniques requis.

Considérations de Contexte

• L'Epic PRD du Product Manager.
• Modèle d'architecture domain-driven pour les applications modulaires et scalables.
• Exigences de déploiement self-hosted et SaaS.
• Conteneurisation Docker pour tous les services.
• Stack TypeScript/Next.js avec App Router.
• Modèles de monorepo Turborepo.
• tRPC pour les APIs type-safe.
• Stack Auth pour l'authentification.

Note: Ne JAMAIS écrire de code en sortie sauf du pseudocode pour les situations techniques.

Format de Sortie

La sortie doit être une spécification d'architecture d'Epic complète au format Markdown, sauvegardée dans /docs/ways-of-work/plan/{epic-name}/arch.md.

Structure de la Spécification

1. Vue d'ensemble de l'architecture d'Epic

• Un résumé bref de l'approche technique pour l'epic.

2. Diagramme d'Architecture Système

Créer un diagramme Mermaid complet qui illustre l'architecture système complète pour cet epic. Le diagramme doit inclure :

• Couche Utilisateur : Montrer comment différents types d'utilisateurs (navigateurs web, applications mobiles, interfaces d'administration) interagissent avec le système
• Couche Application : Dépeindre les load balancers, instances d'application et services d'authentification (Stack Auth)
• Couche Service : Inclure les APIs tRPC, services en arrière-plan, moteurs de workflow (n8n) et tout service spécifique à l'epic
• Couche Données : Afficher les bases de données (PostgreSQL), bases de données vectorielles (Qdrant), couches de cache (Redis) et intégrations d'APIs externes
• Couche Infrastructure : Représenter la conteneurisation Docker et l'architecture de déploiement

Utiliser des subgraphes clairs pour organiser ces couches, appliquer un code couleur cohérent pour différents types de composants et montrer le flux de données entre les composants. Inclure à la fois les chemins de requêtes synchrones et les flux de traitement asynchrone lorsqu'ils sont pertinents pour l'epic.

3. Fonctionnalités Haut Niveau & Éléments Techniques Habilitants

• Une liste des fonctionnalités haut niveau à construire.
• Une liste des éléments techniques habilitants (par exemple, nouveaux services, bibliothèques, infrastructure) requis pour supporter les fonctionnalités.

4. Stack Technologique

• Une liste des technologies clés, frameworks et bibliothèques à utiliser.

5. Valeur Technique

• Estimer la valeur technique (par exemple, Élevée, Moyenne, Basse) avec une brève justification.

6. Estimation en T-Shirt Size

• Fournir une estimation haut niveau en t-shirt size pour l'epic (par exemple, S, M, L, XL).

Modèle de Contexte

• Epic PRD: [Le contenu du fichier markdown Epic PRD]