feat: sincronizar scaffold completo del shape web-backend/python
Some checks failed
__APP_NAME__ — build & deploy / build (push) Failing after 0s
__APP_NAME__ — build & deploy / helm-deploy (push) Has been skipped

Sincroniza el scaffold canónico desde templates/web-backend-python/ del
repo IDP. Reemplaza el placeholder mínimo previo (.gitea/workflows/ci.yaml,
README.md, .gitignore, catalog-info.yaml) por el scaffold completo
documentado en ADR-053 §3:

- code/ — FastAPI app con /health (db check), /metrics, /demo estático,
  middleware correlation_id, settings Pydantic, db.py con SQLAlchemy
- code/alembic/ — migración inicial vacía + env.py usando MIGRATION_DATABASE_URL
- code/tests/ — pytest + httpx TestClient (test_health, test_demo)
- helm/APP_NAME/ — chart con Deployment, Service, IngressRoute Traefik,
  NetworkPolicy, ServiceMonitor, Job alembic-upgrade como hook
  pre-upgrade,pre-install (backoffLimit: 0)
- coralware-shape.yaml — manifiesto v1alpha1 del contrato del shape
- claim-mariadb.yaml — AddonClaim declarativo (uso futuro ADR-052)
- catalog-info.yaml — entidad Backstage actualizada
- .gitea/workflows/APP_NAME-build.yaml — invoca reusable workflow ADR-038
  + job helm-deploy con KUBECONFIG_TENANT_B64

Placeholders __APP_NAME__, __TIER__, __TENANT_ID__, __TENANT_ID_NODASHES__
serán sustituidos server-side por repo-provisioner cuando materialice el
template para un tenant (pendiente — ADR-053 §11.5).

El openspec/ del golden path NO se sincroniza al repo Gitea (gobernanza
interna de Coralware).

Refs: ADR-052, ADR-053, poc-nexobms.md (PoC NexoBMS Demetrio).
This commit is contained in:
2026-05-06 17:48:13 -05:00
parent 00a801f525
commit fcec92ea1d
35 changed files with 1216 additions and 32 deletions

38
coralware-shape.yaml Normal file
View File

@@ -0,0 +1,38 @@
# Manifiesto de contrato del shape — leído por la plataforma Coralware
# para entender qué endpoints expone tu app y qué dependencias necesita.
# NO eliminar este archivo. Sí puedes ajustar valores conforme tu app evolucione.
apiVersion: coralware.cloud/v1alpha1
kind: Shape
metadata:
name: web-backend-python
spec:
goldenPath: web-backend
goldenPathLang: python
shapeVersion: "1.0.0"
app:
name: __APP_NAME__
framework: fastapi
pythonVersion: "3.12"
endpoints:
health: /health
docs: /docs
demo: /demo
metrics: /metrics
database:
required: true
type: mariadb
secretName: __APP_NAME__-db-creds
keys:
- DATABASE_URL
- MIGRATION_DATABASE_URL
migrations:
tool: alembic
hook: pre-upgrade
observability:
metricsPort: 9090
prometheusScrape: true