✨feature: Initial commit

Notes/Initial Prompt.md

@@ -0,0 +1,17 @@
+I want to build a PBBG (persistent browser-based game) similar to torn.com but set in a world similar to Shadowrun (so, cyberpunk meets magic).  The base city will be New Orleans.  The overall atmosphere should be dark, cyberpunk, tech everywhere, but with that News Orleans flair (Locations, landmarks, etc).  Basic info about New Orleans as a SR setting can be found here: [New Orleans - Shadowrun Wiki](https://shadowrun.fandom.com/wiki/New_Orleans).
+
+High-level wants:
+
+- Players can choose race from the core Shadowrun races (Human, Elves, Dwarves, Orks, Trolls, etc), each with pros and cons.
+  - MVP: Only Human, but build system to be easily extensible.
+- Players can choose class from the core Shadowrun classes (Deckers, Street samurai, Riggers, Mages, Shamans, Physical adepts).
+  - MVP: Only Street sam, Mage, Shaman.
+- "Mr. Johnson" system for taking jobs, with the jobs randomly created from a set of attributes (type of job, class requirements, difficulty rating, etc).
+- Hireling system, for adding a class you don't have for a job, for a cut of the payout.
+- Training system, different tasks for different classes to boost skill levels.
+- Banking system to protect money and offer investment opportunities.
+  - MVP: Only deposits/withdrawals.
+- Market system for purchasing weapons, cyberware, gear, etc from vendors and other players.
+  - MVP: Only vendors.
+
+I would like to use php and javascript for the dev stack, with Tailwind version 4 for styliing.  Database should be postgres.  Let's put together a high-level overview of the project, with a rough outline of the development steps leading to the MVP stage.

Notes/MVP Outline.md

@@ -0,0 +1,68 @@
+# Development steps to MVP (rough outline)
+
+## Phase 0 — Pre-production (1–3 days)
+
+- Define the 3 MVP classes: what skills matter, what gear matters
+- Define initial city districts/landmarks (pure flavor in MVP, but helps UI):
+  - French Quarter, CBD, Garden District, Bywater, Ninth Ward, “The Sprawl”
+- Decide the pacing levers:
+  - energy regen rate, job cooldown, training duration, job generation cadence
+
+## Phase 1 — Foundations (auth, layout, DB)
+
+- Bootstrap project (Laravel + Postgres + Tailwind v4 build)
+- Auth + basic account pages
+- Global layout + navigation + dark cyberpunk base styling
+- Seed tables: races, classes, skills
+
+**Deliverable:** register/login, create character, view character sheet.
+
+## Phase 2 — Core progression scaffolding
+
+- Energy system (regen, caps, spend/restore rules)
+- Skill system (levels/xp, modifiers via class/race)
+- Add initial items + vendors (even a tiny catalog)
+
+**Deliverable:** character can gain skills and buy items (even if items are “flat bonuses” initially.
+
+## Phase 3 — Mr. Johnson job system (the heart)
+
+- Job templates + job generator (daily refresh + per-player list)
+- Job acceptance + resolution (success chance formula)
+- Job outcomes: payout + xp + small chance of injury/penalty (optional MVP spice)
+
+**Deliverable:** playable loop: jobs → rewards → progression.
+
+## Phase 4 — Training
+
+- Training actions per class
+- Timed sessions (start now, finish later)
+- Resolution on completion (xp gain, maybe small failure chance)
+
+**Deliverable:** long-form progression path besides jobs.
+
+## Phase 5 — Hirelings (gap-filler)
+
+- Hireling catalog + purchase
+- Add hirelings to job run (affects success chance / unlocks tag requirements)
+- Profit cut applied on success
+
+**Deliverable:** jobs can require tags that the player can satisfy via hirelings.
+
+## Phase 6 — Banking + economy sanity
+
+- Deposit/withdraw UI + endpoints
+- Basic economic balance pass:
+  - job payouts vs vendor pricing
+  - early-game progression speed
+
+**Deliverable:** cash loop + safe storage.
+
+## Phase 7 — MVP hardening
+
+- Anti-cheat basics (server-side validation everywhere)
+- Rate limiting for actions
+- Logging + audit trail for money changes and job results
+- Basic admin screens for job templates/items/vendors
+
+**Deliverable:** MVP that won’t fall over the moment someone gets curious.

Notes/MVP Phases/Phase 0 - Pre-production.md

@@ -0,0 +1,67 @@
+# Phase 0 — Pre-production
+
+- Basic attributes for all classes:
+  - Physical Attributes
+    - Body (BOD):       Measures physical health and resilience
+    - Agility (AGI):    Measures hand eye coordination, flexibility, nimbleness, and balance
+    - Reaction (REA):   Measures reflexes, awareness and response time
+    - Strength (STR):   Measures how strong you are
+  - Mental Attributes
+    - Willpower (WIL):  Measures resistances and weariness from spellcasting.
+    - Logic (LOG):      Measures rational thought
+    - Intuition (INT):  Measures Instinct
+    - Charisma (CHA):   Measures force of personality, persuasiveness and charm
+  - Special Attributes
+    - Edge (EDG):       Measures luck and provides temporary boosts
+    - Essence (ESS):    Measures just how Metahuman you still are
+    - Magic (MAG):      Measures a Mage or Adept's ability to cast and weave spells
+    - Resonance (RES):  Measures a Technomancer's ability to interface with the Matrix
+    - Initiative (INI): Measures quickness in combat, based on REA and INT, modified by Edge, cyberware and gear.
+
+- Define the 3 MVP classes: what skills matter, what gear matters
+  1. Street samurai
+     - Focus on armed combat, heavy armor, and physical strength. Tank role.
+     - Skills: Combat master, explosives, tactics
+     - Gear: Swords, pistols, body armor
+     - Attributes: High BOD, AGI, STR
+  2. Mages
+     - Focus on spellcasting, magical knowledge, and mana management. DPS role.
+     - Skills: Spellcasting, assensing (seeing auras), summoning elementals
+     - Gear: Swords, pistols, light armor
+     - Attributes: High MAG, WIL, INT
+  3. Shamans
+     - Focus on spiritual guidance, nature magic, and healing. Support role.
+     - Skills: Healing, nature magic, spirit communication
+     - Gear: Totems, herbs, ritualistic clothing
+     - Attributes: High WIL, CHA, INT
+
+- Define initial city districts/landmarks (pure flavor in MVP, but helps UI):
+  1. French Quarter
+     - Primary hub for social interactions, markets, and quests.
+     - Landmarks: Jackson Square, St. Louis Cathedral, Bourbon Street, Tipatina's
+  2. CBD
+     - Business district with corporate offices, high-rise buildings, and upscale shops.
+     - Landmarks: Hancock Whitney Center, Place St. Charles, Canal Street
+  3. Warehouse District
+     - Industrial area with docks, warehouses, and shady dealings.
+     - Landmarks: Mardi Gras World, Fulton Street
+
+- Decide the pacing levers:
+  1. Energy
+     - Base energy: 100 points (modifialble by perks, items, etc, but locked to 100 for MVP)
+     - Regen rate: 5 points per 5 minutes (fully regenerates in ~2 hours)
+  2. Training duration
+     - Short training: 15 minutes, +1 skill XP
+     - Medium training: 1 hour, +3 skill XP
+     - Long training: 4 hours, +10 skill XP
+  3. Job generation cadence
+     - New jobs generated every 30 minutes
+     - Maximum of 3 active jobs at a time
+     - Chance for a blind Johnson contact to appear at login or once every 24 realtime hours upon refresh (10% chance, based on clock time)
+        - Offers a random high-risk, high-reward job outside normal rotation, 48 hour cooldown on failure
+  4. Job cooldown
+     - Job difficulty tiers:
+        - Easy: 5-minute cooldown
+        - Medium: 15-minute cooldown
+        - Hard: 30-minute cooldown
+     - Failure penalty: 15-minute additional cooldown on failed jobs at medium and hard tiers

Notes/New Orleans in the Shadows Story Bible.md

@@ -0,0 +1,20 @@
+# New Orleans in the Shadows
+
+## Table of Contents
+
+- [Setting Overview](#setting-overview)
+- [Initial Prompt](Initial%20Prompt.md)
+- [MVP Outline](MVP%20Outline.md)
+- **MVP Phases**
+  - [Phase 0 — Pre-production](MVP%20Phases/Phase%20-%20Pre-production.md)
+  - [Phase 1 — Foundations (auth, layout, DB)](MVP%20Phases/Phase%20-%20Foundations%20(auth,%20layout,%20DB).md)
+  - [Phase 2 — Core progression scaffolding](MVP%20Phases/Phase%20-%20Core%20progression%20scaffolding.md)
+  - [Phase 3 — Mr. Johnson job system (the heart)](MVP%20Phases/Phase%20-%20Mr.%20Johnson%20job%20system%20(the%20heart).md)
+  - [Phase 4 — Training](MVP%20Phases/Phase%20-%20Training.md)
+  - [Phase 5 — Hirelings (gap-filler)](MVP%20Phases/Phase%20-%20Hirelings%20(gap-filler).md)
+  - [Phase 6 — Banking + economy sanity](MVP%20Phases/Phase%20-%20Banking%20+%20%20economy%20sanity.md)
+  - [Phase 7 — MVP hardening](MVP%20Phases/Phase%20-%20MVP%20hardening.md)
+
+## Setting Overview
+
+"New Orleans in the Shadows" is a cyberpunk RPG set in a dystopian future version of New Orleans, where magic and technology coexist. Players take on the roles of shadowrunners — mercenaries who undertake dangerous jobs for various clients, often involving corporate espionage, smuggling, and combat against both human and supernatural threats.