plexus/docs/structure.md

📂 Project Structure

Plexus is organized into three main areas: the client, the server, and the internal tooling.

📁 Root Directory

• Makefile: Central automation script for installation, development, and tasks.
• docker-compose.yml: Defines the development environment services.
• Dockerfile.dev: Unified development shell with all dependencies.
• package.json: Root package for devtooling (Husky, lint-staged).
• pyproject.toml: Configuration for Python linting (Ruff).

📁 client/ (Frontend)

Built with Vue 3 and Vite.

• src/components/: Reusable UI components (Chat, Profile, UserList, etc.).
• src/stores/: Pinia stores for state management (chat.js).
• src/style.css: Global styles and Tailwind utilities.
• tailwind.config.js: Custom theme and animations.

📁 server/ (Backend)

Built with Node.js and Socket.io.

• index.js: Main entry point, socket event handlers.
• db.js: Database initialization and schema management.
• data/: Contains the DuckDB database file (chat.duckdb).
• tests/: Integration tests for socket events.

📁 tasks/ (Internal Tooling)

Python-based task tracker.

• cli.py: Command-line interface for managing tasks.
• db.py: DuckDB backend for task storage.
• tasks.duckdb: Database for internal tasks.

📁 docs/ (Documentation)

Linked Markdown files covering all aspects of the project.