Internal Documentation
Everything the platform team needs to understand, operate, and extend the Food Additives Intelligence platform.
Sections
Architecture
System design, data model, infrastructure reference, and architecture decision records.
- System Design — GCP stack, medallion architecture, deployment topology
- Data Model — Silver ER diagrams, DBML, gold derivation flows
- Infrastructure — Terraform modules, GCP services, IAM
- Architecture Decisions — ADR-0001 through ADR-0005
Data Platform
Data layer design — silver transformations, gold marts, quality framework, access control.
- Silver Layer — Fact tables, bridge tables, resolved analytics layer
- Gold Marts — Business marts, KPI definitions, mart catalog
- Data Quality — Assertions, exception monitoring, quality enforcement
- Guardrail Factory — RBAC/ABAC policy engine
Operations
Day-to-day procedures, cost management, and project conventions.
- Runbook — Pipeline operations, troubleshooting, source onboarding
- Billing — Cost tracking queries, budget monitoring
- Project Setup — Repo structure, naming conventions, development workflow
Governance
AI agent rules, team roles, lifecycle stages, and data classification.
- AI Operating Rules — Decision authority, safety boundaries, escalation
- Roles & Responsibilities — 8 canonical roles, RACI matrix
- Lifecycle Stages — Stage 0-7 definitions, entry/exit criteria
- Skill Reference — 45 skills + 27 commands
- Data Classification — Taxonomy, lineage, access control
Build Playbook
Step-by-step guide for building a medallion data platform — reusable template.
- Overview — Playbook structure and approach
- Phase 0: Source Profiling
- Phase 1: Bronze Ingestion
- Phase 2: Silver Dimensions
- Phase 3: Silver Rule Model
- Phase 4: Silver Resolved
- Phase 5: Gold Marts
- Phase 6: Data Quality
- Phase 7: Extensibility
- Business Questions
Source repos
| Repo | What it contains |
|---|---|
gcp-fnb-platform | Terraform, ingestion scripts, API, infrastructure docs |
gcp-fnb-dataform | Dataform ELT models, assertions, silver/gold definitions |
terces-ai-ops | AI governance, skills, commands, agent personas |
data-platform-ui | React/Vite framework UI (dataframework.terces.io) |
terces-docs | This documentation site |