🌞 MADFAM: The Solarpunk Foundry

From Bits to Atoms. High Tech, Deep Roots.

• Version: 0.1.0 (The Blueprint)
• The Mission: To construct the operating system for a sustainable, sovereign future.
• The Scope: Manufacturing, Finance, Education, & Science.
• The Status: 🟢 Active Execution

---

📖 About This Document

This is the Single Source of Truth for Innovaciones MADFAM SAS de CV. It defines our ecosystem, our strategy, and our philosophy.

• For the Team: This is the order of operations.
• For the Investor: This is how we capture value across the entire lifecycle of a product and a business.
• For the World: This is our roadmap to a future that makes its own things and owns its own truth.

---

🌍 I. The Vision

"Sovereignty is not just about owning your server; it's about owning your supply chain, your money, and your mind."

We are a Vertically Integrated Venture Studio bridging the gap between the Digital (Software) and the Physical (Real World).

The Problem: The "Rented" Existence

Today, a founder is a tenant in their own business. They rent their design tools, their infrastructure, their audience, and their financial insights. A change in API pricing or a platform ban can kill a business overnight.

The MADFAM Solution: The Sovereign Loop

We are building the Solarpunk Foundry. A closed-loop ecosystem where the tools support each other to create resilience.

---

⚙️ II. The Architecture: The "Solarpunk Stack"

Our ecosystem grows as a living system, not a machine. Every tool has a specific organ function, cultivated in symbiotic relationship with the others.

📐 For the detailed architecture of our core platform (Substrate, Trellis, Membrane), see SYMBIOSIS.md

🪨 Layer 1: The Soil (Infrastructure)

The bedrock. Without this, we are tenants.

• 🛡️ Enclii: Our Sovereign PaaS. Bare-metal hosting. Maximum independence, minimum cost.
• 🔑 Janua: The Gatekeeper. Identity, SSO, and Revenue Management. One key for the whole city.

🌿 Layer 2: The Roots (Sensing & Input)

Absorbing nutrients (data and truth) from the outside world.

• 🔮 Fortuna: The Problem Hunter. Scrapes multilingual signals to find market gaps (Problem Intelligence).
• 📡 ForgeSight: The Pricer. Scrapes global material and machine data for real-time manufacturing costs.
• 📚 BlueprintTube: The Librarian. Indexes and rates 3D models for printability.
• 🧘 BloomScroll: The Filter. A "Slow Web" content aggregator. 20 items/day. Serendipity over engagement.

🪵 Layer 3: The Stem (Core Standards & Verification)

The structural logic that holds the system up.

• 📐 geom-core: The Physics Standard. C++ geometry analysis library (WASM/Python).
• 🎓 AVALA: The Human Standard. Verification engine for applied learning (Mexico EC/CONOCER). Issues Open Badges and DC-3 forms.

🍎 Layer 4: The Fruit (User Platforms)

The applications where value is created and captured.

• 🎨 Sim4D: The Creator. Web-based CAD guided by geom-core.
• 🛍️ Forj: The Bazaar. Decentralized fabrication storefronts with NFT integration.
• 🏷️ Cotiza Studio: The Merchant. Automated quoting engine connecting design to factory.
• 💰 Dhanam: The Treasury. Unified budgeting and wealth tracking (Personal + Business) with ESG insights.
• 👂 Coforma Studio: The Ear. Customer Advisory Board and feedback management.
• ⚡ Galvana: The Reactor. Phygital Electrochemistry Platform for scientific simulation.

---

🔄 III. The "Primavera Mandate" (Dogfooding)

"We trust it because we survive on it."

We do not build "SaaS"; we build tools to run our own operations first.

1. Finance: MADFAM runs on Dhanam.
2. Strategy: We build what Fortuna validates.
3. Factory: Primavera3D quotes via Cotiza.
4. Hiring: Staff is certified via AVALA.

---

🏰 IV. Governance: The Repo Strategy

Core Packages (Published to npm)

Package	Purpose	License	Location
@madfam/core	Authoritative organizational constants (brand, locales, currencies, events, legal, products)	MIT	solarpunk-foundry/packages/core

Note: @madfam/core contains organizational decisions, not implementations. Apps import it for brand consistency, supported locales/currencies, and analytics event taxonomy. See packages/core/README.md for usage.

Repositories

Solution	Domain	GitHub Org	Website	Repository	License	Strategic Purpose
Enclii	Infra	madfam-org	enclii.dev	enclii	AGPL v3	Prevents cloud capture.
Janua	Auth	madfam-org	janua.dev	janua	AGPL v3	Identity Trust.
Dhanam	Finance	madfam-org	dhan.am	dhanam	AGPL v3	Trust in financial code. Open Core protects connectors.
BloomScroll	Media	madfam-org	TBD	bloom-scroll	MPL 2.0	Ethos & Community building.
AVALA	EdTech	madfam-org	TBD	avala	AGPL v3	Transparent verification.
geom-core	Science	madfam-org	TBD	geom-core	Apache 2.0	The geometry standard.
Galvana	Science	madfam-org	TBD	electrochem-sim	MPL 2.0	Open Science collaboration.
Sim4D (Community)	Making	madfam-org	sim4d.io	sim4d	MPL 2.0	The tool (without the market).
Fortuna	Intel	aureo-labs	fortuna.tube	fortuna	Proprietary	The "Edge" (Market Gaps).
ForgeSight	Intel	aureo-labs	forgesight.quest	forgesight	Proprietary	The Cost Database.
BlueprintTube	Intel	aureo-labs	blueprint.tube	blueprint-harvester	Proprietary	The Model Index.
Forj	Commerce	aureo-labs	forj.design	forj	Proprietary	The Revenue Engine.
Cotiza Studio	Making	aureo-labs	cotiza.studio	digifab-quoting	Proprietary	The Pricing Logic.
Coforma Studio	Ops	aureo-labs	coforma.studio	coforma-studio	Proprietary	The Customer Data.

Business & Corporate Websites

Solution	Domain	GitHub Org	Website	Repository	License	Strategic Purpose
MADFAM Site	Corp	madfam-org	madfam.io	madfam-site	Proprietary	Corporate presence & brand.
Aureo Labs	Corp	madfam-org	aureolabs.dev	aureo-labs	Proprietary	Product showcase & demos.
Primavera3D	Corp	madfam-org	primavera3d.com	primavera3d	Proprietary	Factory portfolio & services.

---

🗺️ V. The Roadmap (Bootstrap Sequence)

We strictly follow this order. We do not build the roof before the walls.

🏗️ Phase 1: The Foundation (Survival Mode)

• Goal: Sovereign Hosting, Financial Clarity, and Identity.
• 1. Enclii: Deploy bare-metal infrastructure.
• 2. Janua: Establish Single Sign-On (SSO).
• 3. Dhanam: Deploy internally to manage MADFAM's burn rate and runway.
• 4. Coforma Studio: Deploy to start capturing early user interest/waitlists.

🧠 Phase 2: The Intelligence (Data Harvesting)

• Goal: Gathering the raw materials (Data) to make the tools smart.
• 5. Fortuna: Begin scraping signals to validate market needs.
• 6. ForgeSight: Begin scraping material costs to feed the future Cotiza engine.
• 7. BlueprintTube: Begin indexing 3D models to feed the future Sim4D engine.
• 8. BloomScroll: Launch publicly to build a "Slow Web" audience/community.

📐 Phase 3: The Engines (Core Logic)

• Goal: Converting Data into Logic.
• 9. geom-core: Publish the math library.
• 10. AVALA: Codify our internal hiring standards into the platform.
• 11. Sim4D (Alpha): Release the editor (powered by geom-core) for internal testing.

🏭 Phase 4: The Application (Commerce)

• Goal: Monetization and Physical Production.
• 12. Cotiza Studio: Connect ForgeSight data + geom-core logic to price parts.
• 13. Forj: Launch the storefront builder for external creators.
• Sim4D (Beta): Connect to Cotiza for real-time pricing.

🔬 Phase 5: The Frontier (Deep Tech)

• Goal: Scientific Expansion.
• 14. Galvana: Begin development of the electrochemical simulation engine once the revenue from Phase 4 stabilizes the studio.

---

🤝 Join the Mission

MADFAM is proof that high tech can have deep roots.

• Build with us: github.com/madfam-org
• Partner with us: madfam.io/en/solutions/colabs

"The best way to predict the future is to manufacture it."

---

🛠️ VI. Operations & Development

Quick Start (Local Development)

# From labspace root
cd ~/labspace

# Start core ecosystem (infrastructure + auth + revenue apps + site)
./madfam start

# Start FULL ecosystem (includes portfolio, platform, utilities)
./madfam full

# Check status
./madfam status

# View logs
./madfam logs janua
./madfam logs forgesight

# Stop everything
./madfam stop

# Stop and clean volumes
./madfam stop --clean

Documentation

• Symbiosis Architecture: solarpunk-foundry/docs/architecture/SYMBIOSIS.md — Core platform relationships (Substrate, Trellis, Membrane)
• Port Allocation: solarpunk-foundry/docs/PORT_ALLOCATION.md
• Dogfooding Guide: solarpunk-foundry/docs/DOGFOODING_GUIDE.md
• Debugging Notes: solarpunk-foundry/docs/DELIVERABLES.md

Shared Infrastructure

All services connect to shared PostgreSQL, Redis, and MinIO via madfam-shared-network:

• PostgreSQL: localhost:5432
• Redis: localhost:6379
• MinIO: localhost:9000 (API) / localhost:9001 (Console)

Service URLs (Local Development)

Service	URL	Port Block
MADFAM Site	http://localhost:3000	Legacy
Janua Auth	http://localhost:4100	4100-4199
Enclii PaaS	http://localhost:4200	4200-4299
ForgeSight	http://localhost:4300	4300-4399
Dhanam	http://localhost:4700	4700-4799
Sim4D Studio	http://localhost:4800	4800-4899