Administration Management Plan System (AMPS)

A full-stack calendar application with event management, roles-based notes, and an admin panel.

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• npm (comes with Node.js)

Installation

# 1. Clone/copy the project
cd /path/to/administration-management-plan-system

# 2. Install frontend dependencies
npm install

# 3. Install server dependencies
cd server && npm install && cd ..

Running the App

Option A: Run both in separate terminals

# Terminal 1 - Start the backend server
cd server && node index.js
# Server runs at http://localhost:3001

# Terminal 2 - Start the frontend
npm run dev
# Frontend runs at http://localhost:5173

Option B: Quick start script (run from project root)

# Start server in background, then frontend
cd server && node index.js & cd .. && npm run dev

---

🔄 Patch Production Copy (keep DB/uploads)

• Default production path is /Users/digogonz/Desktop/Calendario/cal-ap.
• One-shot deploy: run bash scripts/deploy_to_prod.sh from the dev root. It syncs code, installs deps in the prod copy (frontend + server), and leaves DB/uploads untouched.
• Dry run: DRY_RUN=1 bash scripts/deploy_to_prod.sh (only previews rsync).
• Skip installs: SKIP_INSTALL=1 bash scripts/deploy_to_prod.sh (sync only).
• Override prod path: PROD_DIR=/custom/path bash scripts/deploy_to_prod.sh.
• Under the hood it uses scripts/patch_to_prod.sh, which protects server/calendar.db*, server/uploads/, and root uploads/; stale code is cleaned with --delete.
• After a deploy, restart the production services if they are running.

---

🔗 URLs

Service	URL	Description
Frontend	http://localhost:5173	Main calendar app
Admin Panel	http://localhost:3001	Database administration

---

🔧 Fresh Start (Clean Database)

To start with a completely fresh database:

# Remove database files
rm -f server/calendar.db server/calendar.db-shm server/calendar.db-wal

# Optional: Clear uploaded files
rm -rf server/uploads/*

# Restart the server (creates fresh DB)
cd server && node index.js

---

👤 First Admin User

When starting fresh, create an admin user:

1. Register a new user via the frontend at http://localhost:5173
2. Access the admin panel at http://localhost:3001
3. The first user can be promoted to admin by editing the database

Or use the seeded admin account (if available):

• Username: admin
• Password: admin123

---

📁 Project Structure

administration-management-plan-system/
├── src/                    # Frontend React code
│   ├── components/         # UI components
│   ├── store/              # Zustand state management
│   └── utils/              # Utility functions
├── server/                 # Backend Node.js server
│   ├── index.js            # Main server file
│   ├── static_admin/       # Admin panel HTML
│   ├── uploads/            # Uploaded files
│   └── calendar.db         # SQLite database
├── package.json            # Frontend dependencies
└── README.md               # This file

---

🛠️ Tech Stack

• Frontend: React, Vite, Zustand, TailwindCSS
• Backend: Node.js (LTS), Express, SQLite (better-sqlite3)
• Auth: JWT (JSON Web Tokens)

---

📝 Features

• ✅ Calendar with event management
• ✅ Role-based notes system
• ✅ User authentication (login/register)
• ✅ Admin panel with full CRUD
• ✅ File uploads in notes
• ✅ Markdown support in notes
• ✅ Multi-user support
• ✅ Friend calendar sharing