Scaffold the Before-M1 repo skeleton
Stand up the modular-monolith skeleton per docs/V1_BUILD_PLAN.md: one .NET 10 solution with web + worker hosts sharing seven interface-bounded module projects, PostgreSQL 17 + pgvector via EF Core 10, a React 19 + Vite SPA built into wwwroot, and Docker Compose for one-command local dev. Skeleton only — no feature code. Architecture - One project per module (OrgBoard, Identity, Skills, Assembler, Governance, Memory, Integrations); each is its own assembly so non-public types (entities, DbContext) are invisible across modules at compile time. - TeamUp.Bootstrap is the only library that references all modules; both hosts reference only Bootstrap. SharedKernel/Infrastructure never reference modules. - IModule seam: Register(...) runs in both hosts; MapEndpoints(...) only in web. - PlatformDbContext owns the pgvector extension + the seven module schemas (InitialPlatform migration); MigrationRunner applies it then any module context. - One image, two roles selected by RUN_MODE at the Docker entrypoint. Verified - dotnet build green (nullable + warnings-as-errors). - ArchitectureTests 8/8 — reflection-based boundary rules (no module -> module, -> Infrastructure, -> Bootstrap, or -> host references). - IntegrationTests 10/10 — Testcontainers boots the host against real pgvector: migration applies, vector extension + 7 schemas exist, /health 200, every /api/<module>/ping 200, /openapi/v1.json served. - client builds clean (Vite 6 — pinned for Node 22.3.0; Vite 8 needs Node >=22.12). Packages and base images route through the Nexus mirror (mirror.soroushasadi.com), reachable from Iran when nuget.org / Docker Hub / MCR are not. CI is intentionally deferred to a later session. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
soroush.asadi
@@ -0,0 +1,21 @@
|
|||||||
|
# Build context is the repo root. Keep it lean and deterministic.
|
||||||
|
**/bin/
|
||||||
|
**/obj/
|
||||||
|
**/.vs/
|
||||||
|
**/.idea/
|
||||||
|
artifacts/
|
||||||
|
TestResults/
|
||||||
|
|
||||||
|
# Frontend — rebuilt inside the image
|
||||||
|
client/node_modules/
|
||||||
|
client/dist/
|
||||||
|
client/.vite/
|
||||||
|
|
||||||
|
# VCS / docs / local
|
||||||
|
.git/
|
||||||
|
.gitignore
|
||||||
|
.gitattributes
|
||||||
|
*.md
|
||||||
|
docs/
|
||||||
|
.editorconfig
|
||||||
|
**/appsettings.*.local.json
|
||||||
@@ -0,0 +1,47 @@
|
|||||||
|
root = true
|
||||||
|
|
||||||
|
[*]
|
||||||
|
charset = utf-8
|
||||||
|
end_of_line = lf
|
||||||
|
insert_final_newline = true
|
||||||
|
trim_trailing_whitespace = true
|
||||||
|
indent_style = space
|
||||||
|
indent_size = 4
|
||||||
|
|
||||||
|
[*.{json,js,jsx,ts,tsx,yml,yaml,css,html}]
|
||||||
|
indent_size = 2
|
||||||
|
|
||||||
|
[*.{csproj,props,targets,xml}]
|
||||||
|
indent_size = 2
|
||||||
|
|
||||||
|
[*.md]
|
||||||
|
trim_trailing_whitespace = false
|
||||||
|
|
||||||
|
[*.cs]
|
||||||
|
# Namespaces
|
||||||
|
csharp_style_namespace_declarations = file_scoped:warning
|
||||||
|
# usings
|
||||||
|
dotnet_sort_system_directives_first = true
|
||||||
|
csharp_using_directive_placement = outside_namespace:warning
|
||||||
|
# var / modern C#
|
||||||
|
csharp_style_var_when_type_is_apparent = true:suggestion
|
||||||
|
csharp_prefer_braces = true:suggestion
|
||||||
|
csharp_style_prefer_primary_constructors = true:suggestion
|
||||||
|
dotnet_style_require_accessibility_modifiers = for_non_interface_members:warning
|
||||||
|
# Prefer readonly
|
||||||
|
dotnet_style_readonly_field = true:warning
|
||||||
|
|
||||||
|
# Quiet a few analyzer rules that are noisy for a young codebase / skeleton.
|
||||||
|
# CA1515: types can be internal — intentionally relaxed (public module/contract surface).
|
||||||
|
dotnet_diagnostic.CA1515.severity = none
|
||||||
|
# CA1812: internal class never instantiated — false positives on DI-resolved types.
|
||||||
|
dotnet_diagnostic.CA1812.severity = none
|
||||||
|
# CA2007: ConfigureAwait — not needed in ASP.NET Core / worker (no sync context).
|
||||||
|
dotnet_diagnostic.CA2007.severity = none
|
||||||
|
# CA1848 / CA1873: LoggerMessage-delegate perf rules — opt-in perf, not worth enforcing in V1.
|
||||||
|
dotnet_diagnostic.CA1848.severity = none
|
||||||
|
dotnet_diagnostic.CA1873.severity = none
|
||||||
|
|
||||||
|
# EF Core migrations are tool-generated — don't style-police them.
|
||||||
|
[**/Migrations/*.cs]
|
||||||
|
generated_code = true
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
# Normalize line endings. Shell scripts MUST stay LF or they break in Linux containers.
|
||||||
|
* text=auto eol=lf
|
||||||
|
|
||||||
|
*.sh text eol=lf
|
||||||
|
*.cs text eol=lf
|
||||||
|
*.csproj text eol=lf
|
||||||
|
*.props text eol=lf
|
||||||
|
*.json text eol=lf
|
||||||
|
*.yml text eol=lf
|
||||||
|
*.yaml text eol=lf
|
||||||
|
Dockerfile text eol=lf
|
||||||
|
|
||||||
|
# Binaries
|
||||||
|
*.png binary
|
||||||
|
*.jpg binary
|
||||||
|
*.ico binary
|
||||||
|
*.woff2 binary
|
||||||
+37
@@ -0,0 +1,37 @@
|
|||||||
|
# ---- .NET ----
|
||||||
|
bin/
|
||||||
|
obj/
|
||||||
|
*.user
|
||||||
|
*.suo
|
||||||
|
.vs/
|
||||||
|
artifacts/
|
||||||
|
TestResults/
|
||||||
|
*.coverage
|
||||||
|
*.trx
|
||||||
|
# EF migration bundles
|
||||||
|
efbundle
|
||||||
|
efbundle.exe
|
||||||
|
|
||||||
|
# ---- Rider / VS Code ----
|
||||||
|
.idea/
|
||||||
|
.vscode/*
|
||||||
|
!.vscode/extensions.json
|
||||||
|
|
||||||
|
# ---- Node / Vite (frontend) ----
|
||||||
|
client/node_modules/
|
||||||
|
client/dist/
|
||||||
|
client/.vite/
|
||||||
|
npm-debug.log*
|
||||||
|
*.tsbuildinfo
|
||||||
|
|
||||||
|
# ---- Built SPA output (published into wwwroot; the placeholder index.html is committed) ----
|
||||||
|
src/Hosts/TeamUp.Web/wwwroot/assets/
|
||||||
|
|
||||||
|
# ---- Local secrets / env ----
|
||||||
|
*.env
|
||||||
|
.env.local
|
||||||
|
appsettings.*.local.json
|
||||||
|
|
||||||
|
# ---- OS ----
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
# TeamUp.AI — root memory & index
|
||||||
|
|
||||||
|
> **Build human + AI teams.** A live org chart that does work: model the org, fill open role-seats with governed AI agents, run delivery on one board. A product of **AliaSaaS**.
|
||||||
|
|
||||||
|
This is the short, always-loaded index. **Detailed source of truth lives in `docs/`** — keep them authoritative; keep this file lean.
|
||||||
|
|
||||||
|
| Doc | What it is |
|
||||||
|
|---|---|
|
||||||
|
| `docs/CLAUDE.md` | Full project memory (architecture, domain model, modules, conventions, design language) |
|
||||||
|
| `docs/PRODUCT.md` | Complete product model & decisions (incl. deferred-past-V1) |
|
||||||
|
| `docs/V1_BUILD_PLAN.md` | The V1 wedge: milestones M1–M6 + the tech bill of materials |
|
||||||
|
|
||||||
|
## Current status
|
||||||
|
- **Phase:** design complete · **stack locked** · **pre-M1** · **no application code written yet**.
|
||||||
|
- **Next step:** scaffold the repo (the "Before M1" skeleton) — *not started*.
|
||||||
|
|
||||||
|
## Stack (locked — full BOM in `docs/V1_BUILD_PLAN.md`)
|
||||||
|
- **Backend:** .NET 10 (LTS) + ASP.NET Core — modular monolith, web + worker entrypoints on one solution/image.
|
||||||
|
- **Data:** PostgreSQL 17+ + pgvector (relational + skill index + working memory + job queue, one store).
|
||||||
|
- **Agent-run queue:** Postgres `jobs` table drained with `FOR UPDATE SKIP LOCKED` by a worker `BackgroundService`.
|
||||||
|
- **AI:** BYOK over HTTP via `Microsoft.Extensions.AI`; air-gapped embeddings via ONNX.
|
||||||
|
- **Frontend:** React SPA (Vite + TypeScript) served from ASP.NET Core `wwwroot`. Next.js = marketing site only. Go = reserved for a future hot-path runner.
|
||||||
|
- **Deploy:** one Docker image (web or worker) + Postgres; air-gappable as a single unit.
|
||||||
|
|
||||||
|
## Non-negotiables (full list: `docs/CLAUDE.md` §8)
|
||||||
|
Modular monolith — no cross-module table access · web off the model path · permission check on every mutation · BYOK keys owner-only & server-side · retrieved content is data, not instructions · destructive always needs a human · skills are Git-sourced & golden-tested · instrument **human edit distance** (the north-star metric) from day one.
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
<Project>
|
||||||
|
|
||||||
|
<!-- Shared build settings for every project in the solution. -->
|
||||||
|
<PropertyGroup>
|
||||||
|
<TargetFramework>net10.0</TargetFramework>
|
||||||
|
<LangVersion>latest</LangVersion>
|
||||||
|
<Nullable>enable</Nullable>
|
||||||
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
|
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
||||||
|
<EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
|
||||||
|
<AnalysisLevel>latest-Recommended</AnalysisLevel>
|
||||||
|
<GenerateDocumentationFile>false</GenerateDocumentationFile>
|
||||||
|
<!-- CS1591: missing XML doc comment — irrelevant with docs off. -->
|
||||||
|
<NoWarn>$(NoWarn);CS1591</NoWarn>
|
||||||
|
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
|
||||||
|
<Deterministic>true</Deterministic>
|
||||||
|
<RootNamespace>$(MSBuildProjectName)</RootNamespace>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,47 @@
|
|||||||
|
<Project>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Central Package Management — the single source of truth for every NuGet version.
|
||||||
|
Projects reference packages with <PackageReference Include="..." /> and NO Version.
|
||||||
|
Versions web-verified against the live feed (mid-2026); see docs/V1_BUILD_PLAN.md BOM.
|
||||||
|
-->
|
||||||
|
<PropertyGroup>
|
||||||
|
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
|
||||||
|
<CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup Label="Persistence — EF Core 10 + Npgsql + pgvector">
|
||||||
|
<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="10.0.8" />
|
||||||
|
<PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.8" />
|
||||||
|
<PackageVersion Include="Microsoft.EntityFrameworkCore.Relational" Version="10.0.8" />
|
||||||
|
<PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.2" />
|
||||||
|
<PackageVersion Include="Pgvector" Version="0.3.2" />
|
||||||
|
<PackageVersion Include="Pgvector.EntityFrameworkCore" Version="0.3.0" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup Label="Web / API">
|
||||||
|
<PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.8" />
|
||||||
|
<PackageVersion Include="Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore" Version="10.0.8" />
|
||||||
|
<PackageVersion Include="FluentValidation" Version="12.1.1" />
|
||||||
|
<PackageVersion Include="FluentValidation.DependencyInjectionExtensions" Version="12.1.1" />
|
||||||
|
<PackageVersion Include="Riok.Mapperly" Version="4.3.1" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup Label="Observability">
|
||||||
|
<PackageVersion Include="Serilog.AspNetCore" Version="10.0.0" />
|
||||||
|
<PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="1.15.3" />
|
||||||
|
<PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.15.2" />
|
||||||
|
<PackageVersion Include="OpenTelemetry.Instrumentation.Runtime" Version="1.15.1" />
|
||||||
|
<PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.15.3" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup Label="Tests">
|
||||||
|
<PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
|
||||||
|
<PackageVersion Include="xunit.v3" Version="3.2.2" />
|
||||||
|
<PackageVersion Include="xunit.runner.visualstudio" Version="3.1.5" />
|
||||||
|
<PackageVersion Include="Testcontainers.PostgreSql" Version="4.12.0" />
|
||||||
|
<PackageVersion Include="Verify.XunitV3" Version="31.12.5" />
|
||||||
|
<PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.8" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,84 @@
|
|||||||
|
# TeamUp.AI
|
||||||
|
|
||||||
|
> **Build human + AI teams.** A live org chart that does work: model the org, fill open role-seats
|
||||||
|
> with governed AI agents, run delivery on one board. A product of **AliaSaaS**.
|
||||||
|
|
||||||
|
**Status:** pre-M1 **skeleton** — the repo builds, tests green, and runs, but carries no feature
|
||||||
|
code yet. See [`docs/V1_BUILD_PLAN.md`](docs/V1_BUILD_PLAN.md) for what M1–M6 add.
|
||||||
|
|
||||||
|
## Stack
|
||||||
|
|
||||||
|
.NET 10 modular monolith (web + worker on one image) · PostgreSQL 17 + pgvector · EF Core 10 ·
|
||||||
|
React 19 + Vite SPA into `wwwroot` · Docker Compose for local dev. Full bill of materials in
|
||||||
|
[`docs/V1_BUILD_PLAN.md`](docs/V1_BUILD_PLAN.md).
|
||||||
|
|
||||||
|
## Layout
|
||||||
|
|
||||||
|
```
|
||||||
|
src/Shared/TeamUp.SharedKernel IModule seam, base Entity, IModuleDbContext
|
||||||
|
src/Shared/TeamUp.Infrastructure PlatformDbContext (pgvector + schemas), MigrationRunner, wiring
|
||||||
|
src/Bootstrap/TeamUp.Bootstrap the explicit module catalog (the only thing that knows all modules)
|
||||||
|
src/Modules/TeamUp.Modules.* OrgBoard · Identity · Skills · Assembler · Governance · Memory · Integrations
|
||||||
|
src/Hosts/TeamUp.Web ASP.NET Core API host (also serves the SPA)
|
||||||
|
src/Hosts/TeamUp.Worker Generic Host worker (background jobs; M4+)
|
||||||
|
client/ React/Vite SPA → builds into TeamUp.Web/wwwroot
|
||||||
|
tests/ ArchitectureTests (boundary rules) · IntegrationTests (Testcontainers)
|
||||||
|
docker/ Dockerfile (one image, two roles) · docker-compose.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
**Boundary rule:** each module is its own assembly; everything but its `IModule` and public
|
||||||
|
contracts is `internal`, so no module can touch another's persistence. `TeamUp.ArchitectureTests`
|
||||||
|
backstops this — it fails the build if a module references another module / Infrastructure / a host.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
.NET SDK 10 · Node 22 · Docker. Packages and container images are pulled through a Nexus mirror —
|
||||||
|
see **Package & image sources** below.
|
||||||
|
|
||||||
|
## Quick start
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Backend: build, run the boundary + integration tests (integration needs Docker)
|
||||||
|
dotnet build TeamUp.slnx
|
||||||
|
dotnet test TeamUp.slnx
|
||||||
|
|
||||||
|
# Local dev — two terminals, with the Vite dev server proxying /api to the .NET host
|
||||||
|
docker compose -f docker/docker-compose.yml up postgres -d # Postgres 17 + pgvector
|
||||||
|
dotnet run --project src/Hosts/TeamUp.Web # http://localhost:5180 (applies migrations in Dev)
|
||||||
|
cd client && npm install && npm run dev # http://localhost:5173 (proxies /api, /health)
|
||||||
|
|
||||||
|
# Or run the whole thing in containers (web + worker + postgres, single image, RUN_MODE picks the role)
|
||||||
|
docker compose -f docker/docker-compose.yml up --build
|
||||||
|
```
|
||||||
|
|
||||||
|
`GET /health` is the DB health check; `GET /api/<module>/ping` proves each module seam; the OpenAPI
|
||||||
|
document is at `/openapi/v1.json` (Development only).
|
||||||
|
|
||||||
|
## EF Core migrations
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dotnet ef migrations add <Name> \
|
||||||
|
--project src/Shared/TeamUp.Infrastructure --startup-project src/Shared/TeamUp.Infrastructure \
|
||||||
|
--context PlatformDbContext --output-dir Persistence/Migrations
|
||||||
|
```
|
||||||
|
|
||||||
|
The initial `InitialPlatform` migration enables the `vector` extension and creates one schema per
|
||||||
|
module. Module-owned contexts (M1+) get their own migrations and apply after Platform via
|
||||||
|
`MigrationRunner`.
|
||||||
|
|
||||||
|
## Package & image sources
|
||||||
|
|
||||||
|
NuGet packages (`nuget.config`) and container base images (`docker/Dockerfile`,
|
||||||
|
`docker/docker-compose.yml`) are pulled through the self-hosted Nexus mirror
|
||||||
|
`mirror.soroushasadi.com`, which proxies nuget.org / Docker Hub / MCR and is reachable from Iran.
|
||||||
|
To build against the public registries instead, point `nuget.config` at `api.nuget.org` and replace
|
||||||
|
the `mirror.soroushasadi.com/...` image prefixes with `docker.io/library` (node) and
|
||||||
|
`mcr.microsoft.com` (dotnet). Testcontainers picks up the mirror via
|
||||||
|
`TESTCONTAINERS_HUB_IMAGE_NAME_PREFIX=mirror.soroushasadi.com/`.
|
||||||
|
|
||||||
|
## More
|
||||||
|
|
||||||
|
- [`CLAUDE.md`](CLAUDE.md) — always-loaded project index
|
||||||
|
- [`docs/CLAUDE.md`](docs/CLAUDE.md) — full architecture & domain model
|
||||||
|
- [`docs/PRODUCT.md`](docs/PRODUCT.md) — complete product model
|
||||||
|
- [`docs/V1_BUILD_PLAN.md`](docs/V1_BUILD_PLAN.md) — the V1 wedge (M1–M6) + bill of materials
|
||||||
+27
@@ -0,0 +1,27 @@
|
|||||||
|
<Solution>
|
||||||
|
<Folder Name="/src/" />
|
||||||
|
<Folder Name="/src/Bootstrap/">
|
||||||
|
<Project Path="src/Bootstrap/TeamUp.Bootstrap/TeamUp.Bootstrap.csproj" />
|
||||||
|
</Folder>
|
||||||
|
<Folder Name="/src/Hosts/">
|
||||||
|
<Project Path="src/Hosts/TeamUp.Web/TeamUp.Web.csproj" />
|
||||||
|
<Project Path="src/Hosts/TeamUp.Worker/TeamUp.Worker.csproj" />
|
||||||
|
</Folder>
|
||||||
|
<Folder Name="/src/Modules/">
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Assembler/TeamUp.Modules.Assembler.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Governance/TeamUp.Modules.Governance.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Identity/TeamUp.Modules.Identity.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Integrations/TeamUp.Modules.Integrations.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Memory/TeamUp.Modules.Memory.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.OrgBoard/TeamUp.Modules.OrgBoard.csproj" />
|
||||||
|
<Project Path="src/Modules/TeamUp.Modules.Skills/TeamUp.Modules.Skills.csproj" />
|
||||||
|
</Folder>
|
||||||
|
<Folder Name="/src/Shared/">
|
||||||
|
<Project Path="src/Shared/TeamUp.Infrastructure/TeamUp.Infrastructure.csproj" />
|
||||||
|
<Project Path="src/Shared/TeamUp.SharedKernel/TeamUp.SharedKernel.csproj" />
|
||||||
|
</Folder>
|
||||||
|
<Folder Name="/tests/">
|
||||||
|
<Project Path="tests/TeamUp.ArchitectureTests/TeamUp.ArchitectureTests.csproj" />
|
||||||
|
<Project Path="tests/TeamUp.IntegrationTests/TeamUp.IntegrationTests.csproj" />
|
||||||
|
</Folder>
|
||||||
|
</Solution>
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
lerna-debug.log*
|
||||||
|
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
dist-ssr
|
||||||
|
*.local
|
||||||
|
|
||||||
|
# Editor directories and files
|
||||||
|
.vscode/*
|
||||||
|
!.vscode/extensions.json
|
||||||
|
.idea
|
||||||
|
.DS_Store
|
||||||
|
*.suo
|
||||||
|
*.ntvs*
|
||||||
|
*.njsproj
|
||||||
|
*.sln
|
||||||
|
*.sw?
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
# React + TypeScript + Vite
|
||||||
|
|
||||||
|
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
|
||||||
|
|
||||||
|
Currently, two official plugins are available:
|
||||||
|
|
||||||
|
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
|
||||||
|
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
|
||||||
|
|
||||||
|
## React Compiler
|
||||||
|
|
||||||
|
The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
|
||||||
|
|
||||||
|
## Expanding the ESLint configuration
|
||||||
|
|
||||||
|
If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
|
||||||
|
|
||||||
|
```js
|
||||||
|
export default defineConfig([
|
||||||
|
globalIgnores(['dist']),
|
||||||
|
{
|
||||||
|
files: ['**/*.{ts,tsx}'],
|
||||||
|
extends: [
|
||||||
|
// Other configs...
|
||||||
|
|
||||||
|
// Remove tseslint.configs.recommended and replace with this
|
||||||
|
tseslint.configs.recommendedTypeChecked,
|
||||||
|
// Alternatively, use this for stricter rules
|
||||||
|
tseslint.configs.strictTypeChecked,
|
||||||
|
// Optionally, add this for stylistic rules
|
||||||
|
tseslint.configs.stylisticTypeChecked,
|
||||||
|
|
||||||
|
// Other configs...
|
||||||
|
],
|
||||||
|
languageOptions: {
|
||||||
|
parserOptions: {
|
||||||
|
project: ['./tsconfig.node.json', './tsconfig.app.json'],
|
||||||
|
tsconfigRootDir: import.meta.dirname,
|
||||||
|
},
|
||||||
|
// other options...
|
||||||
|
},
|
||||||
|
},
|
||||||
|
])
|
||||||
|
```
|
||||||
|
|
||||||
|
You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// eslint.config.js
|
||||||
|
import reactX from 'eslint-plugin-react-x'
|
||||||
|
import reactDom from 'eslint-plugin-react-dom'
|
||||||
|
|
||||||
|
export default defineConfig([
|
||||||
|
globalIgnores(['dist']),
|
||||||
|
{
|
||||||
|
files: ['**/*.{ts,tsx}'],
|
||||||
|
extends: [
|
||||||
|
// Other configs...
|
||||||
|
// Enable lint rules for React
|
||||||
|
reactX.configs['recommended-typescript'],
|
||||||
|
// Enable lint rules for React DOM
|
||||||
|
reactDom.configs.recommended,
|
||||||
|
],
|
||||||
|
languageOptions: {
|
||||||
|
parserOptions: {
|
||||||
|
project: ['./tsconfig.node.json', './tsconfig.app.json'],
|
||||||
|
tsconfigRootDir: import.meta.dirname,
|
||||||
|
},
|
||||||
|
// other options...
|
||||||
|
},
|
||||||
|
},
|
||||||
|
])
|
||||||
|
```
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import js from '@eslint/js'
|
||||||
|
import globals from 'globals'
|
||||||
|
import reactHooks from 'eslint-plugin-react-hooks'
|
||||||
|
import reactRefresh from 'eslint-plugin-react-refresh'
|
||||||
|
import tseslint from 'typescript-eslint'
|
||||||
|
import { defineConfig, globalIgnores } from 'eslint/config'
|
||||||
|
|
||||||
|
export default defineConfig([
|
||||||
|
globalIgnores(['dist']),
|
||||||
|
{
|
||||||
|
files: ['**/*.{ts,tsx}'],
|
||||||
|
extends: [
|
||||||
|
js.configs.recommended,
|
||||||
|
tseslint.configs.recommended,
|
||||||
|
reactHooks.configs.flat.recommended,
|
||||||
|
reactRefresh.configs.vite,
|
||||||
|
],
|
||||||
|
languageOptions: {
|
||||||
|
globals: globals.browser,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
])
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8" />
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
<title>TeamUp.AI</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="root"></div>
|
||||||
|
<script type="module" src="/src/main.tsx"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Generated
+4492
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,41 @@
|
|||||||
|
{
|
||||||
|
"name": "client",
|
||||||
|
"private": true,
|
||||||
|
"version": "0.0.0",
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"dev": "vite",
|
||||||
|
"build": "tsc -b && vite build",
|
||||||
|
"lint": "eslint .",
|
||||||
|
"preview": "vite preview"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@dnd-kit/core": "^6.3.1",
|
||||||
|
"@hookform/resolvers": "^5.4.0",
|
||||||
|
"@tanstack/react-query": "^5.101.0",
|
||||||
|
"@xyflow/react": "^12.11.0",
|
||||||
|
"react": "^19.2.6",
|
||||||
|
"react-dom": "^19.2.6",
|
||||||
|
"react-hook-form": "^7.78.0",
|
||||||
|
"react-router": "^7.17.0",
|
||||||
|
"recharts": "^3.8.1",
|
||||||
|
"zod": "^4.4.3",
|
||||||
|
"zustand": "^5.0.14"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@eslint/js": "^10.0.1",
|
||||||
|
"@tailwindcss/vite": "^4.3.0",
|
||||||
|
"@types/node": "^24.12.3",
|
||||||
|
"@types/react": "^19.2.14",
|
||||||
|
"@types/react-dom": "^19.2.3",
|
||||||
|
"@vitejs/plugin-react": "^4.7.0",
|
||||||
|
"eslint": "^10.3.0",
|
||||||
|
"eslint-plugin-react-hooks": "^7.1.1",
|
||||||
|
"eslint-plugin-react-refresh": "^0.5.2",
|
||||||
|
"globals": "^17.6.0",
|
||||||
|
"tailwindcss": "^4.3.0",
|
||||||
|
"typescript": "~6.0.2",
|
||||||
|
"typescript-eslint": "^8.59.2",
|
||||||
|
"vite": "^6.4.3"
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 9.3 KiB |
@@ -0,0 +1,24 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<symbol id="bluesky-icon" viewBox="0 0 16 17">
|
||||||
|
<g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
|
||||||
|
<defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="discord-icon" viewBox="0 0 20 19">
|
||||||
|
<path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="documentation-icon" viewBox="0 0 21 20">
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="github-icon" viewBox="0 0 19 19">
|
||||||
|
<path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="social-icon" viewBox="0 0 20 20">
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="x-icon" viewBox="0 0 19 19">
|
||||||
|
<path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
|
||||||
|
</symbol>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 4.9 KiB |
@@ -0,0 +1,184 @@
|
|||||||
|
.counter {
|
||||||
|
font-size: 16px;
|
||||||
|
padding: 5px 10px;
|
||||||
|
border-radius: 5px;
|
||||||
|
color: var(--accent);
|
||||||
|
background: var(--accent-bg);
|
||||||
|
border: 2px solid transparent;
|
||||||
|
transition: border-color 0.3s;
|
||||||
|
margin-bottom: 24px;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
border-color: var(--accent-border);
|
||||||
|
}
|
||||||
|
&:focus-visible {
|
||||||
|
outline: 2px solid var(--accent);
|
||||||
|
outline-offset: 2px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero {
|
||||||
|
position: relative;
|
||||||
|
|
||||||
|
.base,
|
||||||
|
.framework,
|
||||||
|
.vite {
|
||||||
|
inset-inline: 0;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.base {
|
||||||
|
width: 170px;
|
||||||
|
position: relative;
|
||||||
|
z-index: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.framework,
|
||||||
|
.vite {
|
||||||
|
position: absolute;
|
||||||
|
}
|
||||||
|
|
||||||
|
.framework {
|
||||||
|
z-index: 1;
|
||||||
|
top: 34px;
|
||||||
|
height: 28px;
|
||||||
|
transform: perspective(2000px) rotateZ(300deg) rotateX(44deg) rotateY(39deg)
|
||||||
|
scale(1.4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.vite {
|
||||||
|
z-index: 0;
|
||||||
|
top: 107px;
|
||||||
|
height: 26px;
|
||||||
|
width: auto;
|
||||||
|
transform: perspective(2000px) rotateZ(300deg) rotateX(40deg) rotateY(39deg)
|
||||||
|
scale(0.8);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#center {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 25px;
|
||||||
|
place-content: center;
|
||||||
|
place-items: center;
|
||||||
|
flex-grow: 1;
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
padding: 32px 20px 24px;
|
||||||
|
gap: 18px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#next-steps {
|
||||||
|
display: flex;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
text-align: left;
|
||||||
|
|
||||||
|
& > div {
|
||||||
|
flex: 1 1 0;
|
||||||
|
padding: 32px;
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
padding: 24px 20px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon {
|
||||||
|
margin-bottom: 16px;
|
||||||
|
width: 22px;
|
||||||
|
height: 22px;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
flex-direction: column;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#docs {
|
||||||
|
border-right: 1px solid var(--border);
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
border-right: none;
|
||||||
|
border-bottom: 1px solid var(--border);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#next-steps ul {
|
||||||
|
list-style: none;
|
||||||
|
padding: 0;
|
||||||
|
display: flex;
|
||||||
|
gap: 8px;
|
||||||
|
margin: 32px 0 0;
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
height: 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
color: var(--text-h);
|
||||||
|
font-size: 16px;
|
||||||
|
border-radius: 6px;
|
||||||
|
background: var(--social-bg);
|
||||||
|
display: flex;
|
||||||
|
padding: 6px 12px;
|
||||||
|
align-items: center;
|
||||||
|
gap: 8px;
|
||||||
|
text-decoration: none;
|
||||||
|
transition: box-shadow 0.3s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
box-shadow: var(--shadow);
|
||||||
|
}
|
||||||
|
.button-icon {
|
||||||
|
height: 18px;
|
||||||
|
width: 18px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
margin-top: 20px;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
justify-content: center;
|
||||||
|
|
||||||
|
li {
|
||||||
|
flex: 1 1 calc(50% - 8px);
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
width: 100%;
|
||||||
|
justify-content: center;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#spacer {
|
||||||
|
height: 88px;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
height: 48px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.ticks {
|
||||||
|
position: relative;
|
||||||
|
width: 100%;
|
||||||
|
|
||||||
|
&::before,
|
||||||
|
&::after {
|
||||||
|
content: '';
|
||||||
|
position: absolute;
|
||||||
|
top: -4.5px;
|
||||||
|
border: 5px solid transparent;
|
||||||
|
}
|
||||||
|
|
||||||
|
&::before {
|
||||||
|
left: 0;
|
||||||
|
border-left-color: var(--border);
|
||||||
|
}
|
||||||
|
&::after {
|
||||||
|
right: 0;
|
||||||
|
border-right-color: var(--border);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,83 @@
|
|||||||
|
import { useEffect, useState } from 'react'
|
||||||
|
|
||||||
|
const MODULES = [
|
||||||
|
'identity',
|
||||||
|
'orgboard',
|
||||||
|
'skills',
|
||||||
|
'integrations',
|
||||||
|
'memory',
|
||||||
|
'assembler',
|
||||||
|
'governance',
|
||||||
|
] as const
|
||||||
|
|
||||||
|
type Status = boolean | null // null = checking
|
||||||
|
|
||||||
|
function StatusDot({ ok }: { ok: Status }) {
|
||||||
|
const color = ok === null ? 'bg-amber-400' : ok ? 'bg-teal-400' : 'bg-rose-500'
|
||||||
|
return <span className={`inline-block h-2.5 w-2.5 rounded-full ${color}`} aria-hidden />
|
||||||
|
}
|
||||||
|
|
||||||
|
export default function App() {
|
||||||
|
const [health, setHealth] = useState<Status>(null)
|
||||||
|
const [modules, setModules] = useState<Record<string, Status>>(
|
||||||
|
Object.fromEntries(MODULES.map((m) => [m, null])),
|
||||||
|
)
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
fetch('/health')
|
||||||
|
.then((r) => setHealth(r.ok))
|
||||||
|
.catch(() => setHealth(false))
|
||||||
|
|
||||||
|
MODULES.forEach((m) => {
|
||||||
|
fetch(`/api/${m}/ping`)
|
||||||
|
.then((r) => setModules((s) => ({ ...s, [m]: r.ok })))
|
||||||
|
.catch(() => setModules((s) => ({ ...s, [m]: false })))
|
||||||
|
})
|
||||||
|
}, [])
|
||||||
|
|
||||||
|
return (
|
||||||
|
<main className="min-h-screen bg-indigo-950 text-slate-100">
|
||||||
|
<div className="mx-auto flex min-h-screen max-w-3xl flex-col justify-center px-6 py-16">
|
||||||
|
<p className="text-sm font-medium uppercase tracking-widest text-indigo-300">
|
||||||
|
A product of AliaSaaS
|
||||||
|
</p>
|
||||||
|
<h1 className="mt-2 text-5xl font-bold tracking-tight">TeamUp.AI</h1>
|
||||||
|
<p className="mt-3 text-lg text-indigo-200">
|
||||||
|
Build human + AI teams. A live org chart that does work.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div className="mt-10 rounded-xl border border-indigo-800/60 bg-indigo-900/40 p-5">
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<span className="font-medium">API health</span>
|
||||||
|
<span className="flex items-center gap-2 text-sm text-indigo-200">
|
||||||
|
<StatusDot ok={health} />
|
||||||
|
{health === null ? 'checking…' : health ? 'healthy' : 'unreachable'}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<h2 className="mt-10 text-sm font-semibold uppercase tracking-widest text-indigo-300">
|
||||||
|
Modules
|
||||||
|
</h2>
|
||||||
|
<ul className="mt-3 grid grid-cols-1 gap-2 sm:grid-cols-2">
|
||||||
|
{MODULES.map((m) => (
|
||||||
|
<li
|
||||||
|
key={m}
|
||||||
|
className="flex items-center justify-between rounded-lg border border-indigo-800/50 bg-indigo-900/30 px-4 py-2.5"
|
||||||
|
>
|
||||||
|
<span className="capitalize">{m}</span>
|
||||||
|
<span className="flex items-center gap-2 text-sm text-indigo-200">
|
||||||
|
<StatusDot ok={modules[m]} />
|
||||||
|
{modules[m] === null ? '…' : modules[m] ? 'ok' : 'down'}
|
||||||
|
</span>
|
||||||
|
</li>
|
||||||
|
))}
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p className="mt-12 text-xs text-indigo-400">
|
||||||
|
Pre-M1 skeleton · web + worker on one modular monolith · PostgreSQL 17 + pgvector
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
)
|
||||||
|
}
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
@@ -0,0 +1 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>
|
||||||
|
After Width: | Height: | Size: 4.0 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 8.5 KiB |
@@ -0,0 +1,10 @@
|
|||||||
|
@import "tailwindcss";
|
||||||
|
|
||||||
|
:root {
|
||||||
|
color-scheme: dark;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
font-family: "Hanken Grotesk", system-ui, sans-serif;
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
import { StrictMode } from 'react'
|
||||||
|
import { createRoot } from 'react-dom/client'
|
||||||
|
import './index.css'
|
||||||
|
import App from './App.tsx'
|
||||||
|
|
||||||
|
createRoot(document.getElementById('root')!).render(
|
||||||
|
<StrictMode>
|
||||||
|
<App />
|
||||||
|
</StrictMode>,
|
||||||
|
)
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
||||||
|
"target": "es2023",
|
||||||
|
"lib": ["ES2023", "DOM"],
|
||||||
|
"module": "esnext",
|
||||||
|
"types": ["vite/client"],
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
"jsx": "react-jsx",
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["src"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"files": [],
|
||||||
|
"references": [
|
||||||
|
{ "path": "./tsconfig.app.json" },
|
||||||
|
{ "path": "./tsconfig.node.json" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
||||||
|
"target": "es2023",
|
||||||
|
"lib": ["ES2023"],
|
||||||
|
"module": "esnext",
|
||||||
|
"types": ["node"],
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["vite.config.ts"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
import { defineConfig } from 'vite'
|
||||||
|
import react from '@vitejs/plugin-react'
|
||||||
|
import tailwindcss from '@tailwindcss/vite'
|
||||||
|
|
||||||
|
// https://vite.dev/config/
|
||||||
|
// Dev: the Vite dev server (5173) proxies API/health/openapi to the .NET web host (5180).
|
||||||
|
// Prod: `npm run build` emits ./dist, which the .NET publish step / Docker copies into wwwroot.
|
||||||
|
export default defineConfig({
|
||||||
|
plugins: [react(), tailwindcss()],
|
||||||
|
server: {
|
||||||
|
port: 5173,
|
||||||
|
proxy: {
|
||||||
|
'/api': { target: 'http://localhost:5180', changeOrigin: true },
|
||||||
|
'/health': { target: 'http://localhost:5180', changeOrigin: true },
|
||||||
|
'/openapi': { target: 'http://localhost:5180', changeOrigin: true },
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
# syntax=docker/dockerfile:1
|
||||||
|
#
|
||||||
|
# One image, two roles. RUN_MODE (web|worker) selects the binary at the entrypoint.
|
||||||
|
# Build context is the repo root (see docker-compose.yml: context: ..).
|
||||||
|
|
||||||
|
# Base images are pulled through Soroush's Nexus Docker proxy group (mirror.soroushasadi.com),
|
||||||
|
# reachable from Iran. To build against public registries instead, replace the mirror prefixes
|
||||||
|
# with docker.io/library (node) and mcr.microsoft.com (dotnet).
|
||||||
|
|
||||||
|
# ---- Stage 1: build the React/Vite SPA ----
|
||||||
|
FROM mirror.soroushasadi.com/node:22-bookworm-slim AS client
|
||||||
|
WORKDIR /client
|
||||||
|
COPY client/package.json client/package-lock.json ./
|
||||||
|
RUN npm ci
|
||||||
|
COPY client/ ./
|
||||||
|
RUN npm run build
|
||||||
|
|
||||||
|
# ---- Stage 2: restore + publish BOTH hosts into /app ----
|
||||||
|
FROM mirror.soroushasadi.com/dotnet/sdk:10.0 AS build
|
||||||
|
WORKDIR /src
|
||||||
|
COPY Directory.Build.props Directory.Packages.props nuget.config global.json ./
|
||||||
|
COPY src/ ./src/
|
||||||
|
RUN dotnet restore src/Hosts/TeamUp.Web/TeamUp.Web.csproj
|
||||||
|
RUN dotnet restore src/Hosts/TeamUp.Worker/TeamUp.Worker.csproj
|
||||||
|
# Skip the web project's npm client target (-p:BuildClient=false) — the SPA is built in stage 1.
|
||||||
|
RUN dotnet publish src/Hosts/TeamUp.Web/TeamUp.Web.csproj -c Release -o /app --no-restore -p:BuildClient=false
|
||||||
|
RUN dotnet publish src/Hosts/TeamUp.Worker/TeamUp.Worker.csproj -c Release -o /app --no-restore
|
||||||
|
# Drop the built SPA into the served wwwroot.
|
||||||
|
COPY --from=client /client/dist /app/wwwroot
|
||||||
|
|
||||||
|
# ---- Stage 3: runtime ----
|
||||||
|
# aspnet:10.0 (Ubuntu Noble) has a shell so the entrypoint can branch on RUN_MODE, and avoids any
|
||||||
|
# tag-availability risk. For prod you can switch to a chiseled tag and select the role via the
|
||||||
|
# container command/args instead (chiseled images have no shell).
|
||||||
|
FROM mirror.soroushasadi.com/dotnet/aspnet:10.0 AS final
|
||||||
|
WORKDIR /app
|
||||||
|
COPY --from=build /app ./
|
||||||
|
COPY docker/entrypoint.sh /app/entrypoint.sh
|
||||||
|
RUN chmod +x /app/entrypoint.sh
|
||||||
|
ENV RUN_MODE=web \
|
||||||
|
ASPNETCORE_HTTP_PORTS=8080
|
||||||
|
EXPOSE 8080
|
||||||
|
USER $APP_UID
|
||||||
|
ENTRYPOINT ["/app/entrypoint.sh"]
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
# One-command local dev: Postgres (pgvector) + the web and worker roles of the single image.
|
||||||
|
# docker compose -f docker/docker-compose.yml up --build
|
||||||
|
name: teamup
|
||||||
|
|
||||||
|
services:
|
||||||
|
postgres:
|
||||||
|
# Pulled via the Nexus Docker proxy (reachable from Iran); upstream is docker.io/pgvector/pgvector.
|
||||||
|
image: mirror.soroushasadi.com/pgvector/pgvector:pg17
|
||||||
|
environment:
|
||||||
|
POSTGRES_DB: teamup
|
||||||
|
POSTGRES_USER: teamup
|
||||||
|
POSTGRES_PASSWORD: teamup
|
||||||
|
ports:
|
||||||
|
- "5432:5432"
|
||||||
|
volumes:
|
||||||
|
- pgdata:/var/lib/postgresql/data
|
||||||
|
- ./postgres-init.sh:/docker-entrypoint-initdb.d/01-init-vector.sh:ro
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U teamup -d teamup"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 5
|
||||||
|
start_period: 20s
|
||||||
|
|
||||||
|
web:
|
||||||
|
build:
|
||||||
|
context: ..
|
||||||
|
dockerfile: docker/Dockerfile
|
||||||
|
environment:
|
||||||
|
ASPNETCORE_ENVIRONMENT: Development
|
||||||
|
ASPNETCORE_HTTP_PORTS: "8080"
|
||||||
|
RUN_MODE: web
|
||||||
|
ConnectionStrings__Postgres: "Host=postgres;Port=5432;Database=teamup;Username=teamup;Password=teamup"
|
||||||
|
# The web role applies migrations; the worker waits (EF's DB-wide lock makes it safe either way).
|
||||||
|
Database__ApplyMigrationsOnStartup: "true"
|
||||||
|
ports:
|
||||||
|
- "8080:8080"
|
||||||
|
depends_on:
|
||||||
|
postgres:
|
||||||
|
condition: service_healthy
|
||||||
|
|
||||||
|
worker:
|
||||||
|
build:
|
||||||
|
context: ..
|
||||||
|
dockerfile: docker/Dockerfile
|
||||||
|
environment:
|
||||||
|
ASPNETCORE_ENVIRONMENT: Development
|
||||||
|
RUN_MODE: worker
|
||||||
|
ConnectionStrings__Postgres: "Host=postgres;Port=5432;Database=teamup;Username=teamup;Password=teamup"
|
||||||
|
Database__ApplyMigrationsOnStartup: "false"
|
||||||
|
depends_on:
|
||||||
|
postgres:
|
||||||
|
condition: service_healthy
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
pgdata:
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# One image, two roles. RUN_MODE selects which host binary to run (default: web).
|
||||||
|
set -e
|
||||||
|
|
||||||
|
if [ "$RUN_MODE" = "worker" ]; then
|
||||||
|
exec dotnet /app/TeamUp.Worker.dll
|
||||||
|
else
|
||||||
|
exec dotnet /app/TeamUp.Web.dll
|
||||||
|
fi
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Runs once on first DB init. Enables pgvector at the database level. The platform EF migration
|
||||||
|
# also runs CREATE EXTENSION (idempotent); this guarantees it even if migrations are disabled.
|
||||||
|
set -e
|
||||||
|
|
||||||
|
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-'EOSQL'
|
||||||
|
CREATE EXTENSION IF NOT EXISTS vector;
|
||||||
|
EOSQL
|
||||||
+130
@@ -0,0 +1,130 @@
|
|||||||
|
# TeamUp.AI — Project Memory
|
||||||
|
|
||||||
|
> **Build human + AI teams.** Model your organization, fill open role-seats with governed AI agents that do the work, and run delivery on one board where humans and AI work side by side.
|
||||||
|
>
|
||||||
|
> A product of **AliaSaaS**. This file is the always-loaded context for Claude Code. Read `docs/PRODUCT.md` for the full model and `docs/V1_BUILD_PLAN.md` for what to build now.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. What this is
|
||||||
|
|
||||||
|
Small/mid software orgs rarely staff every role — often no product owner, no dedicated QA, no reviewer — so developers absorb that work and quality suffers. Existing AI tools sit in one developer's editor as a single helper; they have no concept of a *team*, no *role coverage*, no *governance*, and the work still lives in a separate tool.
|
||||||
|
|
||||||
|
TeamUp.AI is a **live org chart that does work, on a board the team already runs delivery on**. You model the org; any open *seat* (a role) can be filled by an AI *agent* that is equipped with skills, given documents, granted tools, governed by an autonomy setting, and put to work — producing real output routed to a human review queue.
|
||||||
|
|
||||||
|
It is also a **lightweight project-management framework**: the AI Product Owner writes a spec *and* generates child stories as real tasks on the board; the AI QA picks up a build and posts pass/fail; work flows backlog → done with assignees that are human or AI.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. The bet (what V1 exists to prove)
|
||||||
|
|
||||||
|
> **"For a Product Owner and a QA role, an AI agent produces output a human accepts with little editing — saving more time than supervising it costs."**
|
||||||
|
|
||||||
|
Measured, not asserted. Primary metric: **human edit distance** (how much a reviewer changes output before approving). Instrumented from **M1**, not at the end. If it's low and falling across a sprint inside AliaSaaS, the product is real. If not, we learned cheaply.
|
||||||
|
|
||||||
|
**Strategy: architect broad, build narrow, market narrow.** The full model (divisions, MCP, marketplace, custom model) is in `docs/PRODUCT.md` and the data model accommodates it — but V1 builds only the wedge below.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. V1 scope
|
||||||
|
|
||||||
|
**In V1:**
|
||||||
|
- Org → one product → one team → seats (human / open / AI)
|
||||||
|
- Two AI roles: **Product Owner** and **QA**
|
||||||
|
- The **board**: backlog → in progress → in review → done; tasks assigned to humans or AI
|
||||||
|
- **Skill registry** (Git-indexed) with ~4 atoms
|
||||||
|
- **Assembler + worker**; prompt caching
|
||||||
|
- **Autonomy dial**, **review inbox**, audit log
|
||||||
|
- **Access control** (roles × scope) and the **cartable** (each person's pending-work inbox)
|
||||||
|
- **BYOK** API config; per-seat model
|
||||||
|
- Team **working memory** (basic)
|
||||||
|
|
||||||
|
**Deferred (architected for, not built in V1):** divisions UI & non-engineering roles; multiple products & multi-tenant billing; per-agent MCP tool-calling & Git write-back; episodic/semantic memory; the gap finder; skill studio UI, template builder, tier enforcement, AI skill-suggestion; the skill/MCP marketplace; the custom TeamUp model; SSO/SCIM; cross-team event mesh beyond the single PO→QA trigger.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Architecture (decided)
|
||||||
|
|
||||||
|
**Modular monolith + a background worker, on PostgreSQL. Not microservices.**
|
||||||
|
|
||||||
|
- **One deployable**, internally divided into modules with explicit interfaces — modules call each other through interfaces, **never** by reaching into another module's tables. This is the discipline that keeps the monolith modular and the extraction path clean.
|
||||||
|
- **The one split:** a **web/API** process and a **worker** process share the same codebase and the same Postgres DB; agent runs are enqueued on a **Postgres-backed job queue** and run in the worker, off the request path. This is the standard web+worker pattern, not microservices.
|
||||||
|
- **Why not microservices now:** the domain is small, its boundaries are still unknown, and the distributed-systems tax (network hops, eventual consistency, partial failure, service discovery, distributed tracing) is pure overhead while we're proving the bet. Extract a module to a service **only on a measured signal** (the agent-runtime under load is the likely first candidate; a compliance boundary for future model training is another).
|
||||||
|
- **Deployment:** one application image (run as web or worker via entrypoint) + PostgreSQL. Self-hostable and **air-gappable** as a single unit (important for the Iranian market).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Tech stack (locked)
|
||||||
|
|
||||||
|
One backend language: **.NET**. Library-level bill of materials in `docs/V1_BUILD_PLAN.md` § *Tech stack & bill of materials*.
|
||||||
|
|
||||||
|
| Layer | Choice | Notes |
|
||||||
|
|---|---|---|
|
||||||
|
| Backend | **.NET 10 (LTS) + ASP.NET Core** | Modular monolith. Chosen for enforceable module boundaries, the native web+worker host, and self-contained air-gapped images. **Go** reserved for a future hot-path runner; **Python** only as an optional sidecar if AI tooling ever demands it. |
|
||||||
|
| Worker | Same codebase, separate entrypoint (Generic Host `BackgroundService`) | Web + worker, one image, one DB — not a second stack |
|
||||||
|
| Data | **PostgreSQL 17+ + pgvector** | Relational data, skill index, working-memory embeddings, and the job queue — one store |
|
||||||
|
| Frontend | **React SPA (Vite + TypeScript)**, served as static files from ASP.NET Core | Keeps the deployable a single unit. **Next.js** reserved for the public marketing site only (outside the air-gapped product). TeamUp.AI design system applies (see `docs/PRODUCT.md` §design) |
|
||||||
|
| Git | **Gitea** (read-only in V1) | Skills source + code context; provider-agnostic adapter |
|
||||||
|
| Models | **BYOK** over HTTP (OpenAI / Anthropic / Vertex / Ollama) via `Microsoft.Extensions.AI` | No token COGS, no lock-in, sanctions-safe |
|
||||||
|
| Deploy | One Docker image (web or worker via entrypoint) + Postgres, on Kubernetes | Air-gappable single unit |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Domain model (core entities)
|
||||||
|
|
||||||
|
`Member` (invited human) · `Membership` (member × scope × role) · `Team` / `Seat` (`seat.state = human | open | ai`) · `Agent` (config of an AI seat: skills, autonomy, api_config_id, docs) · `Task` (type, status, `assignee = member | agent`, parent, provenance) · `Skill` (Git-indexed atom: id, version, roles[], visibility, min_tier) · `TeamTemplate` / `DivisionTemplate` (reusable rosters/layouts) · `ApiConfig` (BYOK: name, provider, model, encrypted key) · `AgentRun` (one execution + trace) · `ReviewItem` (held action: risk, decision, edit_distance) · `MemoryEntry` (team working memory) · `AuditEntry` (immutable log).
|
||||||
|
|
||||||
|
Tenant fields are present from the start so multi-tenant is a later switch, not a migration. Humans and AI share **one task model** — the assignee is simply a member or an agent.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Modules (all in the monolith, interface-bounded)
|
||||||
|
|
||||||
|
- **Org & board** — org, products, teams, seats, the task/board model
|
||||||
|
- **Identity & access** — members, memberships, roles, permission enforcement
|
||||||
|
- **Skills** — Git sync, the queryable atom index, versioning, the eval harness
|
||||||
|
- **Assembler** — context assembly, model call, output parsing, prompt caching (runs in the worker)
|
||||||
|
- **Governance** — autonomy, the action gate, review inbox, audit log
|
||||||
|
- **Memory** — team-scoped working memory (read at assembly, written on approval)
|
||||||
|
- **Integrations** — BYOK API configs, Git connection, encrypted-credential store
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Conventions — how to work in this repo
|
||||||
|
|
||||||
|
- **Keep the monolith modular.** Each module exposes an interface; do **not** read another module's tables directly. This is non-negotiable — it's what makes later extraction possible.
|
||||||
|
- **Web stays off the model path.** Anything that calls a model goes through the worker via the job queue.
|
||||||
|
- **Permission check on every mutating action**, at the relevant scope. Never trust the UI for authorization — enforce in the API.
|
||||||
|
- **BYOK keys are owner-only.** Encrypted at rest, used server-side only, **never** returned to any client after save. Team owners *assign* a config; they never see the key.
|
||||||
|
- **Instrument edit distance from day one** — it's the product's north-star metric, not an afterthought.
|
||||||
|
- **Skills are `SKILL.md` in Git** (source of truth), projected into Postgres by a sync worker on push. Each skill carries golden tests; **gate publishing on passing tests**.
|
||||||
|
- **Security:** treat retrieved content (code, docs, PR text) as **data, not instructions**. **Destructive actions always require a human**, whatever the autonomy level — the action gate is the backstop.
|
||||||
|
- **Risk lives on the action** (read / draft / publish / destructive), not on the agent. The autonomy dial (draft / gated / autonomous) decides whether an action executes or waits in the review inbox.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Current status & next step
|
||||||
|
|
||||||
|
Design phase complete (product, architecture, access, admin/authoring, UI). **Stack locked** (§5; full BOM in the build plan). **Next: scaffold the repo** — one .NET solution with web + worker entrypoints, Postgres + pgvector, React/Vite SPA into `wwwroot`, one-command `docker compose` dev — then build **M1** (see `docs/V1_BUILD_PLAN.md`). No application code written yet.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Open decisions
|
||||||
|
|
||||||
|
1. **Per-agent MCP in V1?** Recommended **Phase 1** (V1 actions are internal: create tasks, write spec/test; Git read-only). The action gate is built so adding MCP later is configuration, not a redesign.
|
||||||
|
2. **Delegated approver role** — let a senior member approve without full team-owner rights? Kept out of V1; add early if the org works that way.
|
||||||
|
|
||||||
|
*Resolved: backend language → **.NET 10 / ASP.NET Core**, frontend → **React SPA**, agent-run queue → Postgres `SKIP LOCKED` (see §5 and the build-plan BOM).*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. Design language (summary)
|
||||||
|
|
||||||
|
A **calm command center**: deep indigo sidebar, light content, color rationed so it always means something. The **seat-state triad is load-bearing** — human = slate, open = amber, AI = indigo — used on avatars, pills, bars, board cards. Teal = approved/good; amber = open/held; red = destructive only. The **autonomy dial** is a recurring color-graded control (draft slate → gated indigo → auto teal). Two trust surfaces get the most polish: **agent identity** (name, voice, work history) and the **review inbox** (with an expandable reasoning trace). Production font: Hanken Grotesk. Full hi-fi mockups exist (see deliverables index).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Design-phase deliverables (reference, not in-repo)
|
||||||
|
|
||||||
|
These were produced during design and live outside the codebase; treat them as background:
|
||||||
|
`TeamUp_V1_Solution_Document.docx` (the V1 spec — authoritative), `TeamUp_Business_Plan.docx`, `TeamUp_Business_Model_Canvas.pdf`, `TeamUp_Pitch_Deck.pptx`, `TeamUp_UI_HiFi.html/.pdf` (the design language), `TeamUp_Wireframes.html/.pdf`, `TeamUp_Divisions_Design.pdf`. `docs/PRODUCT.md` and `docs/V1_BUILD_PLAN.md` distill all of it for the build.
|
||||||
+167
@@ -0,0 +1,167 @@
|
|||||||
|
# TeamUp.AI — Product Model & Decisions
|
||||||
|
|
||||||
|
The full design. `CLAUDE.md` is the always-loaded summary; this is the reference for the complete model (including the parts deferred past V1). Phasing is noted per area.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Object spine (6 layers)
|
||||||
|
|
||||||
|
```
|
||||||
|
Organization → Division → Product / Service → Team → Seat → Agent
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Organization** — the company (e.g. AliaSaaS).
|
||||||
|
- **Division** — Technical, Finance, HR, Sales & Marketing, Operations. *(Phase 1 UI; data model from the start.)*
|
||||||
|
- **Product / Service** — engineering divisions organize around **products** (IPNOPS, Parsvice, …); other divisions around **services** (Payroll, Recruiting, …). Same entity, a `kind` tag.
|
||||||
|
- **Team** — within a product/service; has a team type (template) seeding its default seats.
|
||||||
|
- **Seat** — a role in one of three states: **human / open / AI**. A role = a name + reusable, versioned skill atoms, so any role on any team type can be AI-filled.
|
||||||
|
- **Agent** — the AI staffing a seat: identity (name, monogram, voice, work history) + skills + tools + docs + autonomy + model.
|
||||||
|
|
||||||
|
Everything below the division works unchanged per division. Humans and AI share one task model.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Skills
|
||||||
|
|
||||||
|
- **Atomic and versioned.** Authored as `SKILL.md` (YAML frontmatter + markdown body) in **Git (source of truth)**, projected to Postgres (queryable index) by a sync worker on push webhook.
|
||||||
|
- **Frontmatter:** `id, name, version, roles[], inputs/outputs (I/O contract), actions (each risk-tagged: read/draft/publish/destructive), tools, context, visibility, min_tier`.
|
||||||
|
- **Compose into seats.** A seat's behavior = house style + identity/overrides + its matched atoms. Suggested starting sets are UX scaffolding, not a "pack" entity.
|
||||||
|
- **Eval:** golden tests per skill; quality metric = human edit distance; **publishing is gated on passing tests**.
|
||||||
|
- **Free vs tier-based:** `visibility` (public | private-to-org) and `min_tier` (free/Team/Scale/Enterprise). Orgs see/assign only what their tier entitles + their private ones; higher-tier skills show locked with an upgrade prompt. *(Enforcement Phase 1.)*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Autonomy, the action gate & review
|
||||||
|
|
||||||
|
- **Autonomy dial** — per seat, set by the team owner: **draft-only / gated / autonomous**.
|
||||||
|
- **Risk lives on the action**, not the agent. The gate compares the seat's autonomy to the action's risk: execute, or hold.
|
||||||
|
- **Destructive actions always require a human**, whatever the autonomy level — the gate is the backstop (also the prompt-injection backstop).
|
||||||
|
- **Review inbox** — held actions wait here; **approve / edit-and-approve / send back**. Edit-and-approve feeds the edit-distance metric and the future model. Each item carries an expandable **reasoning trace** (skills fired, context, memory, intended action) so approval is informed, never blind. This is the trust centerpiece and a competitive differentiator.
|
||||||
|
- **Audit log** — every decision recorded immutably.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## The cartable & responsibilities
|
||||||
|
|
||||||
|
Each person has a **cartable**: a single personal inbox of everything awaiting their action across all their teams. A **derived view**, not new storage.
|
||||||
|
|
||||||
|
| Item | What it is | Who sees it |
|
||||||
|
|---|---|---|
|
||||||
|
| Task | A board task assigned to me | anyone in a seat |
|
||||||
|
| Approval | A held AI action routed to me | team owners |
|
||||||
|
| Input needed | An agent/teammate needs my answer mid-task | the person asked |
|
||||||
|
| Handoff | Work arriving from another team, awaiting acceptance | receiving owner |
|
||||||
|
| Sent back / mention | Returned to me, or where I'm named | the person named |
|
||||||
|
|
||||||
|
The **board** is the team's shared view; the **cartable** is one person's pending slice; the **review inbox is the Approvals section of an owner's cartable** (members without approval rights don't see it). Responsibilities = the seats a person holds.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Access / RBAC
|
||||||
|
|
||||||
|
**Access = role × scope.** Roles are granted at a scope (org / division / product / team); memberships are additive.
|
||||||
|
|
||||||
|
| Capability | Owner | Team owner | Member | Viewer |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| Billing & plan | ✓ | — | — | — |
|
||||||
|
| Manage API keys (BYOK) | ✓ | assign only | — | — |
|
||||||
|
| Invite / remove people | ✓ | team | — | — |
|
||||||
|
| Create products / teams | ✓ | own team | — | — |
|
||||||
|
| Configure agents | ✓ | own team | — | — |
|
||||||
|
| Set autonomy dial | ✓ | own team | — | — |
|
||||||
|
| Approve held / destructive | ✓ | own team | — | — |
|
||||||
|
| Create & work tasks; chat | ✓ | ✓ | ✓ | — |
|
||||||
|
| View board & outputs | ✓ | ✓ | ✓ | ✓ |
|
||||||
|
| View audit log | ✓ | own team | — | — |
|
||||||
|
|
||||||
|
**API keys are owner-only** (assign-only for team owners; keys never returned to a client; enforced server-side). V1 uses org + team scopes; division-lead role activates with the divisions layer. Deferred: SSO/SCIM, custom roles, delegated approver, division-scoped delegation.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Built-in project management
|
||||||
|
|
||||||
|
- **Board** with backlog → assigned → in progress → in review → done. **Tasks** have type (spec / story / test / review / release), status, assignee (human or AI), parent, provenance.
|
||||||
|
- The **AI Product Owner** writes a spec **and** generates its child stories as real tasks. The **AI QA** picks up a build (a "done" transition) and drafts test results.
|
||||||
|
- **Team-to-team handoff = an event, not a re-review.** When a task hits *done* it has already passed the producing team's governance; the boundary is a **pipe, not a gate**. The "done" transition emits a typed handoff event on the team-relationship graph, which lands as a **new task in the receiving team's basket** (with a provenance link). The receiving agent then acts per *its own* autonomy. Review happens per-seat on each side, never at the seam.
|
||||||
|
- **Intake mode** per relationship: **auto-accept** (default for trusted internal links) or **triage** (events wait in an intake tray the owner accepts/declines). *(Event mesh beyond the single PO→QA trigger is Phase 1+.)*
|
||||||
|
- **Guardrails:** rate-limit triggers and detect cycles (loop/storm protection); destructive always needs a human.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Per-agent MCP *(Phase 1)*
|
||||||
|
|
||||||
|
Each seat is assigned MCP servers and a **chosen subset of their tools** (a seat uses some tools of a server, not all). Every MCP tool call is **risk-tagged and flows through the same action gate** — publish/destructive calls are held in review. Git write-back can itself be an internal MCP server, so it falls out of the same mechanism rather than a separate build. Skills = how an agent thinks; MCP = what it can do; the dial governs both.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Git abstraction
|
||||||
|
|
||||||
|
Provider-agnostic `GitProvider` interface: **GitHub / GitLab / Azure DevOps / self-hosted Gitea**. Used for (a) the skill registry source, (b) codebase context (chunked, delta-indexed embeddings — re-embed only what changed), (c) write-back (PR comments, issues, branches) *(write-back Phase 2, as an MCP server)*. V1 = Gitea, read-only. Per-org OAuth/credentials, isolated across tenants.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Shared memory
|
||||||
|
|
||||||
|
Team-scoped, pgvector. Built progressively: **working memory** (V1 — decisions/findings/corrections, read at assembly, written on approval) → **episodic** (full output history + edit distance; the training-data foundation) → **semantic** (entity knowledge graph). Institutional knowledge = switching-cost moat. Strict isolation across teams and orgs.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## BYOK & models
|
||||||
|
|
||||||
|
Customers connect their own providers (OpenAI / Anthropic / Google Vertex / Ollama-self-hosted / any OpenAI-compatible) and pay the model bill directly — **TeamUp.AI never resells tokens.** Eliminates token COGS (SaaS-grade margins), satisfies enterprise data-control, and via self-hosted models gives Iran a fully air-gapped, sanctions-safe option. Orgs manage N **named API configs** (e.g. `Vertex-Pro` for reasoning roles, `Vertex-Flash` for high-volume) and assign one per agent; skills suggest a tier (reasoning/fast), the owner chooses. Per-seat **fallback** config so a run doesn't fail silently. Keys encrypted at rest, server-side only.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## The runtime assembler
|
||||||
|
|
||||||
|
For each agent run (in the worker):
|
||||||
|
|
||||||
|
```
|
||||||
|
trigger (task / event / chat) → enqueue AgentRun
|
||||||
|
worker: house-style + identity/overrides + matched atoms (by task type / I/O)
|
||||||
|
+ permitted docs & code (RAG, pgvector) + working memory → prompt (+ prompt cache)
|
||||||
|
call customer model (BYOK, per-seat config, with fallback) → parse output → action + risk tag
|
||||||
|
action gate: autonomy vs risk → execute | hold in review inbox
|
||||||
|
on approval (or autonomous): execute → record edit distance → write working memory → audit
|
||||||
|
```
|
||||||
|
|
||||||
|
V1 actions are **internal** (create/update tasks; write a spec or test plan; read Git for context). MCP tool-calling and Git write-back are deferred but the gate/risk-tags are built to accept them as configuration.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Admin & authoring *(Phase 1; data hooks in V1)*
|
||||||
|
|
||||||
|
**Two admin levels:** the **platform admin** (vendor) curates the public catalogue — the free/tier-gated skill library and the standard division/team templates, setting each one's tier; the **org admin** (a customer Owner) authors that org's **private** skills and **custom** templates within their tier (Scale+).
|
||||||
|
|
||||||
|
- **Skill studio** — author frontmatter + body; versioning with changelog/diff/rollback; eval-gated publishing; commits to Git on publish (Git stays source of truth).
|
||||||
|
- **Templates** — a **team template** = a default roster (seats + role name + suggested skills + default autonomy); a **division template** = services/products + the team templates beneath them; instantiating scaffolds the whole structure; versioned with opt-in propagation.
|
||||||
|
- **AI-suggested skills per role** — name a role (+ optional description) and the internal AI recommends skills from the entitled library with a one-line rationale each; pick some or **add all**. Powers both seat config and the template builder.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Business model
|
||||||
|
|
||||||
|
**BYOK + a platform subscription** (no token reselling). Four tiers per org/month:
|
||||||
|
|
||||||
|
| Tier | Price | For | Key inclusions |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Free | $0 | Evaluation | 1 team, 1 AI seat, public skills, BYOK |
|
||||||
|
| Team | $79 | A single product team | ≤3 products, ≤5 AI seats, all standard team types, review inbox |
|
||||||
|
| Scale | $249 | Multi-product orgs | Unlimited products & seats, private skills, custom team types, API + webhooks, audit export, analytics |
|
||||||
|
| Enterprise | Custom | Large / regulated | SSO, on-prem, compliance export, SLA, dedicated support |
|
||||||
|
|
||||||
|
Free tier + the **gap finder** = product-led front door. Upgrade trigger = hitting the Team product/seat cap. **Future: a custom TeamUp model** fine-tuned on review-correction data (the data flywheel), offered free-for-a-period or at-cost, self-hostable/air-gapped.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Competition & moat
|
||||||
|
|
||||||
|
Closest: **Relevance AI** (general-purpose "AI workforce" + visual canvas, but no software-team org model, board, or governance depth). Others: **Devin** (one role: engineering), **ChatPRD** (PM role), **CrewAI/LangGraph/AutoGen** (frameworks, not products), **Copilot/Cursor** (individual assistants), **Jira/Linear/Azure DevOps** (track work, don't do it), **Copilot Studio/Agentforce** (general automation, ecosystem-locked). **No direct Iranian competitor**; sanctions keep global players out, and BYOK + self-hosted removes foreign dependency. **Moat:** team-memory (switching cost) + the review-correction dataset (powers the model) + the Iranian-market barrier — none replicable without first building the governance layer.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phasing
|
||||||
|
|
||||||
|
- **Phase 0 — Dogfood:** V1 inside AliaSaaS (PO + QA, one team). Prove the bet.
|
||||||
|
- **Phase 1 — PLG:** free tier + design partners; gap finder; external Git read; per-agent MCP; working memory; multi-tenant; 4-tier billing; eval/observability/analytics; skill studio, templates, AI suggestion; divisions UI.
|
||||||
|
- **Phase 2 — Global + own model:** Git write-back; episodic/semantic memory; skill & MCP marketplaces; the TeamUp model; compliance pack.
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
# TeamUp.AI V1 — Build Plan
|
||||||
|
|
||||||
|
The narrow wedge: **AI Product Owner + AI QA, on one team, through the board and review, inside AliaSaaS.** Build in order; each milestone is shippable. The point of V1 is to measure **human edit distance** on PO and QA work — instrument it from M1.
|
||||||
|
|
||||||
|
**Before M1:** the stack is locked (see *Tech stack & bill of materials* below). Stand up the repo — one **.NET 10** solution with two entrypoints (**web/API** + **worker**) sharing the domain-module projects, **PostgreSQL 17+ + pgvector**, EF Core migrations, and a React/Vite SPA built into the web project's `wwwroot` — plus one-command local dev (`docker compose`: app + worker + postgres) and CI. No feature code yet: just the skeleton and the project layout that enforces module boundaries.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tech stack & bill of materials (locked)
|
||||||
|
|
||||||
|
**Backend.** .NET 10 (LTS), ASP.NET Core Minimal APIs (endpoints grouped per module). One solution, two Generic-Host entrypoints — `web` and `worker` — sharing the domain-module projects. Boundaries enforced as separate projects with interface-only references (no cross-module table access).
|
||||||
|
|
||||||
|
**Data & persistence.** PostgreSQL 17+ with pgvector · EF Core 10 + Npgsql · `Pgvector.EntityFrameworkCore` for vector columns/queries · EF Core migrations.
|
||||||
|
|
||||||
|
**Agent-run queue (M4).** A domain-owned `jobs` table drained with `SELECT … FOR UPDATE SKIP LOCKED` by a worker `BackgroundService` — the run lifecycle (queued → running → output → review) is domain state, kept explicit. *(Alternative if outbox/messaging ergonomics are wanted later: Wolverine on Postgres. Hangfire/Quartz only for M6's scheduled triggers.)*
|
||||||
|
|
||||||
|
**AI layer — thin adapters (M3–M4).** `Microsoft.Extensions.AI` (`IChatClient` / `IEmbeddingGenerator`) as the provider-agnostic seam, with thin per-provider HTTP adapters behind it · `Microsoft.Extensions.Http.Resilience` (Polly) for the per-seat fallback/retry chain · air-gapped embeddings via `SmartComponents.LocalEmbeddings` or raw `Microsoft.ML.OnnxRuntime` (MiniLM/bge, CPU-only), switching to a provider's embedding API when BYOK keys are present.
|
||||||
|
|
||||||
|
**Cross-cutting.** Auth/RBAC — ASP.NET Core Identity + JWT (OpenIddict later if a full OAuth server is needed) · BYOK at rest — AES-GCM with a deployment master key; keys owner-only, server-side, never returned to a client · Validation — FluentValidation · Mapping — Mapperly (source-gen) · Resilience — Polly · Observability — OpenTelemetry + Serilog (carries the edit-distance metric from M1).
|
||||||
|
|
||||||
|
**Testing & the golden-tested-skills rule (M2).** xUnit · Testcontainers (real Postgres) · **Verify** for snapshot/golden tests of skills and prompt outputs.
|
||||||
|
|
||||||
|
**Frontend.** React SPA — Vite + TypeScript, built into the web project's `wwwroot` (single deployable). React Router · TanStack Query (server state) · Zustand (client state) · shadcn/ui + Tailwind · **React Flow (xyflow)** for the live org chart · **dnd-kit** for the board · React Hook Form + Zod · Recharts/Tremor for the M6 analytics. Typed API client generated from ASP.NET's OpenAPI (orval / openapi-typescript) into TanStack Query hooks — end-to-end types. *(Next.js is reserved for the separate public marketing site, not the product.)*
|
||||||
|
|
||||||
|
**Dev & deploy.** One Docker image run as web or worker via entrypoint, + Postgres; one-command `docker compose` for local dev; Kubernetes for prod; air-gappable as a single unit.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M1 — Org, board, access & cartable
|
||||||
|
|
||||||
|
**Goal:** the skeleton — people, permissions, and a working board with the three seat states. No AI yet.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- Entities: `Member`, `Membership` (scope + role), `Team`, `Seat` (state: human/open/ai), `Task` (type, status, assignee = member|agent, parent, provenance), `AuditEntry`.
|
||||||
|
- Roles & **permission enforcement** middleware — a check on every mutating action at the relevant scope (Owner / Team owner / Member / Viewer).
|
||||||
|
- Invitation flow (email → join → land in cartable).
|
||||||
|
- The **board** UI: columns backlog → in progress → in review → done; create/move/assign tasks (human assignees for now).
|
||||||
|
- The **cartable** as a derived view (tasks assigned to me, sent-backs, mentions; Approvals section stubbed for owners).
|
||||||
|
- Edit-distance instrumentation **stubbed in** (the data path exists, even with no AI output yet).
|
||||||
|
- Audit log writing on key actions.
|
||||||
|
|
||||||
|
**Acceptance:** a CEO can invite a member, assign them a role on a team, both see the board scoped to their permissions, tasks move across columns, and each person sees their own cartable. A member cannot perform owner-only actions (verified).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M2 — Skill registry
|
||||||
|
|
||||||
|
**Goal:** skills flow from Git into a queryable index, with the first PO/QA atoms.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- `GitProvider` interface; Gitea read adapter; webhook → sync worker.
|
||||||
|
- Parse `SKILL.md` (frontmatter + body) → `Skill` rows in Postgres (incl. `visibility`, `min_tier` fields — hooks only).
|
||||||
|
- pgvector index over skills for matching.
|
||||||
|
- Eval harness: run a skill's golden tests; report pass/fail + edit distance; **block publish on failure**.
|
||||||
|
- Author the four V1 atoms in Git: `spec-writing`, `story-breakdown`, `test-plan-generation`, `diff-review` — each with frontmatter (roles, I/O, risk-tagged actions, context) and golden tests.
|
||||||
|
|
||||||
|
**Acceptance:** pushing a `SKILL.md` to Gitea indexes it within seconds; the four atoms appear, queryable by role; their golden tests run and pass.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M3 — Seat config + BYOK
|
||||||
|
|
||||||
|
**Goal:** configure an AI seat and connect a model — securely.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- `Agent` entity (skills[], autonomy, api_config_id, docs[]) bound to a seat; flip a seat open → AI.
|
||||||
|
- Seat configurator UI: pick skills (+ versions), set autonomy dial, attach docs/repo context, choose model config.
|
||||||
|
- `ApiConfig` (BYOK): name, provider, model, **encrypted** key. **Owner-only** create/view; team owners assign from a list and never see the key; keys never returned to the client after save.
|
||||||
|
- Model adapter interface + adapters for the providers in use (HTTP); per-seat **fallback** config.
|
||||||
|
|
||||||
|
**Acceptance:** an owner adds a `Vertex-Pro` config (key stored encrypted, not retrievable); a team owner configures Aria (PO) with skills, gated autonomy, docs, and that config — without ever seeing the key; a test call succeeds.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M4 — Assembler + worker
|
||||||
|
|
||||||
|
**Goal:** a task becomes an agent run becomes a parsed output.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- Job queue: a Postgres `jobs` table drained with `FOR UPDATE SKIP LOCKED` by a worker `BackgroundService`; enqueue an `AgentRun` on trigger (task assigned / chat).
|
||||||
|
- Worker pulls a job and runs the **assembler**: house-style + identity/overrides + matched atoms (by task type / I/O) + permitted docs & code (RAG via pgvector) + working memory → prompt, with **prompt caching**.
|
||||||
|
- Call the seat's model (BYOK, with fallback); store the full run + trace on `AgentRun`.
|
||||||
|
- Parse output into an **action + risk tag** (PO: spec + proposed child stories; QA: test plan from a diff).
|
||||||
|
|
||||||
|
**Acceptance:** assigning a feature task to Aria produces a spec and a set of proposed child stories as a parsed result, with the assembled context and reasoning captured on the run. Nothing executes yet (gate is M5).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M5 — Action gate + review inbox
|
||||||
|
|
||||||
|
**Goal:** governance closes the loop; edit distance is captured for real.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- Action gate: compare seat autonomy (draft/gated/autonomous) to action risk (read/draft/publish/destructive) → execute or **hold**. **Destructive always holds for a human.**
|
||||||
|
- `ReviewItem` for held actions; the **review inbox** UI (= the Approvals section of an owner's cartable): preview, **expandable reasoning trace**, and **approve / edit-and-approve / send back**.
|
||||||
|
- On execute: perform the internal action (create the child tasks; write the spec/test artifact onto the board); record **edit distance** from edit-and-approve; write audit entry.
|
||||||
|
|
||||||
|
**Acceptance:** Aria (gated) proposes a spec → it waits in the owner's review inbox with its trace → owner edits and approves → the spec lands and four child story tasks appear on the board → edit distance is recorded.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## M6 — Working memory + the first trigger + analytics
|
||||||
|
|
||||||
|
**Goal:** the two-role loop runs end to end, and the bet is measurable.
|
||||||
|
|
||||||
|
**Tasks**
|
||||||
|
- `MemoryEntry` (team working memory): write decisions/approvals/corrections on approval; read at assembly (pgvector match).
|
||||||
|
- The single **event trigger**: a task hitting *done* in the team emits a handoff that creates a QA task for Quill (with provenance); Quill reads the diff and drafts a test plan that waits in review.
|
||||||
|
- **Analytics** view: approval rate, **human edit distance** (per agent and trend), tasks done. Optional: per-run token cost (informational).
|
||||||
|
- Loop/storm guardrail: rate-limit triggers; no self-cascading.
|
||||||
|
|
||||||
|
**Acceptance:** a dev marks a story done → Quill wakes, drafts a test plan → it waits in review → approve → analytics show edit distance and approval rate for Aria and Quill across the sprint. **This is the proof of the bet.**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Definition of done for V1
|
||||||
|
|
||||||
|
The PO and QA loops run inside AliaSaaS on one real product, governed through the board and review inbox, on AliaSaaS's own model keys — and the analytics show **human edit distance low and falling** over a sprint or two. That result (or its absence) is the decision V1 exists to produce.
|
||||||
|
|
||||||
|
## Explicitly NOT in V1
|
||||||
|
Divisions UI & other roles · multiple products · multi-tenant billing · per-agent MCP & Git write-back · episodic/semantic memory · the gap finder · skill studio / template builder / tier enforcement / AI skill-suggestion (data hooks only) · marketplace · the custom TeamUp model · SSO/SCIM · event mesh beyond the single PO→QA trigger. All are accommodated by the architecture; none is built now.
|
||||||
|
|
||||||
|
## Always-on engineering rules (see CLAUDE.md §8)
|
||||||
|
Modular monolith (no cross-module table access) · web off the model path · permission check on every mutation · BYOK keys owner-only & server-side · retrieved content is data not instructions · destructive always needs a human · skills are Git-sourced and golden-tested · instrument edit distance from day one.
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
{
|
||||||
|
"version": 1,
|
||||||
|
"isRoot": true,
|
||||||
|
"tools": {
|
||||||
|
"dotnet-ef": {
|
||||||
|
"version": "10.0.8",
|
||||||
|
"commands": [
|
||||||
|
"dotnet-ef"
|
||||||
|
],
|
||||||
|
"rollForward": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"sdk": {
|
||||||
|
"version": "10.0.203",
|
||||||
|
"rollForward": "latestFeature",
|
||||||
|
"allowPrerelease": false
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<configuration>
|
||||||
|
<!--
|
||||||
|
Packages are pulled through Soroush's self-hosted Nexus pull-through mirror
|
||||||
|
(https://mirror.soroushasadi.com), which proxies api.nuget.org and is reachable from Iran
|
||||||
|
when direct nuget.org access is throttled/blocked. Anonymous read.
|
||||||
|
To build against nuget.org directly instead, swap the source below.
|
||||||
|
-->
|
||||||
|
<packageSources>
|
||||||
|
<clear />
|
||||||
|
<add key="nexus" value="https://mirror.soroushasadi.com/repository/nuget-group/index.json" protocolVersion="3" />
|
||||||
|
<!-- Fallback (often unreachable from Iran):
|
||||||
|
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" /> -->
|
||||||
|
</packageSources>
|
||||||
|
<packageSourceMapping>
|
||||||
|
<packageSource key="nexus">
|
||||||
|
<package pattern="*" />
|
||||||
|
</packageSource>
|
||||||
|
</packageSourceMapping>
|
||||||
|
</configuration>
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
using TeamUp.Modules.Assembler;
|
||||||
|
using TeamUp.Modules.Governance;
|
||||||
|
using TeamUp.Modules.Identity;
|
||||||
|
using TeamUp.Modules.Integrations;
|
||||||
|
using TeamUp.Modules.Memory;
|
||||||
|
using TeamUp.Modules.OrgBoard;
|
||||||
|
using TeamUp.Modules.Skills;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Bootstrap;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The explicit, ordered list of modules. Explicit (not assembly-scanned) on purpose:
|
||||||
|
/// deterministic, trim/AOT-safe, reviewable, and order-controlled (Identity first, since other
|
||||||
|
/// modules will depend on its auth services). Adding a module is a one-line change here.
|
||||||
|
/// </summary>
|
||||||
|
public static class ModuleCatalog
|
||||||
|
{
|
||||||
|
public static IReadOnlyList<IModule> All { get; } =
|
||||||
|
[
|
||||||
|
new IdentityModule(),
|
||||||
|
new OrgBoardModule(),
|
||||||
|
new SkillsModule(),
|
||||||
|
new IntegrationsModule(),
|
||||||
|
new MemoryModule(),
|
||||||
|
new AssemblerModule(),
|
||||||
|
new GovernanceModule(),
|
||||||
|
];
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- The ONLY composition library that references every module. Both hosts reference Bootstrap
|
||||||
|
(and nothing else of the module graph), so the module list stays DRY across web + worker.
|
||||||
|
Infrastructure and SharedKernel must never reference modules — Bootstrap is where that
|
||||||
|
knowledge is allowed to live. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.Infrastructure\TeamUp.Infrastructure.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Identity\TeamUp.Modules.Identity.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.OrgBoard\TeamUp.Modules.OrgBoard.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Skills\TeamUp.Modules.Skills.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Integrations\TeamUp.Modules.Integrations.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Memory\TeamUp.Modules.Memory.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Assembler\TeamUp.Modules.Assembler.csproj" />
|
||||||
|
<ProjectReference Include="..\..\Modules\TeamUp.Modules.Governance\TeamUp.Modules.Governance.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
|
||||||
|
namespace TeamUp.Bootstrap;
|
||||||
|
|
||||||
|
public static class TeamUpModuleExtensions
|
||||||
|
{
|
||||||
|
/// <summary>Runs every module's <c>Register</c>. Called by BOTH hosts.</summary>
|
||||||
|
public static IServiceCollection AddTeamUpModules(
|
||||||
|
this IServiceCollection services,
|
||||||
|
IConfiguration configuration)
|
||||||
|
{
|
||||||
|
foreach (var module in ModuleCatalog.All)
|
||||||
|
{
|
||||||
|
module.Register(services, configuration);
|
||||||
|
}
|
||||||
|
|
||||||
|
return services;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>Runs every module's <c>MapEndpoints</c>. Called by the WEB host only.</summary>
|
||||||
|
public static IEndpointRouteBuilder MapTeamUpModules(this IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
foreach (var module in ModuleCatalog.All)
|
||||||
|
{
|
||||||
|
module.MapEndpoints(endpoints);
|
||||||
|
}
|
||||||
|
|
||||||
|
return endpoints;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
using OpenTelemetry.Trace;
|
||||||
|
using Serilog;
|
||||||
|
using TeamUp.Bootstrap;
|
||||||
|
using TeamUp.Infrastructure.Observability;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
var builder = WebApplication.CreateBuilder(args);
|
||||||
|
|
||||||
|
builder.Host.UseSerilog((context, services, configuration) => configuration
|
||||||
|
.ReadFrom.Configuration(context.Configuration)
|
||||||
|
.ReadFrom.Services(services));
|
||||||
|
|
||||||
|
builder.Services.AddOpenApi();
|
||||||
|
|
||||||
|
builder.Services.AddTeamUpObservability(
|
||||||
|
builder.Configuration,
|
||||||
|
serviceName: "teamup-web",
|
||||||
|
configureTracing: tracing => tracing.AddAspNetCoreInstrumentation());
|
||||||
|
|
||||||
|
builder.Services.AddTeamUpPersistence(builder.Configuration);
|
||||||
|
builder.Services.AddTeamUpModules(builder.Configuration);
|
||||||
|
|
||||||
|
var app = builder.Build();
|
||||||
|
|
||||||
|
// Apply migrations on startup when configured (default: in Development). EF Core takes a
|
||||||
|
// DB-wide lock, so the web and worker applying concurrently is safe.
|
||||||
|
if (app.Configuration.GetValue("Database:ApplyMigrationsOnStartup", app.Environment.IsDevelopment()))
|
||||||
|
{
|
||||||
|
await MigrationRunner.MigrateAllAsync(app.Services);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (app.Environment.IsDevelopment())
|
||||||
|
{
|
||||||
|
app.MapOpenApi();
|
||||||
|
}
|
||||||
|
|
||||||
|
app.UseSerilogRequestLogging();
|
||||||
|
|
||||||
|
// Serve the built SPA from wwwroot (single deployable). UseStaticFiles (not MapStaticAssets)
|
||||||
|
// because the SPA is copied into wwwroot at publish/Docker time, after the build-time asset
|
||||||
|
// manifest is computed.
|
||||||
|
app.UseDefaultFiles();
|
||||||
|
app.UseStaticFiles();
|
||||||
|
|
||||||
|
app.MapHealthChecks("/health");
|
||||||
|
app.MapTeamUpModules();
|
||||||
|
|
||||||
|
// SPA deep links (client-side routing) fall back to index.html.
|
||||||
|
app.MapFallbackToFile("index.html");
|
||||||
|
|
||||||
|
app.Run();
|
||||||
|
|
||||||
|
/// <summary>Exposed so the integration tests can drive the host via WebApplicationFactory.</summary>
|
||||||
|
public partial class Program
|
||||||
|
{
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json.schemastore.org/launchsettings.json",
|
||||||
|
"profiles": {
|
||||||
|
"http": {
|
||||||
|
"commandName": "Project",
|
||||||
|
"dotnetRunMessages": true,
|
||||||
|
"launchBrowser": false,
|
||||||
|
"applicationUrl": "http://localhost:5180",
|
||||||
|
"environmentVariables": {
|
||||||
|
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"https": {
|
||||||
|
"commandName": "Project",
|
||||||
|
"dotnetRunMessages": true,
|
||||||
|
"launchBrowser": false,
|
||||||
|
"applicationUrl": "https://localhost:7180;http://localhost:5180",
|
||||||
|
"environmentVariables": {
|
||||||
|
"ASPNETCORE_ENVIRONMENT": "Development"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<!-- Path to the Vite SPA. The publish target below builds it into the published wwwroot.
|
||||||
|
Set BuildClient=false to skip (the Docker build builds the SPA in a dedicated node
|
||||||
|
stage and copies it in, so it passes -p:BuildClient=false). -->
|
||||||
|
<ClientDir>$(MSBuildProjectDirectory)\..\..\..\client</ClientDir>
|
||||||
|
<BuildClient Condition="'$(BuildClient)' == ''">true</BuildClient>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Bootstrap\TeamUp.Bootstrap\TeamUp.Bootstrap.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Microsoft.AspNetCore.OpenApi" />
|
||||||
|
<PackageReference Include="Serilog.AspNetCore" />
|
||||||
|
<PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<!-- Build the Vite SPA and copy it into the published wwwroot for a single deployable.
|
||||||
|
Runs only on `dotnet publish` (never on build/test, so node isn't needed for CI tests). -->
|
||||||
|
<Target Name="PublishClientSpa" AfterTargets="Publish"
|
||||||
|
Condition="'$(BuildClient)' == 'true' AND Exists('$(ClientDir)\package.json')">
|
||||||
|
<Message Importance="high" Text="Building Vite SPA from $(ClientDir) ..." />
|
||||||
|
<Exec Command="npm ci" WorkingDirectory="$(ClientDir)" />
|
||||||
|
<Exec Command="npm run build" WorkingDirectory="$(ClientDir)" />
|
||||||
|
<ItemGroup>
|
||||||
|
<_SpaDist Include="$(ClientDir)\dist\**\*" />
|
||||||
|
</ItemGroup>
|
||||||
|
<Copy SourceFiles="@(_SpaDist)"
|
||||||
|
DestinationFiles="@(_SpaDist->'$(PublishDir)wwwroot\%(RecursiveDir)%(Filename)%(Extension)')"
|
||||||
|
SkipUnchangedFiles="true" />
|
||||||
|
</Target>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"Database": {
|
||||||
|
"ApplyMigrationsOnStartup": true
|
||||||
|
},
|
||||||
|
"Serilog": {
|
||||||
|
"MinimumLevel": {
|
||||||
|
"Default": "Debug",
|
||||||
|
"Override": {
|
||||||
|
"Microsoft.AspNetCore": "Information",
|
||||||
|
"Microsoft.EntityFrameworkCore": "Warning"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
{
|
||||||
|
"ConnectionStrings": {
|
||||||
|
"Postgres": "Host=localhost;Port=5432;Database=teamup;Username=teamup;Password=teamup"
|
||||||
|
},
|
||||||
|
"Database": {
|
||||||
|
"ApplyMigrationsOnStartup": false
|
||||||
|
},
|
||||||
|
"OpenTelemetry": {
|
||||||
|
"OtlpEndpoint": ""
|
||||||
|
},
|
||||||
|
"Serilog": {
|
||||||
|
"MinimumLevel": {
|
||||||
|
"Default": "Information",
|
||||||
|
"Override": {
|
||||||
|
"Microsoft.AspNetCore": "Warning",
|
||||||
|
"Microsoft.EntityFrameworkCore": "Warning"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"Enrich": [ "FromLogContext" ],
|
||||||
|
"WriteTo": [
|
||||||
|
{ "Name": "Console" }
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"AllowedHosts": "*"
|
||||||
|
}
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||||
|
<title>TeamUp.AI</title>
|
||||||
|
<style>
|
||||||
|
:root { color-scheme: dark; }
|
||||||
|
body {
|
||||||
|
margin: 0; min-height: 100vh; display: grid; place-items: center;
|
||||||
|
font-family: "Hanken Grotesk", system-ui, sans-serif;
|
||||||
|
background: #1e1b4b; color: #e2e8f0;
|
||||||
|
}
|
||||||
|
main { text-align: center; padding: 2rem; }
|
||||||
|
h1 { font-weight: 700; letter-spacing: -0.02em; margin: 0 0 .25rem; }
|
||||||
|
p { color: #a5b4fc; margin: .25rem 0; }
|
||||||
|
code { background: #312e81; padding: .15rem .4rem; border-radius: .25rem; }
|
||||||
|
#status { margin-top: 1.25rem; font-size: .9rem; }
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<main>
|
||||||
|
<h1>TeamUp.AI</h1>
|
||||||
|
<p>Build human + AI teams.</p>
|
||||||
|
<p>API host is running. This placeholder is replaced by the React SPA on publish.</p>
|
||||||
|
<p id="status">checking <code>/health</code>…</p>
|
||||||
|
</main>
|
||||||
|
<script>
|
||||||
|
fetch("/health")
|
||||||
|
.then((r) => (r.ok ? "healthy" : "unhealthy (" + r.status + ")"))
|
||||||
|
.catch(() => "unreachable")
|
||||||
|
.then((s) => { document.getElementById("status").textContent = "/health: " + s; });
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
using Microsoft.Extensions.Diagnostics.HealthChecks;
|
||||||
|
|
||||||
|
namespace TeamUp.Worker;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Skeleton placeholder for the future agent-run job drainer (M4: a Postgres <c>jobs</c> table
|
||||||
|
/// drained with <c>FOR UPDATE SKIP LOCKED</c>). For now it proves the worker host boots, shares
|
||||||
|
/// the domain modules, and can reach the database — by running the registered health checks on a
|
||||||
|
/// timer. Internal: defined in and visible only to the worker assembly.
|
||||||
|
/// </summary>
|
||||||
|
internal sealed class HeartbeatService(
|
||||||
|
ILogger<HeartbeatService> logger,
|
||||||
|
IServiceScopeFactory scopeFactory) : BackgroundService
|
||||||
|
{
|
||||||
|
private static readonly TimeSpan Interval = TimeSpan.FromSeconds(30);
|
||||||
|
|
||||||
|
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
|
||||||
|
{
|
||||||
|
logger.LogInformation("Worker started; heartbeat every {Seconds}s.", Interval.TotalSeconds);
|
||||||
|
|
||||||
|
using var timer = new PeriodicTimer(Interval);
|
||||||
|
while (!stoppingToken.IsCancellationRequested)
|
||||||
|
{
|
||||||
|
try
|
||||||
|
{
|
||||||
|
await using var scope = scopeFactory.CreateAsyncScope();
|
||||||
|
var health = scope.ServiceProvider.GetRequiredService<HealthCheckService>();
|
||||||
|
var report = await health.CheckHealthAsync(stoppingToken);
|
||||||
|
logger.LogInformation("Worker heartbeat — DB health: {Status}", report.Status);
|
||||||
|
|
||||||
|
await timer.WaitForNextTickAsync(stoppingToken);
|
||||||
|
}
|
||||||
|
catch (OperationCanceledException)
|
||||||
|
{
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Serilog;
|
||||||
|
using TeamUp.Bootstrap;
|
||||||
|
using TeamUp.Infrastructure.Observability;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
using TeamUp.Worker;
|
||||||
|
|
||||||
|
var builder = Host.CreateApplicationBuilder(args);
|
||||||
|
|
||||||
|
builder.Services.AddSerilog((services, configuration) => configuration
|
||||||
|
.ReadFrom.Configuration(builder.Configuration)
|
||||||
|
.ReadFrom.Services(services));
|
||||||
|
|
||||||
|
builder.Services.AddTeamUpObservability(builder.Configuration, serviceName: "teamup-worker");
|
||||||
|
builder.Services.AddTeamUpPersistence(builder.Configuration);
|
||||||
|
builder.Services.AddTeamUpModules(builder.Configuration);
|
||||||
|
builder.Services.AddHostedService<HeartbeatService>();
|
||||||
|
|
||||||
|
var host = builder.Build();
|
||||||
|
|
||||||
|
// Default: web applies migrations; the worker leaves it off in compose. Locally (Development)
|
||||||
|
// it defaults on, but EF's DB-wide migration lock makes a concurrent apply safe and idempotent.
|
||||||
|
if (builder.Configuration.GetValue("Database:ApplyMigrationsOnStartup", builder.Environment.IsDevelopment()))
|
||||||
|
{
|
||||||
|
await MigrationRunner.MigrateAllAsync(host.Services);
|
||||||
|
}
|
||||||
|
|
||||||
|
host.Run();
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk.Worker">
|
||||||
|
|
||||||
|
<!-- The worker role. Same image as the web host, selected at the Docker entrypoint by RUN_MODE.
|
||||||
|
Shares all domain modules via Bootstrap; contributes zero HTTP surface. OpenTelemetry flows
|
||||||
|
transitively from Infrastructure; Serilog.AspNetCore provides AddSerilog + config binding. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Bootstrap\TeamUp.Bootstrap\TeamUp.Bootstrap.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Serilog.AspNetCore" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
{
|
||||||
|
"Database": {
|
||||||
|
"ApplyMigrationsOnStartup": true
|
||||||
|
},
|
||||||
|
"Serilog": {
|
||||||
|
"MinimumLevel": {
|
||||||
|
"Default": "Debug",
|
||||||
|
"Override": {
|
||||||
|
"Microsoft.EntityFrameworkCore": "Warning"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"ConnectionStrings": {
|
||||||
|
"Postgres": "Host=localhost;Port=5432;Database=teamup;Username=teamup;Password=teamup"
|
||||||
|
},
|
||||||
|
"Database": {
|
||||||
|
"ApplyMigrationsOnStartup": false
|
||||||
|
},
|
||||||
|
"OpenTelemetry": {
|
||||||
|
"OtlpEndpoint": ""
|
||||||
|
},
|
||||||
|
"Serilog": {
|
||||||
|
"MinimumLevel": {
|
||||||
|
"Default": "Information",
|
||||||
|
"Override": {
|
||||||
|
"Microsoft.EntityFrameworkCore": "Warning"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"Enrich": [ "FromLogContext" ],
|
||||||
|
"WriteTo": [
|
||||||
|
{ "Name": "Console" }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Assembler;
|
||||||
|
|
||||||
|
/// <summary>Context assembly, the model call, output parsing, prompt caching — runs in the worker (M4).</summary>
|
||||||
|
public sealed class AssemblerModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "assembler";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M4 introduces the jobs table (FOR UPDATE SKIP LOCKED),
|
||||||
|
// the AgentRun context, and the assembler pipeline (registered for the worker host).
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Assembler")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module.
|
||||||
|
NOTE: this module hosts the runtime assembler + job-drain logic in the worker (M4); the AI
|
||||||
|
model-client packages are deferred to M3-M4 and are not referenced in the skeleton. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Governance;
|
||||||
|
|
||||||
|
/// <summary>Autonomy dial, the action gate, the review inbox, the audit log (M5).</summary>
|
||||||
|
public sealed class GovernanceModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "governance";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M5 introduces the action gate, ReviewItem context,
|
||||||
|
// edit-distance capture, and the immutable audit log here.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Governance")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Identity;
|
||||||
|
|
||||||
|
/// <summary>Identity & access: members, memberships, roles, permission enforcement (M1).</summary>
|
||||||
|
public sealed class IdentityModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "identity";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M1 introduces this module's (internal) DbContext,
|
||||||
|
// FluentValidation validators, and domain services here.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Identity")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Integrations;
|
||||||
|
|
||||||
|
/// <summary>BYOK API configs, the Git connection, the encrypted-credential store (M3).</summary>
|
||||||
|
public sealed class IntegrationsModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "integrations";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M3 introduces this module's (internal) DbContext, the
|
||||||
|
// encrypted ApiConfig store, and the provider-agnostic model-client seam interface.
|
||||||
|
// The concrete model client (Microsoft.Extensions.AI) is deferred to M3-M4.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Integrations")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module.
|
||||||
|
NOTE: the AI model-client packages (Microsoft.Extensions.AI, ONNX) are deferred to M3-M4;
|
||||||
|
this module exposes only seam interfaces in V1, no concrete model client. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Memory;
|
||||||
|
|
||||||
|
/// <summary>Team-scoped working memory: read at assembly, written on approval (M6, pgvector).</summary>
|
||||||
|
public sealed class MemoryModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "memory";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M6 introduces this module's (internal) DbContext with a
|
||||||
|
// pgvector-backed MemoryEntry table and the working-memory read/write services.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Memory")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.OrgBoard;
|
||||||
|
|
||||||
|
/// <summary>Org, products, teams, seats, and the task/board model (M1).</summary>
|
||||||
|
public sealed class OrgBoardModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "orgboard";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M1 introduces this module's (internal) DbContext,
|
||||||
|
// FluentValidation validators, and domain services here.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("OrgBoard")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Microsoft.AspNetCore.Builder;
|
||||||
|
using Microsoft.AspNetCore.Http;
|
||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.Modules.Skills;
|
||||||
|
|
||||||
|
/// <summary>Git-sourced skill registry: sync, the queryable atom index, versioning, evals (M2).</summary>
|
||||||
|
public sealed class SkillsModule : IModule
|
||||||
|
{
|
||||||
|
public string Name => "skills";
|
||||||
|
|
||||||
|
public void Register(IServiceCollection services, IConfiguration configuration)
|
||||||
|
{
|
||||||
|
// Skeleton: no services yet. M2 introduces this module's (internal) DbContext,
|
||||||
|
// FluentValidation validators, and domain services here.
|
||||||
|
}
|
||||||
|
|
||||||
|
public void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
endpoints.MapGroup($"/api/{Name}")
|
||||||
|
.WithTags("Skills")
|
||||||
|
.MapGet("/ping", () => TypedResults.Ok(new ModulePing(Name)));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- A self-contained module. References SharedKernel ONLY (ASP.NET flows transitively for the
|
||||||
|
IModule seam). M1 adds this module's EF/Npgsql/FluentValidation/Mapperly packages when it
|
||||||
|
gains an (internal) DbContext and validators. It must never reference another module. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\Shared\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,50 @@
|
|||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using OpenTelemetry.Metrics;
|
||||||
|
using OpenTelemetry.Resources;
|
||||||
|
using OpenTelemetry.Trace;
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Observability;
|
||||||
|
|
||||||
|
public static class ObservabilityExtensions
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Wires OpenTelemetry tracing + metrics with a service-name resource and runtime metrics.
|
||||||
|
/// The OTLP exporter is attached only when an endpoint is configured (so local dev stays
|
||||||
|
/// quiet). Hosts pass <paramref name="configureTracing"/> to add role-specific
|
||||||
|
/// instrumentation (e.g. the web host adds ASP.NET Core instrumentation).
|
||||||
|
/// </summary>
|
||||||
|
public static IServiceCollection AddTeamUpObservability(
|
||||||
|
this IServiceCollection services,
|
||||||
|
IConfiguration configuration,
|
||||||
|
string serviceName,
|
||||||
|
Action<TracerProviderBuilder>? configureTracing = null,
|
||||||
|
Action<MeterProviderBuilder>? configureMetrics = null)
|
||||||
|
{
|
||||||
|
var otlpEndpoint = configuration["OpenTelemetry:OtlpEndpoint"]
|
||||||
|
?? Environment.GetEnvironmentVariable("OTEL_EXPORTER_OTLP_ENDPOINT");
|
||||||
|
var exportOtlp = !string.IsNullOrWhiteSpace(otlpEndpoint);
|
||||||
|
|
||||||
|
services.AddOpenTelemetry()
|
||||||
|
.ConfigureResource(resource => resource.AddService(serviceName))
|
||||||
|
.WithTracing(tracing =>
|
||||||
|
{
|
||||||
|
configureTracing?.Invoke(tracing);
|
||||||
|
if (exportOtlp)
|
||||||
|
{
|
||||||
|
tracing.AddOtlpExporter();
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.WithMetrics(metrics =>
|
||||||
|
{
|
||||||
|
metrics.AddRuntimeInstrumentation();
|
||||||
|
configureMetrics?.Invoke(metrics);
|
||||||
|
if (exportOtlp)
|
||||||
|
{
|
||||||
|
metrics.AddOtlpExporter();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
return services;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
using TeamUp.SharedKernel.Persistence;
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
public static class MigrationRunner
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Applies the platform migration first (vector extension + module schemas), then every
|
||||||
|
/// module DbContext discovered from DI. In the skeleton only the platform context exists;
|
||||||
|
/// the module loop is already wired so M1+ contexts apply with no change here.
|
||||||
|
/// </summary>
|
||||||
|
public static async Task MigrateAllAsync(
|
||||||
|
IServiceProvider services,
|
||||||
|
CancellationToken cancellationToken = default)
|
||||||
|
{
|
||||||
|
await using var scope = services.CreateAsyncScope();
|
||||||
|
var provider = scope.ServiceProvider;
|
||||||
|
|
||||||
|
await provider.GetRequiredService<PlatformDbContext>()
|
||||||
|
.Database.MigrateAsync(cancellationToken);
|
||||||
|
|
||||||
|
foreach (var moduleContext in provider.GetServices<IModuleDbContext>())
|
||||||
|
{
|
||||||
|
await ((DbContext)moduleContext).Database.MigrateAsync(cancellationToken);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Generated
+30
@@ -0,0 +1,30 @@
|
|||||||
|
// <auto-generated />
|
||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using Microsoft.EntityFrameworkCore.Infrastructure;
|
||||||
|
using Microsoft.EntityFrameworkCore.Migrations;
|
||||||
|
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
||||||
|
using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
#nullable disable
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence.Migrations
|
||||||
|
{
|
||||||
|
[DbContext(typeof(PlatformDbContext))]
|
||||||
|
[Migration("20260609030024_InitialPlatform")]
|
||||||
|
partial class InitialPlatform
|
||||||
|
{
|
||||||
|
/// <inheritdoc />
|
||||||
|
protected override void BuildTargetModel(ModelBuilder modelBuilder)
|
||||||
|
{
|
||||||
|
#pragma warning disable 612, 618
|
||||||
|
modelBuilder
|
||||||
|
.HasAnnotation("ProductVersion", "10.0.8")
|
||||||
|
.HasAnnotation("Relational:MaxIdentifierLength", 63);
|
||||||
|
|
||||||
|
NpgsqlModelBuilderExtensions.HasPostgresExtension(modelBuilder, "vector");
|
||||||
|
NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
|
||||||
|
#pragma warning restore 612, 618
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+33
@@ -0,0 +1,33 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore.Migrations;
|
||||||
|
|
||||||
|
#nullable disable
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence.Migrations
|
||||||
|
{
|
||||||
|
/// <inheritdoc />
|
||||||
|
public partial class InitialPlatform : Migration
|
||||||
|
{
|
||||||
|
/// <inheritdoc />
|
||||||
|
protected override void Up(MigrationBuilder migrationBuilder)
|
||||||
|
{
|
||||||
|
// Enable the pgvector extension (database-global).
|
||||||
|
migrationBuilder.AlterDatabase()
|
||||||
|
.Annotation("Npgsql:PostgresExtension:vector", ",,");
|
||||||
|
|
||||||
|
// Create one schema per module; each module's DbContext (M1+) maps into its own schema.
|
||||||
|
foreach (var schema in PlatformDbContext.ModuleSchemas)
|
||||||
|
{
|
||||||
|
migrationBuilder.Sql($"CREATE SCHEMA IF NOT EXISTS \"{schema}\";");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <inheritdoc />
|
||||||
|
protected override void Down(MigrationBuilder migrationBuilder)
|
||||||
|
{
|
||||||
|
foreach (var schema in PlatformDbContext.ModuleSchemas)
|
||||||
|
{
|
||||||
|
migrationBuilder.Sql($"DROP SCHEMA IF EXISTS \"{schema}\" CASCADE;");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+27
@@ -0,0 +1,27 @@
|
|||||||
|
// <auto-generated />
|
||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using Microsoft.EntityFrameworkCore.Infrastructure;
|
||||||
|
using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
|
||||||
|
using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
#nullable disable
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence.Migrations
|
||||||
|
{
|
||||||
|
[DbContext(typeof(PlatformDbContext))]
|
||||||
|
partial class PlatformDbContextModelSnapshot : ModelSnapshot
|
||||||
|
{
|
||||||
|
protected override void BuildModel(ModelBuilder modelBuilder)
|
||||||
|
{
|
||||||
|
#pragma warning disable 612, 618
|
||||||
|
modelBuilder
|
||||||
|
.HasAnnotation("ProductVersion", "10.0.8")
|
||||||
|
.HasAnnotation("Relational:MaxIdentifierLength", 63);
|
||||||
|
|
||||||
|
NpgsqlModelBuilderExtensions.HasPostgresExtension(modelBuilder, "vector");
|
||||||
|
NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
|
||||||
|
#pragma warning restore 612, 618
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
public static class PersistenceExtensions
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Registers the platform persistence: the bootstrap context (with the pgvector type handler)
|
||||||
|
/// and a DB health check. Module contexts are registered by their own modules at M1+.
|
||||||
|
/// </summary>
|
||||||
|
public static IServiceCollection AddTeamUpPersistence(
|
||||||
|
this IServiceCollection services,
|
||||||
|
IConfiguration configuration)
|
||||||
|
{
|
||||||
|
var connectionString = configuration.GetConnectionString("Postgres")
|
||||||
|
?? throw new InvalidOperationException(
|
||||||
|
"Missing connection string 'ConnectionStrings:Postgres'.");
|
||||||
|
|
||||||
|
services.AddDbContext<PlatformDbContext>(options =>
|
||||||
|
options.UseNpgsql(connectionString, npgsql => npgsql.UseVector()));
|
||||||
|
|
||||||
|
services.AddHealthChecks()
|
||||||
|
.AddDbContextCheck<PlatformDbContext>("postgres");
|
||||||
|
|
||||||
|
return services;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The bootstrap context. Owns only database-global concerns: the pgvector extension and the
|
||||||
|
/// per-module schemas. It holds ZERO domain tables — each module owns its own tables via its
|
||||||
|
/// own (internal) DbContext. Internal so no other assembly can touch it directly.
|
||||||
|
/// </summary>
|
||||||
|
internal sealed class PlatformDbContext(DbContextOptions<PlatformDbContext> options)
|
||||||
|
: DbContext(options)
|
||||||
|
{
|
||||||
|
/// <summary>The module schemas created by the initial migration. The single source of truth.</summary>
|
||||||
|
public static readonly string[] ModuleSchemas =
|
||||||
|
[
|
||||||
|
"identity",
|
||||||
|
"orgboard",
|
||||||
|
"skills",
|
||||||
|
"integrations",
|
||||||
|
"memory",
|
||||||
|
"assembler",
|
||||||
|
"governance",
|
||||||
|
];
|
||||||
|
|
||||||
|
protected override void OnModelCreating(ModelBuilder modelBuilder)
|
||||||
|
{
|
||||||
|
// The vector extension is database-global, not schema-scoped — this is the ONE place
|
||||||
|
// it is declared. Module contexts assume it already exists and never re-declare it.
|
||||||
|
modelBuilder.HasPostgresExtension("vector");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using Microsoft.EntityFrameworkCore.Design;
|
||||||
|
|
||||||
|
namespace TeamUp.Infrastructure.Persistence;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Design-time factory so `dotnet ef migrations add ...` can construct the (internal) context
|
||||||
|
/// without booting a host. Reads the connection string from the environment with a localhost
|
||||||
|
/// dev fallback — the value only matters for `migrations add`, not at runtime.
|
||||||
|
/// </summary>
|
||||||
|
internal sealed class PlatformDbContextFactory : IDesignTimeDbContextFactory<PlatformDbContext>
|
||||||
|
{
|
||||||
|
public PlatformDbContext CreateDbContext(string[] args)
|
||||||
|
{
|
||||||
|
var connectionString =
|
||||||
|
Environment.GetEnvironmentVariable("ConnectionStrings__Postgres")
|
||||||
|
?? "Host=localhost;Port=5432;Database=teamup;Username=teamup;Password=teamup";
|
||||||
|
|
||||||
|
var options = new DbContextOptionsBuilder<PlatformDbContext>()
|
||||||
|
.UseNpgsql(connectionString, npgsql => npgsql.UseVector())
|
||||||
|
.Options;
|
||||||
|
|
||||||
|
return new PlatformDbContext(options);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Shared platform infrastructure: the bootstrap PlatformDbContext (owns the pgvector
|
||||||
|
extension + module schemas), the migration runner, and persistence/observability wiring.
|
||||||
|
References SharedKernel only — NEVER any module (enforced by the architecture tests).
|
||||||
|
-->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\TeamUp.SharedKernel\TeamUp.SharedKernel.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Microsoft.EntityFrameworkCore" />
|
||||||
|
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" PrivateAssets="all" />
|
||||||
|
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" />
|
||||||
|
<PackageReference Include="Pgvector.EntityFrameworkCore" />
|
||||||
|
<PackageReference Include="Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore" />
|
||||||
|
<PackageReference Include="OpenTelemetry.Extensions.Hosting" />
|
||||||
|
<PackageReference Include="OpenTelemetry.Instrumentation.Runtime" />
|
||||||
|
<PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
namespace TeamUp.SharedKernel.Domain;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Base class for domain entities. Uses a UUIDv7 identifier — time-ordered, so it keeps
|
||||||
|
/// B-tree index locality (unlike a random v4) while remaining globally unique.
|
||||||
|
/// </summary>
|
||||||
|
public abstract class Entity
|
||||||
|
{
|
||||||
|
public Guid Id { get; protected set; } = Guid.CreateVersion7();
|
||||||
|
}
|
||||||
@@ -0,0 +1,30 @@
|
|||||||
|
using Microsoft.AspNetCore.Routing;
|
||||||
|
using Microsoft.Extensions.Configuration;
|
||||||
|
using Microsoft.Extensions.DependencyInjection;
|
||||||
|
|
||||||
|
namespace TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The contract every domain module implements. A module is a self-contained slice of the
|
||||||
|
/// monolith with its own persistence and services. Modules collaborate only through public
|
||||||
|
/// abstractions resolved from DI — never by referencing each other's internals.
|
||||||
|
/// </summary>
|
||||||
|
public interface IModule
|
||||||
|
{
|
||||||
|
/// <summary>Stable lowercase key used for the module's DB schema and in logs (e.g. "orgboard").</summary>
|
||||||
|
string Name { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Register the module's services, validators, DbContext, etc. Runs in BOTH the web and
|
||||||
|
/// worker hosts, so a module's background-capable services are available to the worker.
|
||||||
|
/// </summary>
|
||||||
|
void Register(IServiceCollection services, IConfiguration configuration);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Contribute Minimal-API endpoint groups. Called by the WEB host only — the worker never
|
||||||
|
/// invokes this, so modules contribute zero HTTP surface to the worker. Default is a no-op.
|
||||||
|
/// </summary>
|
||||||
|
void MapEndpoints(IEndpointRouteBuilder endpoints)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
namespace TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
/// <summary>Response of a module's skeleton liveness endpoint — proves the module seam is wired.</summary>
|
||||||
|
public sealed record ModulePing(string Module, string Status = "ok");
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
namespace TeamUp.SharedKernel.Persistence;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Marker implemented by each module's (internal) DbContext so the migration runner can
|
||||||
|
/// discover every module context from DI and apply its migrations uniformly. Keeping this in
|
||||||
|
/// SharedKernel lets Infrastructure migrate module contexts without referencing the modules.
|
||||||
|
/// </summary>
|
||||||
|
public interface IModuleDbContext;
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!--
|
||||||
|
The dependency-light core. Defines the IModule seam and base domain/persistence
|
||||||
|
abstractions. The ASP.NET framework reference is here ONLY so IModule can name
|
||||||
|
IEndpointRouteBuilder / IServiceCollection / IConfiguration. No package deps,
|
||||||
|
no project deps — every module references this and nothing else of ours.
|
||||||
|
-->
|
||||||
|
<ItemGroup>
|
||||||
|
<FrameworkReference Include="Microsoft.AspNetCore.App" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
<Project>
|
||||||
|
|
||||||
|
<!-- Inherit the repo-root Directory.Build.props (MSBuild stops at the first one it finds
|
||||||
|
walking up, so test projects must import the parent explicitly), then add the shared
|
||||||
|
test settings + the common xUnit v3 package set. -->
|
||||||
|
<Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<IsPackable>false</IsPackable>
|
||||||
|
<IsTestProject>true</IsTestProject>
|
||||||
|
<OutputType>Exe</OutputType>
|
||||||
|
<!-- Analyzer rules that fight idiomatic test code:
|
||||||
|
CA1707 underscored test names · CA1711 xUnit [CollectionDefinition] "Collection" suffix
|
||||||
|
· xUnit1051 TestContext cancellation token (not needed for these short tests). -->
|
||||||
|
<NoWarn>$(NoWarn);CA1707;CA1711;xUnit1051</NoWarn>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Microsoft.NET.Test.Sdk" />
|
||||||
|
<PackageReference Include="xunit.v3" />
|
||||||
|
<PackageReference Include="xunit.runner.visualstudio" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
using System.Reflection;
|
||||||
|
using TeamUp.Bootstrap;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
using TeamUp.Modules.Assembler;
|
||||||
|
using TeamUp.Modules.Governance;
|
||||||
|
using TeamUp.Modules.Identity;
|
||||||
|
using TeamUp.Modules.Integrations;
|
||||||
|
using TeamUp.Modules.Memory;
|
||||||
|
using TeamUp.Modules.OrgBoard;
|
||||||
|
using TeamUp.Modules.Skills;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
|
||||||
|
namespace TeamUp.ArchitectureTests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Handles to the production assemblies. The boundary tests assert on real assembly references
|
||||||
|
/// (<see cref="Assembly.GetReferencedAssemblies"/>) — reflection is deterministic and needs no
|
||||||
|
/// third-party arch-test framework. Because each module is its own assembly, an assembly-level
|
||||||
|
/// reference check is exactly the "no cross-module access" boundary.
|
||||||
|
/// </summary>
|
||||||
|
internal static class ArchitectureFixture
|
||||||
|
{
|
||||||
|
public static readonly Assembly SharedKernel = typeof(IModule).Assembly;
|
||||||
|
public static readonly Assembly Infrastructure = typeof(MigrationRunner).Assembly;
|
||||||
|
public static readonly Assembly Bootstrap = typeof(ModuleCatalog).Assembly;
|
||||||
|
|
||||||
|
public static readonly Assembly[] ModuleAssemblies =
|
||||||
|
[
|
||||||
|
typeof(IdentityModule).Assembly,
|
||||||
|
typeof(OrgBoardModule).Assembly,
|
||||||
|
typeof(SkillsModule).Assembly,
|
||||||
|
typeof(IntegrationsModule).Assembly,
|
||||||
|
typeof(MemoryModule).Assembly,
|
||||||
|
typeof(AssemblerModule).Assembly,
|
||||||
|
typeof(GovernanceModule).Assembly,
|
||||||
|
];
|
||||||
|
|
||||||
|
public static HashSet<string> ReferencedAssemblyNames(this Assembly assembly) =>
|
||||||
|
assembly.GetReferencedAssemblies()
|
||||||
|
.Select(name => name.Name!)
|
||||||
|
.ToHashSet(StringComparer.Ordinal);
|
||||||
|
}
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
using Xunit;
|
||||||
|
|
||||||
|
namespace TeamUp.ArchitectureTests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Encodes the non-negotiable "no cross-module table access" discipline as build-time rules.
|
||||||
|
/// The <c>internal</c>-per-assembly design is the hard wall (another module's entities/DbContext
|
||||||
|
/// aren't even visible); these reference checks guard the gate the compiler can't: a module
|
||||||
|
/// adding a project reference to another module, or to shared Infrastructure/Bootstrap/hosts.
|
||||||
|
/// </summary>
|
||||||
|
public sealed class ModuleBoundaryTests
|
||||||
|
{
|
||||||
|
[Fact]
|
||||||
|
public void Modules_do_not_reference_each_other()
|
||||||
|
{
|
||||||
|
foreach (var module in ArchitectureFixture.ModuleAssemblies)
|
||||||
|
{
|
||||||
|
var references = module.ReferencedAssemblyNames();
|
||||||
|
|
||||||
|
foreach (var other in ArchitectureFixture.ModuleAssemblies)
|
||||||
|
{
|
||||||
|
if (ReferenceEquals(module, other))
|
||||||
|
{
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
var otherName = other.GetName().Name!;
|
||||||
|
Assert.False(
|
||||||
|
references.Contains(otherName),
|
||||||
|
$"{module.GetName().Name} must not reference module {otherName} — collaborate via abstractions in DI.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void Modules_do_not_reference_infrastructure_bootstrap_or_hosts()
|
||||||
|
{
|
||||||
|
string[] forbidden = ["TeamUp.Infrastructure", "TeamUp.Bootstrap", "TeamUp.Web", "TeamUp.Worker"];
|
||||||
|
|
||||||
|
foreach (var module in ArchitectureFixture.ModuleAssemblies)
|
||||||
|
{
|
||||||
|
var references = module.ReferencedAssemblyNames();
|
||||||
|
|
||||||
|
foreach (var name in forbidden)
|
||||||
|
{
|
||||||
|
Assert.False(
|
||||||
|
references.Contains(name),
|
||||||
|
$"{module.GetName().Name} must not reference {name} — only SharedKernel is allowed.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void Every_module_references_sharedkernel()
|
||||||
|
{
|
||||||
|
// Sanity: each module genuinely sits on the kernel (uses IModule / ModulePing).
|
||||||
|
foreach (var module in ArchitectureFixture.ModuleAssemblies)
|
||||||
|
{
|
||||||
|
Assert.Contains("TeamUp.SharedKernel", module.ReferencedAssemblyNames());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void SharedKernel_references_no_teamup_projects()
|
||||||
|
{
|
||||||
|
var teamUpReferences = ArchitectureFixture.SharedKernel.ReferencedAssemblyNames()
|
||||||
|
.Where(name => name.StartsWith("TeamUp.", StringComparison.Ordinal));
|
||||||
|
|
||||||
|
Assert.Empty(teamUpReferences);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void Infrastructure_references_only_sharedkernel_among_teamup_projects()
|
||||||
|
{
|
||||||
|
var teamUpReferences = ArchitectureFixture.Infrastructure.ReferencedAssemblyNames()
|
||||||
|
.Where(name => name.StartsWith("TeamUp.", StringComparison.Ordinal))
|
||||||
|
.OrderBy(name => name, StringComparer.Ordinal)
|
||||||
|
.ToArray();
|
||||||
|
|
||||||
|
Assert.Equal(["TeamUp.SharedKernel"], teamUpReferences);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
using Microsoft.EntityFrameworkCore;
|
||||||
|
using TeamUp.Bootstrap;
|
||||||
|
using TeamUp.Infrastructure.Persistence;
|
||||||
|
using TeamUp.SharedKernel.Modularity;
|
||||||
|
using Xunit;
|
||||||
|
|
||||||
|
namespace TeamUp.ArchitectureTests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Guards persistence encapsulation and module shape. A module's DbContext/entities are its
|
||||||
|
/// private business — never public — and each module exposes exactly one registration seam.
|
||||||
|
/// </summary>
|
||||||
|
public sealed class PersistenceEncapsulationTests
|
||||||
|
{
|
||||||
|
private static readonly System.Reflection.Assembly[] AllProductionAssemblies =
|
||||||
|
[
|
||||||
|
typeof(IModule).Assembly,
|
||||||
|
typeof(MigrationRunner).Assembly,
|
||||||
|
typeof(ModuleCatalog).Assembly,
|
||||||
|
.. ArchitectureFixture.ModuleAssemblies,
|
||||||
|
];
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void No_DbContext_is_publicly_visible()
|
||||||
|
{
|
||||||
|
var publicContexts = AllProductionAssemblies
|
||||||
|
.SelectMany(assembly => assembly.GetTypes())
|
||||||
|
.Where(type => typeof(DbContext).IsAssignableFrom(type) && type.IsPublic)
|
||||||
|
.Select(type => type.FullName)
|
||||||
|
.ToList();
|
||||||
|
|
||||||
|
Assert.True(
|
||||||
|
publicContexts.Count == 0,
|
||||||
|
$"A DbContext must be internal to its module. Public contexts found: {string.Join(", ", publicContexts)}");
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void Each_module_assembly_exposes_exactly_one_IModule()
|
||||||
|
{
|
||||||
|
foreach (var assembly in ArchitectureFixture.ModuleAssemblies)
|
||||||
|
{
|
||||||
|
var implementations = assembly.GetTypes()
|
||||||
|
.Where(type => typeof(IModule).IsAssignableFrom(type)
|
||||||
|
&& type is { IsInterface: false, IsAbstract: false })
|
||||||
|
.ToList();
|
||||||
|
|
||||||
|
Assert.True(
|
||||||
|
implementations.Count == 1,
|
||||||
|
$"{assembly.GetName().Name} must expose exactly one IModule; found {implementations.Count}.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public void ModuleCatalog_lists_every_module_with_a_unique_name()
|
||||||
|
{
|
||||||
|
var modules = ModuleCatalog.All;
|
||||||
|
|
||||||
|
Assert.Equal(ArchitectureFixture.ModuleAssemblies.Length, modules.Count);
|
||||||
|
|
||||||
|
var names = modules.Select(module => module.Name).ToList();
|
||||||
|
Assert.All(names, name => Assert.False(string.IsNullOrWhiteSpace(name)));
|
||||||
|
Assert.Equal(names.Count, names.Distinct(StringComparer.Ordinal).Count());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- References Bootstrap, which transitively pulls SharedKernel, Infrastructure, and all 7
|
||||||
|
module assemblies into the output — everything ArchUnitNET needs to analyse the boundary.
|
||||||
|
Hosts are intentionally NOT referenced (avoids the duplicate top-level `Program` type);
|
||||||
|
host-direction rules are expressed via namespace targets. -->
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\src\Bootstrap\TeamUp.Bootstrap\TeamUp.Bootstrap.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
using System.Net;
|
||||||
|
using System.Net.Http.Json;
|
||||||
|
using Npgsql;
|
||||||
|
using Xunit;
|
||||||
|
|
||||||
|
namespace TeamUp.IntegrationTests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// End-to-end skeleton proof: the web host boots, the platform migration applies (vector
|
||||||
|
/// extension + the 7 module schemas), health is green, every module endpoint seam is wired, and
|
||||||
|
/// the OpenAPI document is served. All tests share one container (sequential, same collection).
|
||||||
|
/// </summary>
|
||||||
|
[Collection(PostgresCollection.Name)]
|
||||||
|
public sealed class BootAndMigrateTests(PostgresFixture postgres)
|
||||||
|
{
|
||||||
|
private static readonly string[] ExpectedSchemas =
|
||||||
|
["identity", "orgboard", "skills", "integrations", "memory", "assembler", "governance"];
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public async Task Health_endpoint_reports_200()
|
||||||
|
{
|
||||||
|
await using var factory = new TeamUpWebFactory(postgres.ConnectionString);
|
||||||
|
using var client = factory.CreateClient();
|
||||||
|
|
||||||
|
var response = await client.GetAsync("/health");
|
||||||
|
|
||||||
|
Assert.Equal(HttpStatusCode.OK, response.StatusCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public async Task Startup_migration_creates_vector_extension_and_module_schemas()
|
||||||
|
{
|
||||||
|
await using var factory = new TeamUpWebFactory(postgres.ConnectionString);
|
||||||
|
using (factory.CreateClient())
|
||||||
|
{
|
||||||
|
// Creating the client forces the host to start, which applies the migration.
|
||||||
|
}
|
||||||
|
|
||||||
|
await using var connection = new NpgsqlConnection(postgres.ConnectionString);
|
||||||
|
await connection.OpenAsync();
|
||||||
|
|
||||||
|
await using (var extensionCmd =
|
||||||
|
new NpgsqlCommand("SELECT 1 FROM pg_extension WHERE extname = 'vector'", connection))
|
||||||
|
{
|
||||||
|
Assert.NotNull(await extensionCmd.ExecuteScalarAsync());
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach (var schema in ExpectedSchemas)
|
||||||
|
{
|
||||||
|
await using var schemaCmd = new NpgsqlCommand(
|
||||||
|
"SELECT 1 FROM information_schema.schemata WHERE schema_name = @schema", connection);
|
||||||
|
schemaCmd.Parameters.AddWithValue("schema", schema);
|
||||||
|
Assert.NotNull(await schemaCmd.ExecuteScalarAsync());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[Theory]
|
||||||
|
[InlineData("identity")]
|
||||||
|
[InlineData("orgboard")]
|
||||||
|
[InlineData("skills")]
|
||||||
|
[InlineData("integrations")]
|
||||||
|
[InlineData("memory")]
|
||||||
|
[InlineData("assembler")]
|
||||||
|
[InlineData("governance")]
|
||||||
|
public async Task Module_ping_endpoint_responds(string module)
|
||||||
|
{
|
||||||
|
await using var factory = new TeamUpWebFactory(postgres.ConnectionString);
|
||||||
|
using var client = factory.CreateClient();
|
||||||
|
|
||||||
|
var response = await client.GetAsync($"/api/{module}/ping");
|
||||||
|
|
||||||
|
Assert.Equal(HttpStatusCode.OK, response.StatusCode);
|
||||||
|
|
||||||
|
var payload = await response.Content.ReadFromJsonAsync<ModulePingResponse>();
|
||||||
|
Assert.NotNull(payload);
|
||||||
|
Assert.Equal(module, payload!.Module);
|
||||||
|
}
|
||||||
|
|
||||||
|
[Fact]
|
||||||
|
public async Task OpenApi_document_is_served()
|
||||||
|
{
|
||||||
|
await using var factory = new TeamUpWebFactory(postgres.ConnectionString);
|
||||||
|
using var client = factory.CreateClient();
|
||||||
|
|
||||||
|
var response = await client.GetAsync("/openapi/v1.json");
|
||||||
|
|
||||||
|
Assert.Equal(HttpStatusCode.OK, response.StatusCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
private sealed record ModulePingResponse(string Module, string Status);
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
using Testcontainers.PostgreSql;
|
||||||
|
using Xunit;
|
||||||
|
|
||||||
|
namespace TeamUp.IntegrationTests;
|
||||||
|
|
||||||
|
/// <summary>A throwaway Postgres 17 + pgvector container, shared across the integration tests.</summary>
|
||||||
|
public sealed class PostgresFixture : IAsyncLifetime
|
||||||
|
{
|
||||||
|
private readonly PostgreSqlContainer _container = new PostgreSqlBuilder()
|
||||||
|
.WithImage("pgvector/pgvector:pg17")
|
||||||
|
.WithDatabase("teamup")
|
||||||
|
.WithUsername("teamup")
|
||||||
|
.WithPassword("teamup")
|
||||||
|
.Build();
|
||||||
|
|
||||||
|
public string ConnectionString => _container.GetConnectionString();
|
||||||
|
|
||||||
|
public async ValueTask InitializeAsync() => await _container.StartAsync();
|
||||||
|
|
||||||
|
public async ValueTask DisposeAsync() => await _container.DisposeAsync();
|
||||||
|
}
|
||||||
|
|
||||||
|
[CollectionDefinition(Name)]
|
||||||
|
public sealed class PostgresCollection : ICollectionFixture<PostgresFixture>
|
||||||
|
{
|
||||||
|
public const string Name = "postgres";
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<!-- Boots the real web host (WebApplicationFactory) against a throwaway pgvector container
|
||||||
|
(Testcontainers). References ONLY the web host — not the worker — so there is a single,
|
||||||
|
unambiguous top-level `Program` to drive. Needs a running Docker daemon. -->
|
||||||
|
<PropertyGroup>
|
||||||
|
<!-- Testcontainers 4.12 deprecated the parameterless PostgreSqlBuilder() ctor in favour of an
|
||||||
|
image-parameter ctor; the documented .WithImage(...) fluent path still works. -->
|
||||||
|
<NoWarn>$(NoWarn);CS0618</NoWarn>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" />
|
||||||
|
<PackageReference Include="Testcontainers.PostgreSql" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<ProjectReference Include="..\..\src\Hosts\TeamUp.Web\TeamUp.Web.csproj" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
|
</Project>
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
using Microsoft.AspNetCore.Hosting;
|
||||||
|
using Microsoft.AspNetCore.Mvc.Testing;
|
||||||
|
|
||||||
|
namespace TeamUp.IntegrationTests;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Drives the real <see cref="Program"/> web host against the test container, in Development so
|
||||||
|
/// migrations apply on startup and the OpenAPI document is mapped.
|
||||||
|
/// </summary>
|
||||||
|
public sealed class TeamUpWebFactory(string connectionString) : WebApplicationFactory<Program>
|
||||||
|
{
|
||||||
|
protected override void ConfigureWebHost(IWebHostBuilder builder)
|
||||||
|
{
|
||||||
|
builder.UseEnvironment("Development");
|
||||||
|
builder.UseSetting("ConnectionStrings:Postgres", connectionString);
|
||||||
|
builder.UseSetting("Database:ApplyMigrationsOnStartup", "true");
|
||||||
|
builder.UseSetting("OpenTelemetry:OtlpEndpoint", string.Empty);
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user