Teamcenter Phase 1 Workflow Skeleton

This repository now contains a modular Phase 1 demonstration scaffold for the upload-to-Teamcenter-draft workflow.

What is included

• Existing Teamcenter FastAPI wrapper and MCP bridge preserved

• New Phase 1 workflow API under /api/*

• SQLAlchemy-backed workflow persistence with SQLite default and PostgreSQL-ready configuration

• Deterministic mock Teamcenter mode for demos

• File validation, extraction, similarity search, BQ drafting, document generation, approval, and save flow

• Vite React frontend scaffold in frontend/

• Demo data and sample upload fixtures in shared/demo/

Related MCP server: Suppr MCP

Demo credentials

• viewer / viewer

• engineer / engineer

Local backend startup

1. Create or activate a Python 3.11 environment.

2. Install dependencies: pip install -r requirements.txt

3. Copy .env.example to .env and adjust values if needed.

4. Run the API: python -m uvicorn app.main:app --reload

The API will initialize demo users and the local SQLite database automatically on startup.

Frontend startup

1. cd frontend

2. npm install

3. npm run dev

Docker startup

docker compose up --build

Demo happy path

1. Log in as engineer.

2. Upload shared/demo/uploads/requirement_sample.txt in mock mode.

3. Call:

   • POST /api/workflows/{id}/validate-files

   • POST /api/workflows/{id}/extract

   • PUT /api/workflows/{id}/requirement-review

   • POST /api/workflows/{id}/similarity-search

   • POST /api/workflows/{id}/bq-selection

   • PUT /api/workflows/{id}/bq-draft

   • POST /api/workflows/{id}/bq-prepare

   • POST /api/workflows/{id}/documents/generate

   • POST /api/workflows/{id}/approve

   • POST /api/workflows/{id}/save-teamcenter

Tests

Backend and contract tests live under tests/.