Skip to content

MFave-xtc/sdos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Digital Bridge Solutions PNG

Autonomous Service Delivery OS (SDOS) v1.0

IPA Registration: #6-148258082
Registered: 16 April 2026 · Expires 30 April 2027
Registrar: David A. KIL — Registrar of Companies, Papua New Guinea
Owner: Mariosu Stephen Fave
Address: Section 126, Lot 37, Kanage St, 6 Mile, Air Niugini Estate, Port Moresby, NCD 1121
Postal: PO Box 2111, Downtown, Port Moresby, NCD 1121
Contact: md.aibspng@gmail.com · +675 7197 8592
Verify: https://www.ipa.gov.pg/Corp/Verify.aspx?entityNumber=6-148258082


What This Is

A complete 8-layer autonomous service delivery platform that:

  1. Intakes client requests through dynamic, service-specific forms
  2. Validates inputs against machine-readable service rules
  3. Orchestrates workflow — tasks, deadlines, reminders, triggers
  4. Generates AI proof-of-concept scope summaries (Anthropic Claude)
  5. Sends automated quotes to clients via email
  6. Prepares project folders, briefs, checklists, and documents
  7. Monitors execution and SLA compliance
  8. Notifies the owner ONLY when a case is fully ready for final production

All governed by Genesis Blueprint v4.9 — Sovereign Mandate Edition.


Tech Stack (100% Open Source)

Layer Technology Purpose
Frontend React 18 + Vite + TypeScript Client portal, owner workbench, service catalogue
Database PostgreSQL via Supabase 16 tables, RLS, triggers, audit logs
Auth Supabase Auth (GoTrue) Client + owner accounts, JWT sessions
API PostgREST (auto-generated) REST API from schema
Realtime Supabase Realtime Live request status updates
Edge Functions Deno (Supabase Edge Runtime) Pricing engine, workflow trigger, AI scope, email
File Storage MinIO (S3-compatible) Client document uploads
Queue Redis + BullMQ Async job processing
Email Resend API Transactional email (3,000/month free)
AI Anthropic Claude Sonnet Genesis Orchestrator, scope summarizer
Deployment Docker Compose + Coolify Local dev + production VPS

Zero vendor lock-in. Fully self-hostable. GoPNG sovereign-ready.


Legal Documents

The following documents govern all client engagements and are presented to clients during platform onboarding (Genesis Phase Zero Gate):

Document Reference Purpose
IP Notice & Ownership Declaration IP-AIBS-2026-001 Declares AIBS ownership of all IP
Non-Disclosure Agreement NDA-AIBS-2026 Mutual confidentiality — client onboarding
Master Digital Service Catalogue CATALOGUE-2026 140+ services across 14 categories

All documents are governed by the laws of the Independent State of Papua New Guinea.


Platform Architecture

8 Autonomous Layers

Layer Name Function
1 Client Intake Captures identity, service, scope, files, dates
2 Decision Engine Validates inputs, calculates price, defines scope
3 Workflow Orchestration Creates tasks, deadlines, reminders, triggers
4 Proof-of-Concept Shows scope, deliverables, cost, missing items
5 Quote & Commercial Auto-sends quote, scope, assumptions, timeframe
6 Delivery Preparation Creates folders, checklists, draft outputs
7 Execution Monitor Tracks complete, waiting, late, escalation
8 Owner Notification Emails owner ONLY when fully production-ready

Service Classes

Class Description
A — Fully Automatable Fixed inputs, formula pricing, template outputs
B — Semi-Autonomous Structured intake + AI drafting, human review before release
C — Expert-Controlled High-risk, expert judgment mandatory

Database Schema (16 Tables)

organisations · clients · service_categories · services · service_rules · requests · request_inputs · uploads · quotes · workflow_states · tasks · generated_documents · notifications · calendar_events · audit_logs · exception_cases


Edge Functions

Function Layer Purpose
pricing-engine 2 Formula-based quote calculation with urgency/complexity multipliers
workflow-trigger 3 Orchestrates all 8 layers on submit and approve events
ai-scope 4 Anthropic Claude scope summarization from client inputs
email-dispatch 5,6,8 Transactional emails via Resend API

Quick Start

Prerequisites

  • Docker Desktop (with WSL 2 on Windows)
  • Node.js 18+
  • Git

1. Clone

git clone https://github.com/MFave-xtc/sdos.git
cd sdos

2. Configure environment

cp .env.example .env
# Edit .env — add ANTHROPIC_API_KEY and RESEND_API_KEY
# Set VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY

3. Run database migrations

In Supabase SQL Editor run:

  • supabase/migrations/001_initial_schema.sql
  • supabase/migrations/002_service_catalogue_seed.sql

4. Start backend

docker compose up -d

5. Start frontend

cd frontend
cp ../.env .env
npm install
npm run dev

6. Open platform

http://localhost:3000

Windows Deployment Notes (Git Bash)

  1. Use Git Bash to run scripts (not PowerShell)
  2. Copy .env to frontend/.env before running npm run dev
  3. If minio/mc fails: change to image: minio/mc:latest in docker-compose.yml
  4. Use npm run dev for local development (bypasses strict TypeScript build)
  5. Clear localStorage in browser console if auth session conflicts occur

GoPNG Alignment

AIBS Service GoPNG Policy
S-5.09 ISO Documentation Suite ICT Procurement Standards 2025 — ISO 9001/27001 required
S-8.01 M365 Health Check DICT Digital Standards — Azure approved cloud
S-9.01 Governance-as-a-Service Digital Government Act 2022 — CoC mandate
S-8.04 Cybersecurity Risk Assessment NCSC connection — CoC prerequisite
S-2.08 Compliance Reporting Dashboard DICT quarterly compliance mandate

DICT Circular 05/2025: All prior CoCs revoked. Migration deadline: 28 November 2026. Non-compliance: K1,000,000 fine.


Production Deployment

Hetzner VPS (recommended — ~USD $6/month)

bash scripts/deploy.sh direct

Coolify (self-hosted PaaS)

bash scripts/deploy.sh coolify

Security Notes

After initial setup, rotate these keys:

  • Anthropic API key: console.anthropic.com
  • Resend API key: resend.com
  • Supabase service_role key: project Settings → API Keys

Never commit .env to git — it is in .gitignore.


Adding the Remaining 130 Services

The MVP includes 10 services. To add more:

  1. Insert into services table
  2. Insert rules into service_rules table
  3. Intake forms render dynamically from rules — no code changes needed

Genesis Blueprint v4.9 — Sovereign Mandate Edition

All deliverables are governed by Genesis Blueprint v4.9. Every request undergoes:

  • Phase Zero mandatory intake
  • Nine Characteristics Scan
  • Fruits of the Spirit Standard (nine karpos expressions)
  • Adversarial Durability Test
  • DRIP Matrix at P1
  • Expert Research & Source Validation Protocol
  • SRC Source Ledger

Changelog

v1.0 — 17 April 2026

  • Initial release
  • 8-layer autonomous architecture deployed
  • 10 MVP services seeded with full rule definitions
  • Supabase Cloud integration
  • IP Notice + NDA onboarding gate (Genesis Phase Zero)
  • Fully responsive design (mobile, tablet, desktop)
  • Real-time request status via Supabase Realtime
  • Owner Workbench with live Genesis Orchestrator AI
  • Legal name corrected: AI Digital Bridge Solutions PNG
  • IPA number corrected: #6-148258082
  • Windows 11 deployment verified on CCLEN04 (Intel i5 210H, 16GB RAM)

AI Digital Bridge Solutions PNG · Powering Papua New Guinea's Digital Future

About

AI Digital Bridge Solutions PNG — Autonomous Service Delivery OS — Genesis Blueprint v4.9 — IPA #6-148258082

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors