# codaqui/cromocard-workspace architecture

> Architecture diagram of the GitHub repository codaqui/cromocard-workspace, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codaqui/cromocard-workspace
- Repository: https://github.com/codaqui/cromocard-workspace

## Overview

CromoCard Workspace reúne a documentação de produto e arquitetura, as especificações SDD e dois apps mantidos como submódulos. O fluxo principal documentado transforma casos de uso em specs aprovadas, planos e implementação; as specs são derivadas da documentação. O README também descreve capacidades do sistema — coleção e catálogo, comunidade, marketplace e backoffice — mas, sem trechos de código dos submódulos, não é possível detalhar chamadas internas nem confirmar integrações entre frontend e backend. O grafo mostra apenas relações documentadas.

Main entry points: [`specs`](https://github.com/codaqui/cromocard-workspace/tree/development/specs) (Specs SDD), [`.claude/skills/especificar/SKILL.md`](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/especificar/SKILL.md) (Especificar story), [`.claude/skills/planejar/SKILL.md`](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/planejar/SKILL.md) (Planejar implementação), [`.claude/skills/cromocard-desenvolver/SKILL.md`](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/cromocard-desenvolver/SKILL.md) (Desenvolver spec)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Produto e arquitetura"]
  node_docs["Documentação-fonte"]
  node_collection["Coleção e catálogo"]
  node_community["Comunidade"]
  node_marketplace["Marketplace"]
  node_backoffice["Backoffice"]
end

subgraph group_apps["Apps CromoCard"]
  node_backend["API backend"]
  node_frontend["SPA web e backoffice"]
end

subgraph group_sdd["Fluxo SDD"]
  node_specs["Specs SDD"]
  node_especificar["Especificar story<br/>[SKILL.md]"]
  node_planejar["Planejar implementação<br/>[SKILL.md]"]
  node_desenvolver["Desenvolver spec<br/>[SKILL.md]"]
  node_revisor["Revisar implementação<br/>[SKILL.md]"]
  node_criarpr["Criar PR<br/>[SKILL.md]"]
end

node_product_owner(("Product owner"))
node_figma(("Figma"))

node_docs -->|"origina specs"| node_specs
node_product_owner -->|"solicita spec"| node_especificar
node_figma -->|"fornece protótipo"| node_especificar
node_especificar -->|"escreve spec"| node_specs
node_specs -->|"aprovada, planeja"| node_planejar
node_planejar -->|"orienta desenvolvimento"| node_desenvolver
node_desenvolver -->|"segue para revisão"| node_revisor
node_revisor -->|"segue para PR"| node_criarpr

click node_docs "https://github.com/codaqui/cromocard-workspace/tree/development/docs"
click node_collection "https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso"
click node_community "https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso"
click node_marketplace "https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso"
click node_backoffice "https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso"
click node_backend "https://github.com/codaqui/cromocard-workspace/tree/development/apps/cromocard-backend"
click node_frontend "https://github.com/codaqui/cromocard-workspace/tree/development/apps/cromocard-frontend"
click node_specs "https://github.com/codaqui/cromocard-workspace/tree/development/specs"
click node_especificar "https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/especificar/SKILL.md"
click node_planejar "https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/planejar/SKILL.md"
click node_desenvolver "https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/cromocard-desenvolver/SKILL.md"
click node_revisor "https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/cromocard-revisor/SKILL.md"
click node_criarpr "https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/criar-pr/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_docs,node_collection,node_community,node_marketplace,node_backoffice toneBlue
class node_backend,node_frontend toneAmber
class node_specs,node_especificar,node_planejar,node_desenvolver,node_revisor,node_criarpr toneMint
class node_product_owner,node_figma toneIndigo
```

## Components

### Produto e arquitetura

- [Documentação-fonte](https://github.com/codaqui/cromocard-workspace/tree/development/docs): `docs`
- [Coleção e catálogo](https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso): `docs/Casos-De-Uso`
- [Comunidade](https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso): `docs/Casos-De-Uso`
- [Marketplace](https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso): `docs/Casos-De-Uso`
- [Backoffice](https://github.com/codaqui/cromocard-workspace/tree/development/docs/Casos-De-Uso): `docs/Casos-De-Uso`

### Apps CromoCard

- [API backend](https://github.com/codaqui/cromocard-workspace/tree/development/apps/cromocard-backend): `apps/cromocard-backend`
- [SPA web e backoffice](https://github.com/codaqui/cromocard-workspace/tree/development/apps/cromocard-frontend): `apps/cromocard-frontend`

### Fluxo SDD

- [Specs SDD](https://github.com/codaqui/cromocard-workspace/tree/development/specs): `specs`
- [Especificar story](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/especificar/SKILL.md): `.claude/skills/especificar/SKILL.md`
- [Planejar implementação](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/planejar/SKILL.md): `.claude/skills/planejar/SKILL.md`
- [Desenvolver spec](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/cromocard-desenvolver/SKILL.md): `.claude/skills/cromocard-desenvolver/SKILL.md`
- [Revisar implementação](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/cromocard-revisor/SKILL.md): `.claude/skills/cromocard-revisor/SKILL.md`
- [Criar PR](https://github.com/codaqui/cromocard-workspace/blob/development/.claude/skills/criar-pr/SKILL.md): `.claude/skills/criar-pr/SKILL.md`

### Other components

- **Product owner**
- **Figma**

## Connections

- Documentação-fonte → Specs SDD: origina specs (evidence: `README.md`)
- Product owner → Especificar story: solicita spec (evidence: `README.md`)
- Figma → Especificar story: fornece protótipo (evidence: `README.md`)
- Especificar story → Specs SDD: escreve spec (evidence: `README.md`)
- Specs SDD → Planejar implementação: aprovada, planeja (evidence: `README.md`)
- Planejar implementação → Desenvolver spec: orienta desenvolvimento (evidence: `README.md`)
- Desenvolver spec → Revisar implementação: segue para revisão (evidence: `README.md`)
- Revisar implementação → Criar PR: segue para PR (evidence: `README.md`)