Multi-tenant community collaboration platform for Coding Girls Club — workspaces, roles & RBAC, join governance (applications / invitations), and a workflow engine for enrollment, sponsorship, speaker invitations, and teaching research.
The website is a business hub + MCP server; users bring their own OpenClacky as the agent executor (BYO). The platform runs no LLM inference — it owns business state, authorization, and audit; all AI execution happens in the user's local OpenClacky via MCP. Business orchestration is deterministic, driven by a Jido workflow engine (workflow-first).
| Layer | Stack |
|---|---|
| Backend | Elixir 1.20 / Phoenix / Ash Framework (AshGraphql, AshPolicy, ash_authentication) / PostgreSQL 16+ |
| Frontend | Next.js 16 / React 19 / TypeScript / Apollo Client 4 / Tailwind CSS v4 / Vitest |
| Workflow | Jido ecosystem (jido, jido_runic, ash_jido) |
cd backend
mix deps.get
mix ecto.create && mix ecto.migrate
mix phx.serverGates (also enforced in CI):
mix compile --warnings-as-errors
mix format --check-formatted
mix cgc2046.gen_rbac_contract --check
mix testcd web
pnpm install
pnpm devGates (also enforced in CI):
pnpm typecheck
pnpm lint
pnpm test
pnpm build- CONTEXT.md — single source of truth for domain terminology (all code, docs, issues, and tests must use exactly these terms)
- DESIGN.md — design overview
- docs/00-CGC平台设计总纲.md — single source of truth for core design decisions
- docs/01-定稿设计/ — finalized design: domain model, business workflows, user journeys
- docs/adr/ — Architecture Decision Records
We develop in vertical slices (e.g. slice A: auth/workspace/RBAC; slice B: join governance), each driven by a set of GitHub issues. See CONTRIBUTING.md for how to contribute.
AGPL-3.0 — see LICENSE. Contributions are accepted under the same terms.