Astravale.Ethos
Back to product

Architecture

The architecture.

A calm workspace on top, Ethos review underneath, and a project entity model that keeps every report connected to the work.

01 - System

Four layers, top to bottom.

Interface

Next.js App Router screens: landing, ingest, auth, projects, workspace, and static product surfaces.

Client boundary

Typed frontend clients already mark where ingestion, metrics, files, reports, and assistant calls will later switch to fetch().

Routing layer

Quick extraction, file sniffing, and Ethos review handle obvious work before deeper reasoning.

Reasoning layer

Only ambiguous summaries, methodology judgement, and full project sweeps need model routing.

02 - Copilot Tiers

Quiet by default, loud only when calibrated.

Handled locally

Metric strings, known log markers, basic file metadata, and simple status checks should cost nothing.

Lightweight model

Short notes, ambiguous stage routing, and small summaries can go through a cheaper model route.

Reasoning model

Methodology soundness, leakage risk, and project-level critique require a stronger reasoning path.

03 - Data Model

Nine tables, one project spine.

Project

The durable container: title, objective, domain, status, tags, stage order, report state.

Stage and substage

Large phases hold smaller workflow blocks. They are separate from iterations so the science stays readable.

Iteration

Every run captures what changed, files, metrics, warnings, notes, status, and next action.

Evidence

Files, metrics, assumptions, decisions, checks, and report sections reference the relevant stage or iteration.

04 - Deployment

Three environments, one push.

Product frontend

This pass keeps the frontend self-contained and deployable without environment variables.

Logic service

A future service owns parsing, routing, metrics extraction, report rendering, and model calls.

Private deployments

Enterprise and university deployments can isolate storage, routing, models, and audit controls.

Next

Open the product and start structuring work.