@tmf/projects-front (7.4.0)

Published 2026-10-30 10:24:46 -03:00 by tarcisio

Setup this registry in your project .npmrc file:

@tmf:registry=

To install the package using npm, run the following command:

npm install @tmf/projects-front@7.4.0

or add it to the package.json file:

"@tmf/projects-front": "7.4.0"

For more information on the npm registry, see the documentation.

@tmf/projects-front

Módulo plug-and-play de Gestão de Projetos da plataforma TMF — o tracker de issues (board/backlog/sprints/workflow) mais as lentes de planejamento (planos, roadmap/Gantt, planejamento semanal, apontamento), como lib React instalável em Hub, TMF9, Dais, HelpCor e PriceShow.

Escopo: shell de abas condicionadas por GET /meta + deep-link, com as telas de domínio (board/backlog, planos, planejamento semanal, roadmap, apontamento, métricas, agents) em src/components/. O domínio é de esforço (horas, story points, issues) — dinheiro é do @tmf/finance-front.

Padrão A — instale 1 pacote e use

import { ProjectsApp } from '@tmf/projects-front'

<ProjectsApp
  baseUrl={window.location.origin} // RAIZ do host (ADR-002 Convenção A + ADR-005); '' lança erro
  getToken={() => authToken}
  tenantId="tmf"
  locale="pt-BR"
  routing={{ basePath: '/projects' }}
/>

O <ProjectsApp> monta sozinho o ProjectsProvider (QueryClient + i18n internos, client derivado do HttpClient do @tmf/platform-core). O host não precisa montar AppContract nem QueryClientProvider.

Superfície pública

Export	O que é
`ProjectsApp`	Componente top-level (Padrão A).
`ProjectsProvider` / `useProjectsContext`	Provider + hook de contexto.
`createDefaultProjectsClient`	Fábrica do `ProjectsApiClient` a partir de `baseUrl` + `getToken`.
`projectsQueryKeys` / `invalidateProjectsMeta`	Query keys canônicas.
`getProjectsCatalog` / `PROJECTS_CATALOGS`	Catálogos i18n (`projects.*`).
`ProjectsPlaceholder`	Estado vazio de uma aba do shell.
`AgentsTab` / `KanbanView` / `OfficeView` / `TerminalDrawer`	Painel de Agents (aba `agents`, 6.9.0) e suas visualizações.
`resolveVisibleTabs` / `resolveActiveTab` / `PROJECTS_TAB_DEFS`	Resolução pura das abas visíveis a partir de `GET /meta`.
`useProjectsRouting`	Hook de deep-link `?tab=…&issue=<KEY>` (History API, sem react-router).
`PROJECTS_API_PREFIX`	Prefixo canônico do serviço (`/api/projects`, ADR-005).
tipos `ProjectsApiClient` / `ProjectsMeta` / `ProjectsIntegrationsHealth` / `ProjectsTabKey` / `ProjectsRouting`	Contrato do módulo.

Abas e gate por feature

Cada aba só monta quando a feature está em GET /meta e o apiClient implementa o grupo de métodos dela (slot pattern, src/clientFeatures.ts — ver INTEGRATION.md §4). Além do tracker (issues), planos, semanal, roadmap, apontamento e métricas, desde a 6.9.0 existe a aba Agents (components/agents/, epic TMFP-63691): painel dos terminais Claude Code por produto — stat cards, Contas Max, filtros, visualizações Terminais (kanban com drag-and-drop) e Escritório (salas, corredor e mesas animadas) e o drawer do terminal. Gate: feature agents do /meta + grupo agents do client (PROJECTS_FEATURE_METHODS.agents: listAgents, getAgent, getAgentTerminal, assignAgent, sendAgentInput, releaseAgent, nextAgent, removeAgentQueueItem, triageIssue, listAgentAccounts). Requer um tmf-projects-back que exponha as rotas /agents (ver ../back/INTEGRATION.md §5). Detalhe do que existe e do que não existe: FUNCIONALIDADES.md § Aba Agents.

Empacotamento

Build com tsup (cjs + esm + dts). @tmf/platform-core é empacotado no dist (noExternal) — o consumidor instala só @tmf/projects-front.
react/react-dom são peerDependencies (singleton).
src/version.ts é auto-gerado pelo script prebuild a partir do package.json.

Desenvolvimento

npm ci                       # na raiz do monorepo
npm run build -w @tmf/platform-core
npm run build -w @tmf/projects-front
npm run lint  -w @tmf/projects-front
npm run test  -w @tmf/projects-front

Ver playground/ para um harness visual e INTEGRATION.md para o passo a passo de adoção no host.

Dependencies

ID	Version
@dnd-kit/core	^6.0.0
@tanstack/react-query	^5.0.0
dompurify	^3.0.0
lucide-react	^0.400.0
recharts	^2.0.0

Development dependencies

ID	Version
@testing-library/jest-dom	^6.0.0
@testing-library/react	^16.0.0
@tiptap/pm	^3.27.3
@tiptap/react	^3.27.3
@tiptap/starter-kit	^3.27.3
@tmf/platform-core	file:../../platform-core
@types/dompurify	^3.0.5
@types/react	^18.2.47
@types/react-dom	^18.2.18
jsdom	^25.0.0
tsup	^8.5.1
typescript	^5.3.3
vitest	^4.1.11

Peer dependencies

ID	Version
@tiptap/pm	>=3.0.0
@tiptap/react	>=3.0.0
@tiptap/starter-kit	>=3.0.0
@tmf/design-tokens	>=0.6.0
react	>=18.0.0
react-dom	>=18.0.0

tmf projects issues tracker roadmap react plug-and-play

Details

npm

2026-10-30 10:24:46 -03:00

Trade Marketing Force LTDA

UNLICENSED

1.1 MiB

Assets (1)

projects-front-7.4.0.tgz 1.1 MiB

Versions (33) View all

8.5.0

2026-11-04

8.3.0

2026-11-04

8.0.1

2026-11-03

7.4.0

2026-10-30

7.3.0

2026-10-29

@tmf/projects-front (7.4.0)

Installation

About this package